यह गाइड बताती है कि
create()
नाम वाला स्पेस बनाने के लिए, Google Chat API के Space
संसाधन का इस्तेमाल करें.
कॉन्टेंट बनाने
Space
संसाधन
यह ऐसी जगह दिखाता है जहां लोग और Chat ऐप्लिकेशन मैसेज भेज सकते हैं,
और साथ मिलकर काम करने की सुविधा मिलती है. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
- ग्रुप चैट में तीन या उससे ज़्यादा लोग शामिल होते हैं. साथ ही, ये चैट Chat ऐप्लिकेशन पर की जाती हैं.
- नाम वाले स्पेस वे स्थायी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और सहयोग करना होगा.
नाम वाले स्पेस में लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और एक साथ काम करते हैं. नाम वाले स्पेस में, Chat ऐप्लिकेशन शामिल हो सकते हैं. नाम वाले स्पेस इसमें अतिरिक्त सुविधाएं शामिल होती हैं. इन सुविधाओं में, बिना नाम वाली ग्रुप बातचीत और डायरेक्ट मैसेज शामिल होते हैं के पास ये अधिकार नहीं होते, जैसे कि स्पेस मैनेजर जो एडमिन सेटिंग लागू कर सकते हैं, के बारे में जानकारी. साथ ही, लोगों और ऐप्लिकेशन को जोड़ना या हटाना. नाम वाला स्पेस बनाने के बाद, उसमें पुष्टि किए गए उपयोगकर्ता के अलावा कोई और सदस्य नहीं हो सकता. स्पेस में ये काम नहीं किए जाते अन्य लोगों या ऐप्लिकेशन को शामिल करें; चैट ऐप्लिकेशन पर भी नहीं जो इसे बनाता है. स्पेस में सदस्यों को जोड़ने के लिए, पैसे चुकाकर ली जाने वाली सदस्यता बनाएं लेख पढ़ें.
एक से ज़्यादा सदस्यों वाला नाम वाला स्पेस बनाने के लिए—बिना नाम वाली ग्रुप चैट तीन या उससे ज़्यादा लोग हो सकते हैं या दो लोगों के बीच डायरेक्ट मैसेज में बातचीत हो सकती है या व्यक्ति और Chat ऐप्लिकेशन Chat API—कोई स्पेस सेट अप करें आज़माएं.
ज़रूरी शर्तें
Node.js
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- Google Chat API को चालू और कॉन्फ़िगर करें. इसका नाम रखें, आइकॉन और ब्यौरा जोड़ें.
- Node.js क्लाउड क्लाइंट लाइब्रेरी इंस्टॉल करें.
- अपने Google Chat API में, पुष्टि करने के तरीके के हिसाब से ऐक्सेस क्रेडेंशियल बनाएं
अनुरोध:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
Python
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- Google Chat API को चालू और कॉन्फ़िगर करें. इसका नाम रखें, आइकॉन और ब्यौरा जोड़ें.
- इंस्टॉल करें Python Cloud क्लाइंट लाइब्रेरी.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें. - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए,
सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को
credentials.json
नाम वाली JSON फ़ाइल के तौर पर सेव करें.
- Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए,
OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं और क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में,
- अनुमति देने का दायरा इस आधार पर चुनें कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या चैट ऐप्लिकेशन.
Java
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- 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 की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और बेहतर चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति देने का दायरा इस आधार पर चुनें कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या चैट ऐप्लिकेशन.
उपयोगकर्ता के तौर पर नाम वाला स्पेस बनाएं
उपयोगकर्ता की पुष्टि की सुविधा के साथ कोई नाम वाला स्पेस बनाने के लिए, अपने अनुरोध में ये चीज़ें डालें:
chat.spaces.create
याchat.spaces
के लिए अनुमति का स्कोप तय करें.CreateSpace()
वाला तरीका कॉल करें. इसके लिए,space
कोSpace
के इंस्टेंस के तौर पर पास करें. साथ ही, इन फ़ील्ड का इस्तेमाल करें:spaceType
कोSPACE
पर सेट करें.displayName
को स्पेस के उस नाम पर सेट किया गया है जो उपयोगकर्ता को दिखता है.- इसके अलावा, नीचे दिए गए एट्रिब्यूट जैसे अन्य एट्रिब्यूट भी सेट करें:
spaceDetails
- स्पेस के लिए, उपयोगकर्ता को दिखने वाला ब्यौरा और दिशा-निर्देशों का सेट.predefinedPermissionSettings
- स्पेस के लिए पहले से तय की गई अनुमतियां. उदाहरण के लिए, इसे कॉन्फ़िगर किया जा सकता है, ताकि सभी सदस्य या सिर्फ़ स्पेस मैनेजर यहां मैसेज पोस्ट कर सकते हैं.
नाम वाला स्पेस बनाने का तरीका यहां बताया गया है:
Node.js
Python
Java
Apps Script
Chat ऐप्लिकेशन के तौर पर, नाम वाला स्पेस बनाना
ऐप्लिकेशन की पुष्टि करने के लिए, एक बार पुष्टि करना ज़रूरी है एडमिन की मंज़ूरी.
किसी उपयोगकर्ता को स्पेस में शामिल करने या न्योता भेजने के लिए, ऐप्लिकेशन की पुष्टि करना, पास नीचे दी गई शर्तों को पूरा करें:
- अनुमति देने के लिए,
chat.app.spaces.create
याchat.app.spaces
की जानकारी दें दायरा. - कॉल करें
create
तरीका पूरी तरह कैसेSpace
संसाधन. spaceType
कोSPACE
पर सेट करें.- शुरू
displayName
उपयोगकर्ता को दिखने वाले स्पेस के नाम से. नीचे दिए गए उदाहरण में,displayName
API-made
पर सेट है. customer
फ़ील्ड का इस्तेमाल करके, Google Workspace डोमेन का ग्राहक आईडी डालें.- आप चाहें, तो स्पेस के दूसरे एट्रिब्यूट सेट करें. जैसे,
spaceDetails
(स्पेस के लिए उपयोगकर्ताओं को दिखने वाला ब्यौरा और दिशा-निर्देशों का सेट).
एपीआई पासकोड बनाना
डेवलपर प्रीव्यू एपीआई के तरीके को कॉल करने के लिए, आपको एपीआई के खोज से जुड़े दस्तावेज़ के ऐसे वर्शन का इस्तेमाल करना होगा जो सार्वजनिक तौर पर उपलब्ध न हो. अनुरोध की पुष्टि करने के लिए, आपको एक एपीआई पासकोड भेजना होगा.
एपीआई पासकोड बनाने के लिए, अपने ऐप्लिकेशन का Google Cloud प्रोजेक्ट खोलें और यह तरीका अपनाएं:
- Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल. पर जाएं
- क्रेडेंशियल बनाएं पर क्लिक करें > एपीआई पासकोड.
- आपको अपनी नई API (एपीआई) कुंजी दिखेगी.
- अपने ऐप्लिकेशन के कोड में इस्तेमाल करने के लिए, एपीआई पासकोड कॉपी करने के लिए, कॉपी करें पर क्लिक करें. एपीआई पासकोड, प्रोजेक्ट के क्रेडेंशियल के "एपीआई पासकोड" सेक्शन में भी मिल सकता है.
- बेहतर सेटिंग को अपडेट करने और इस्तेमाल को सीमित करने के लिए, कुंजी पर पाबंदी लगाएं पर क्लिक करें . ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदियां लगाना लेख पढ़ें.
Chat API को कॉल करने वाली स्क्रिप्ट लिखना
नाम वाला स्पेस बनाने का तरीका यहां बताया गया है:
Python
- अपनी वर्किंग डायरेक्ट्री में,
chat_space_create_named_app.py
नाम की फ़ाइल बनाएं. chat_space_create_named_app.py
में यह कोड शामिल करें:from google.oauth2 import service_account from apiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.app.spaces.create"] def main(): ''' Authenticates with Chat API using app authentication, then creates a Chat space. ''' # Specify service account details. creds = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY') # Use the service endpoint to call Chat API. result = chat.spaces().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made', # The customer ID of the Workspace domain. 'customer': 'CUSTOMER' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
कोड में, इनकी जगह ये डालें:
API_KEY
: वह एपीआई पासकोड जिसे आपने बनाने के लिए बनाया है Chat API के लिए सेवा एंडपॉइंट.CUSTOMER
:customer/{customer}
फ़ॉर्मैट में, स्पेस के डोमेन का ग्राहक आईडी, जहां{customer}
, Admin SDK टूल के ग्राहक संसाधन सेID
है. Chat ऐप्लिकेशन के उसी Google Workspace संगठन में स्पेस बनाने के लिए,customers/my_customer
का इस्तेमाल करें.
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:
python3 chat_space_create_named_app.py
Google Chat में स्पेस खोलना
स्पेस पर जाने के लिए, स्पेस का यूआरएल बनाने के लिए स्पेस के रिसॉर्स आईडी का इस्तेमाल करें. Google Chat के जवाब के मुख्य हिस्से में, स्पेस name
का संसाधन आईडी देखा जा सकता है. उदाहरण के लिए, अगर आपके स्पेस का name
spaces/1234567
है, तो इस यूआरएल का इस्तेमाल करके स्पेस पर जाया जा सकता है: https://mail.google.com/chat/u/0/#chat/space/1234567
.
मिलते-जुलते विषय
- सदस्य बनाकर, स्पेस में लोगों और ऐप्लिकेशन को जोड़ें.
- स्पेस में इसके ज़रिए कोई मैसेज पोस्ट करें मैसेज बनाना.
- किसी स्पेस के बारे में जानकारी पाना.
- स्पेस की सूची.
- स्पेस को अपडेट करना.
- किसी स्पेस को मिटाना.
- स्पेस सेट अप करना.
- डायरेक्ट मैसेज वाला स्पेस ढूंढें.
- स्पेस को चुनिंदा उपयोगकर्ताओं के लिए उपलब्ध कराना.