इस गाइड में, स्पेस की सूची बनाने के लिए, Google Chat API के Space
संसाधन पर list()
तरीके का इस्तेमाल करने का तरीका बताया गया है. स्पेस की सूची से, पेज पर दिखने वाली स्पेस की सूची मिलती है. इस सूची को फ़िल्टर भी किया जा सकता है.
Space
संसाधन, एक ऐसी जगह को दिखाता है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
- ग्रुप चैट में तीन या उससे ज़्यादा लोग शामिल होते हैं. साथ ही, ये चैट Chat ऐप्लिकेशन पर की जाती हैं.
- नाम वाले स्पेस, हमेशा मौजूद रहते हैं. इनमें लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.
ऐप्लिकेशन की पुष्टि करने वाले स्पेस की सूची में, वे स्पेस शामिल होते हैं जिनका ऐक्सेस Chat ऐप्लिकेशन के पास होता है. उपयोगकर्ता की पुष्टि वाले स्पेस की सूची में, वे स्पेस शामिल होते हैं जिनका ऐक्सेस पुष्टि किए गए उपयोगकर्ता के पास होता है.
ज़रूरी शर्तें
Node.js
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Node.js क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
Python
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Python क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
Java
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- Java क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या 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.spaces.readonly
याchat.spaces
दायरे की जानकारी दें. ListSpaces()
वाला तरीका कॉल करें.
इस उदाहरण में, नाम वाले ऐसे स्पेस की सूची दी गई है जिन्हें पुष्टि किए गए उपयोगकर्ता देख सकते हैं. हालांकि, इसमें ग्रुप चैट और डायरेक्ट मैसेज शामिल नहीं हैं, क्योंकि उन्हें फ़िल्टर कर दिया जाता है:
Node.js
Python
Java
Apps Script
Chat API, स्पेस की पेज की गई सूची दिखाता है.
ऐप्लिकेशन की पुष्टि करने की सुविधा वाले स्पेस की सूची
Google Chat में स्पेस की सूची देखने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
- ऐप्लिकेशन की पुष्टि के लिए,
chat.bot
अनुमति का दायरा तय करें. ListSpaces()
वाला तरीका कॉल करें.
इस उदाहरण में, Chat ऐप्लिकेशन में दिखने वाले नाम वाले स्पेस की सूची दी गई है. इसमें ग्रुप चैट और डायरेक्ट मैसेज शामिल नहीं हैं:
Node.js
Python
Java
Apps Script
Chat API, स्पेस की पेज की गई सूची दिखाता है.
पेजेशन को पसंद के मुताबिक बनाना या सूची को फ़िल्टर करना
Google Chat में स्पेस की सूची बनाने के लिए, सूची में शामिल स्पेस के पेजेशन को पसंद के मुताबिक बनाने या उन्हें फ़िल्टर करने के लिए, यहां दिए गए वैकल्पिक क्वेरी पैरामीटर पास करें:
pageSize
: स्पेस की ज़्यादा से ज़्यादा संख्या. हो सकता है कि सेवा से इस वैल्यू से कम आइटम दिखें. अगर कोई वैल्यू नहीं दी जाती है, तो ज़्यादा से ज़्यादा 100 स्पेस दिखाए जाते हैं. ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. 1,000 से ज़्यादा वैल्यू होने पर, वह अपने-आप 1,000 हो जाती है.pageToken
: स्पेस की सूची से जुड़े पिछले कॉल से मिला पेज टोकन. अगला पेज देखने के लिए, यह टोकन दें. पेजेशन करते समय, फ़िल्टर की वैल्यू उस कॉल से मेल खानी चाहिए जिसने पेज टोकन दिया है. कोई दूसरी वैल्यू पास करने पर, अनचाहे नतीजे मिल सकते हैं.filter
: क्वेरी फ़िल्टर. काम करने वाली क्वेरी की जानकारी के लिए,ListSpacesRequest
रेफ़रंस देखें.
मिलते-जुलते विषय
- स्पेस बनाएं.
- स्पेस सेट अप करना.
- किसी स्पेस के बारे में जानकारी पाना.
- स्पेस को अपडेट करना.
- स्पेस मिटाना.
- डायरेक्ट मैसेज स्पेस ढूंढें.