इस गाइड में, Google Chat API के Space
संसाधन पर get()
तरीके का इस्तेमाल करने का तरीका बताया गया है. इससे, किसी स्पेस के बारे में जानकारी देखी जा सकती है. जैसे, उसका डिसप्ले नेम, ब्यौरा, और दिशा-निर्देश.
अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन के किसी भी स्पेस के बारे में जानकारी पाने के लिए, get()
का इस्तेमाल करें.
Space
संसाधन, एक ऐसी जगह को दिखाता है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
- ग्रुप चैट में तीन या उससे ज़्यादा लोग शामिल होते हैं. साथ ही, ये चैट चैट ऐप्लिकेशन पर की जाती हैं.
- नाम वाले स्पेस, हमेशा मौजूद रहते हैं. इनमें लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.
ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके पुष्टि करने पर, Chat ऐप्लिकेशन को उस स्पेस के बारे में जानकारी मिलती है जिसमें वह सदस्य है. उपयोगकर्ता की पुष्टि करने के बाद, आपको वे स्पेस दिखेंगे जिनका ऐक्सेस, पुष्टि किए गए उपयोगकर्ता के पास है. यह ऐक्सेस, स्पेस के सदस्य या Google Workspace एडमिन के तौर पर मिल सकता है.
ज़रूरी शर्तें
Node.js
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Node.js क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat के उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat के उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Python
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Python क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Java
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Java क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Apps Script
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
- Google Chat का कोई स्पेस, जिसमें पुष्टि किए गए उपयोगकर्ता या कॉल करने वाले Chat ऐप्लिकेशन का सदस्यता लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
स्पेस बनाना
Google Chat में स्पेस पाने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
- अनुमति का दायरा:
- उपयोगकर्ता की पुष्टि करने के लिए, अनुमति के
chat.spaces.readonly
याchat.spaces
दायरे की जानकारी दें. - ऐप्लिकेशन की पुष्टि के लिए,
chat.bot
अनुमति का दायरा याchat.app.spaces
दायरा तय करें.chat.app.spaces
स्कोप, डेवलपर के लिए उपलब्ध झलक में उपलब्ध है. इसके लिए, एडमिन की एक बार की अनुमति की ज़रूरत होती है.
- उपयोगकर्ता की पुष्टि करने के लिए, अनुमति के
GetSpace()
वाला तरीका कॉल करें. इसके लिए, उस स्पेस काname
डालें जिसका ऐक्सेस आपको चाहिए. Google Chat केSpace
संसाधन या स्पेस के यूआरएल से, स्पेस का नाम पाएं.
स्पेस का ब्यौरा पाने के लिए, उपयोगकर्ता के तौर पर स्पेस में शामिल होना
उपयोगकर्ता की पुष्टि करने के बाद, स्पेस की जानकारी पाने का तरीका यहां बताया गया है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
Chat API, Space
का एक इंस्टेंस दिखाता है, जिसमें बताए गए स्पेस की जानकारी होती है.
Google Workspace एडमिन के तौर पर, स्पेस की जानकारी पाना
अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन के किसी भी स्पेस के बारे में जानकारी पाने के लिए, GetSpace
तरीका अपनाएं.
Google Workspace एडमिन के तौर पर, इस तरीके को कॉल करने के लिए यह तरीका अपनाएं:
- उपयोगकर्ता की पुष्टि करने के तरीके का इस्तेमाल करके, उस तरीके को कॉल करें. साथ ही, ऐसा अनुमति का दायरा तय करें जिससे एडमिन के अधिकारों का इस्तेमाल करके, उस तरीके को कॉल किया जा सके.
- अपने अनुरोध में,
useAdminAccess
सेtrue
तक के क्वेरी पैरामीटर की जानकारी दें.
ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर, Google Chat के स्पेस मैनेज करना लेख पढ़ें.
Chat ऐप्लिकेशन के तौर पर स्पेस की जानकारी पाना
ऐप्लिकेशन की पुष्टि की मदद से, स्पेस की जानकारी पाने का तरीका यहां बताया गया है:
Node.js
Python
Java
Apps Script
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
Chat API, Space
का एक इंस्टेंस दिखाता है. इसमें, चुने गए स्पेस की जानकारी होती है.
सीमाएं और ध्यान देने वाली बातें
accessSettings
,predefinedPermissionSettings
, औरpermissionSettings
फ़ील्ड सिर्फ़ तब भरते हैं, जबchat.app.spaces
स्कोप की मदद से पुष्टि की जाती है. साथ ही, अनुमति की सेटिंग सिर्फ़ उन स्पेस तक सीमित होती हैं जिन्हें Chat ऐप्लिकेशन ने बनाया है.
मिलते-जुलते विषय
- स्पेस बनाएं.
- स्पेस सेट अप करना.
- स्पेस की सूची.
- स्पेस को अपडेट करना.
- स्पेस मिटाना.
- डायरेक्ट मैसेज स्पेस ढूंढें.