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