इस गाइड में बताया गया है कि Google Chat API के Space
संसाधन पर, get()
तरीके का इस्तेमाल कैसे किया जाता है. इससे किसी स्पेस के बारे में जानकारी देखी जा सकती है. जैसे, उसका डिसप्ले नेम, ब्यौरा, और दिशा-निर्देश.
अगर आप Google Workspace एडमिन हैं, तो get()
तरीके का इस्तेमाल करके, अपने Google Workspace संगठन के किसी भी स्पेस के बारे में जानकारी वापस पा सकते हैं.
Space
संसाधन
एक ऐसी जगह होती है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (डीएम), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
- ग्रुप चैट, तीन या उससे ज़्यादा लोगों और चैट ऐप्लिकेशन के बीच होने वाली बातचीत होती है.
- नाम वाले स्पेस, ऐसी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.
ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके पुष्टि करने से, Chat ऐप्लिकेशन को उस स्पेस के बारे में जानकारी मिलती है जहां Chat ऐप्लिकेशन सदस्य है. उपयोगकर्ता की पुष्टि करके पुष्टि करने से, आपको उन स्पेस का ऐक्सेस मिलता है जिन्हें पुष्टि किए गए उपयोगकर्ता ने ऐक्सेस किया है. ऐसा स्पेस के सदस्य या Google Workspace एडमिन के तौर पर किया जाता है.
ज़रूरी शर्तें
Node.js
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, नाम, आइकॉन, और जानकारी के साथ Google Chat API चालू करें और उसे कॉन्फ़िगर करें.
- Node.js Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Python
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, नाम, आइकॉन, और जानकारी के साथ Google Chat API चालू करें और उसे कॉन्फ़िगर करें.
- Python Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Java
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, नाम, आइकॉन, और जानकारी के साथ Google Chat API चालू करें और उसे कॉन्फ़िगर करें.
- Java Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.
- Google Chat स्पेस, जिसमें पुष्टि किया गया उपयोगकर्ता या कॉल करने वाला Chat ऐप्लिकेशन सदस्य हो. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, Chat ऐप्लिकेशन को स्पेस में जोड़ें.
Apps Script
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास 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 एडमिन हैं, तो GetSpace
तरीके का इस्तेमाल करके, अपने Google Workspace संगठन के किसी भी स्पेस के बारे में जानकारी हासिल की जा सकती है.
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 ऐप्लिकेशन ने बनाया है.
मिलते-जुलते विषय
- कोई स्पेस बनाएं.
- कोई स्पेस सेट अप करना.
- स्पेस की सूची.
- स्पेस अपडेट करना.
- किसी स्पेस को मिटाना.
- डायरेक्ट मैसेज वाला स्पेस ढूंढें.