ऐडवांस चैट सेवा की मदद से, Apps Script में Google Chat API का इस्तेमाल किया जा सकता है. इस एपीआई की मदद से स्क्रिप्ट, Chat स्पेस ढूंढ सकती हैं, बना सकती हैं, और उनमें बदलाव कर सकती हैं. साथ ही, स्पेस में सदस्यों को जोड़ सकती हैं या हटा सकती हैं. इसके अलावा, टेक्स्ट, कार्ड, अटैचमेंट, और प्रतिक्रियाओं वाले मैसेज पढ़ सकती हैं या पोस्ट कर सकती हैं.
ज़रूरी शर्तें
- Google Cloud Console में Chat API कॉन्फ़िगरेशन पेज पर कॉन्फ़िगर किया गया Apps Script Google Chat ऐप्लिकेशन. ऐप्लिकेशन के Apps Script प्रोजेक्ट में, Apps Script प्रोजेक्ट के लिए अपने-आप बनने वाले डिफ़ॉल्ट प्रोजेक्ट के बजाय, स्टैंडर्ड Google Cloud प्रोजेक्ट का इस्तेमाल किया जाना चाहिए. Google Chat के साथ काम करने वाला ऐप्लिकेशन बनाने के लिए, Google Apps Script की मदद से Google Chat ऐप्लिकेशन बनाना लेख पढ़ें.
- Chat ऐप्लिकेशन के लिए पुष्टि करने की सुविधा कॉन्फ़िगर की गई है. किसी उपयोगकर्ता की ओर से कोई कार्रवाई करने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर कोई कार्रवाई करने के लिए, सेवा खाते से ऐप्लिकेशन की पुष्टि करना ज़रूरी है. यह देखने के लिए कि Chat API का कोई तरीका किस तरह की पुष्टि करने की सुविधा के साथ काम करता है, Google Chat API कॉल के लिए ज़रूरी पुष्टि के तरीके देखें.
रेफ़रंस
इस सेवा के बारे में ज़्यादा जानने के लिए, Chat API के रेफ़रंस दस्तावेज़ देखें. Apps Script की सभी ऐडवांस सेवाओं की तरह, Chat सेवा में भी वही ऑब्जेक्ट, तरीके, और पैरामीटर इस्तेमाल होते हैं जो पब्लिक एपीआई में होते हैं.
नमूना कोड
इन सैंपल में, ऐडवांस सेवा का इस्तेमाल करके, Google Chat API की सामान्य कार्रवाइयां करने का तरीका बताया गया है.
उपयोगकर्ता क्रेडेंशियल का इस्तेमाल करके मैसेज पोस्ट करना
यहां दिए गए उदाहरण में, उपयोगकर्ता की ओर से Chat स्पेस में मैसेज पोस्ट करने का तरीका बताया गया है.
Apps Script प्रोजेक्ट की
appsscript.json
फ़ाइल में,chat.messages.create
ऑथराइज़ेशन स्कोप जोड़ें:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.create" ]
Apps Script प्रोजेक्ट के कोड में, इस तरह का फ़ंक्शन जोड़ें:
ऐप्लिकेशन के क्रेडेंशियल के साथ मैसेज पोस्ट करना
यहां दिए गए उदाहरण में बताया गया है कि ऐप्लिकेशन की ओर से, Chat स्पेस में मैसेज कैसे पोस्ट किया जाता है. सेवा खाते के साथ Chat की ऐडवांस सेवा का इस्तेमाल करने के लिए, आपको appsscript.json
में अनुमति के स्कोप तय करने की ज़रूरत नहीं होती. सेवा खातों से पुष्टि करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना लेख पढ़ें.
स्पेस पाना
यहां दिए गए उदाहरण में, चैट स्पेस के बारे में जानकारी पाने का तरीका बताया गया है.
Apps Script प्रोजेक्ट की
appsscript.json
फ़ाइल में,chat.spaces.readonly
ऑथराइज़ेशन स्कोप जोड़ें:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.readonly" ]
Apps Script प्रोजेक्ट के कोड में, इस तरह का फ़ंक्शन जोड़ें:
कोई स्पेस बनाना
यहां दिए गए उदाहरण में, Chat स्पेस बनाने का तरीका बताया गया है.
Apps Script प्रोजेक्ट की
appsscript.json
फ़ाइल में,chat.spaces.create
ऑथराइज़ेशन स्कोप जोड़ें:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.create" ]
Apps Script प्रोजेक्ट के कोड में, इस तरह का फ़ंक्शन जोड़ें:
पैसे चुकाकर ली गई सदस्यताओं की सूची
यहां दिए गए उदाहरण में, चैट स्पेस के सभी सदस्यों की सूची बनाने का तरीका बताया गया है.
Apps Script प्रोजेक्ट की
appsscript.json
फ़ाइल में,chat.memberships.readonly
ऑथराइज़ेशन स्कोप जोड़ें:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships.readonly" ]
Apps Script प्रोजेक्ट के कोड में, इस तरह का फ़ंक्शन जोड़ें:
समस्या हल करें
अगर आपको गड़बड़ी के मैसेज Some requested scopes cannot be shown
के साथ Error 400: invalid_scope
दिखता है, तो इसका मतलब है कि आपने Apps Script प्रोजेक्ट की appsscript.json
फ़ाइल में कोई भी अनुमति का दायरा तय नहीं किया है. ज़्यादातर मामलों में, Apps Script अपने-आप यह तय करता है कि किसी स्क्रिप्ट को किन स्कोप की ज़रूरत है. हालांकि, Chat की ऐडवांस सेवा का इस्तेमाल करते समय, आपको उन अनुमतियों के स्कोप को मैन्युअल तरीके से जोड़ना होगा जिनका इस्तेमाल आपकी स्क्रिप्ट करती है. इन्हें आपको अपने Apps Script प्रोजेक्ट की मेनिफ़ेस्ट फ़ाइल में जोड़ना होगा. एक्सप्लिसिट स्कोप सेट करना लेख पढ़ें.
इस गड़बड़ी को ठीक करने के लिए, Apps Script प्रोजेक्ट की appsscript.json
फ़ाइल में, अनुमति के सही स्कोप जोड़ें. इन्हें oauthScopes
ऐरे के हिस्से के तौर पर जोड़ें. उदाहरण के लिए, spaces.messages.create
तरीके को कॉल करने के लिए, यह कोड जोड़ें:
"oauthScopes": [
"https://www.googleapis.com/auth/chat.messages.create"
]
सीमाएं और ज़रूरी बातें
Advanced Chat की सेवा इन सुविधाओं के साथ काम नहीं करती:
- Chat API का तरीका
media.download
. - Chat API के ऐसे तरीके जो डेवलपर के लिए उपलब्ध झलक में उपलब्ध हैं
मैसेज अटैचमेंट डाउनलोड करने या डेवलपर प्रीव्यू वाले तरीके को कॉल करने के लिए, UrlFetchApp
का इस्तेमाल करें.