इस गाइड में, किसी उपयोगकर्ता, Google ग्रुप या Chat ऐप्लिकेशन को किसी स्पेस में न्योता भेजने या जोड़ने के लिए, Google Chat API के Membership
संसाधन पर create()
तरीका इस्तेमाल करने का तरीका बताया गया है. इसे सदस्यता बनाना भी कहा जाता है. सदस्यता बनाते समय, अगर किसी सदस्य ने अपने-आप सदस्यता स्वीकार करने की नीति बंद कर दी है, तो उसे न्योता भेजा जाएगा. साथ ही, स्पेस में शामिल होने से पहले, उसे न्योता स्वीकार करना होगा. अगर ऐसा नहीं किया जाता है, तो सदस्यता बनाने पर, सदस्य को सीधे उस स्पेस में जोड़ दिया जाता है.
अगर आप Google Workspace एडमिन हैं, तो आपके पास अपने Google Workspace संगठन के किसी भी स्पेस में उपयोगकर्ता, Google Groups या चैट ऐप्लिकेशन जोड़ने का विकल्प होता है.
Membership
संसाधन से यह पता चलता है कि किसी उपयोगकर्ता या Google 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 Cloud Client Library इंस्टॉल करें.
- अपने 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
- आपके पास ऐसा Business या Enterprise Google Workspace खाता होना चाहिए जिसके पास Google Chat का ऐक्सेस हो.
- अपने एनवायरमेंट को सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
- अपने Chat ऐप्लिकेशन के लिए नाम, आइकॉन, और जानकारी के साथ Google Chat API को चालू और कॉन्फ़िगर करें.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
- इस गाइड में, आपको उपयोगकर्ता या ऐप्लिकेशन की पुष्टि में से किसी एक का इस्तेमाल करना होगा. Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं. यह तरीका जानने के लिए, Google Chat ऐप्लिकेशन के तौर पर पुष्टि करना और अनुमति देना लेख पढ़ें.
- अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर या Chat ऐप्लिकेशन के तौर पर पुष्टि करनी है.
किसी उपयोगकर्ता को स्पेस में शामिल होने का न्योता भेजना या उसे स्पेस में जोड़ना
उपयोगकर्ता की पुष्टि की सुविधा वाले स्पेस में किसी उपयोगकर्ता को न्योता भेजने या जोड़ने के लिए, अपने अनुरोध में ये चीज़ें डालें:
chat.memberships
अनुमति का स्कोप बताएं.CreateMembership()
वाला तरीका कॉल करें.- जिस स्पेस में सदस्यता बनानी है उसके संसाधन के नाम के तौर पर
parent
को पास करें. membership
कोMembership
के इंस्टेंस के तौर पर पास करें. साथ ही, इसके फ़ील्डmember
को इनके साथ सेट करें:type
फ़ील्ड कोHUMAN
पर सेट किया गया.name
फ़ील्ड कोusers/{user}
पर सेट किया गया है, जहां{user}
वह व्यक्ति है जिसे आपको स्पेस में जोड़ना है. Chat का उपयोगकर्ता बताने के लिए,{user}
को इनमें से किसी भी विकल्प से बदलें:- People API में व्यक्ति का आईडी. उदाहरण के लिए, अगर People API के person एट्रिब्यूट की वैल्यू
resourceName
people/123456789
है, तोusers/123456789
का इस्तेमाल करें. - Directory API में उपयोगकर्ता का आईडी.
- उपयोगकर्ता का ईमेल पता. उदाहरण के लिए,
users/222larabrown@gmail.com
याusers/larabrown@cymbalgroup.com
. अगर उपयोगकर्ता किसी Google खाते का इस्तेमाल करता है या वह किसी दूसरे Google Workspace संगठन से जुड़ा है, तो आपको उसके ईमेल पते का इस्तेमाल करना होगा.
- People API में व्यक्ति का आईडी. उदाहरण के लिए, अगर People API के person एट्रिब्यूट की वैल्यू
इस उदाहरण में, उपयोगकर्ता की पुष्टि करने की सुविधा वाले स्पेस में किसी उपयोगकर्ता को जोड़ा गया है:
Node.js
Python
Java
Apps Script
सैंपल चलाने के लिए, इन्हें बदलें:
SPACE_NAME
: स्पेस केname
का आईडी. आईडी पाने के लिए,ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.USER_NAME
: यूज़र आईडी.
Chat API, Membership
का एक इंस्टेंस दिखाता है, जिसमें बनाई गई उपयोगकर्ता सदस्यता की जानकारी होती है.
किसी स्पेस में Google ग्रुप को न्योता देना या जोड़ना
उपयोगकर्ता की पुष्टि करने के लिए, किसी Google ग्रुप को स्पेस में शामिल होने का न्योता भेजने या उसमें जोड़ने के लिए, अपने अनुरोध में ये चीज़ें डालें. ऐप्लिकेशन की पुष्टि करने की सुविधा, किसी Google ग्रुप को स्पेस में शामिल करने या न्योता भेजने के लिए काम नहीं करती:
chat.memberships
अनुमति का स्कोप बताएं.CreateMembership()
तरीके का इस्तेमाल करें.- जिस स्पेस में सदस्यता बनानी है उसके संसाधन के नाम के तौर पर
parent
को पास करें. membership
कोMembership
के इंस्टेंस के तौर पर पास करें. साथ ही,groupMember
केname
फ़ील्ड कोgroups/{group}
पर सेट करें. यहां{group}
वह ग्रुप आईडी है जिसके लिए आपको सदस्यता बनानी है. ग्रुप का आईडी, Cloud Identity API का इस्तेमाल करके पाया जा सकता है.
Google ग्रुप को किसी ग्रुप चैट या डायरेक्ट मैसेज में नहीं जोड़ा जा सकता. इन्हें सिर्फ़ नाम वाले स्पेस में जोड़ा जा सकता है.
इस उदाहरण में, उपयोगकर्ता की पुष्टि करने के बाद, किसी नाम वाले स्पेस में ग्रुप जोड़ा गया है:
Node.js
Python
Java
Apps Script
सैंपल चलाने के लिए, इनकी जगह ये डालें:
SPACE_NAME
: स्पेस केname
का आईडी. आईडी पाने के लिए,ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.GROUP_NAME
: ग्रुप आईडी.
Chat API, Membership
का एक इंस्टेंस दिखाता है. इसमें, उपयोगकर्ता की बनाई गई सदस्यता की जानकारी होती है.
किसी स्पेस में Chat ऐप्लिकेशन जोड़ना
किसी चैट ऐप्लिकेशन के स्पेस में दूसरे ऐप्लिकेशन को सदस्य के तौर पर नहीं जोड़ा जा सकता. किसी स्पेस या दो लोगों के बीच के डायरेक्ट मैसेज में Chat ऐप्लिकेशन जोड़ने के लिए, अपने अनुरोध में उपयोगकर्ता की पुष्टि के साथ ये जानकारी दें. ऐप्लिकेशन की पुष्टि की सुविधा से, किसी स्पेस में Chat ऐप्लिकेशन को न्योता देने या जोड़ने की सुविधा काम नहीं करती:
chat.memberships.app
अनुमति का स्कोप बताएं.CreateMembership()
वाला तरीका कॉल करें.- जिस स्पेस में सदस्यता बनानी है उसके संसाधन के नाम के तौर पर
parent
पास करें. membership
कोMembership
के इंस्टेंस के तौर पर पास करें. साथ ही, इसके फ़ील्डmember
को इनके साथ सेट करें:type
फ़ील्ड कोBOT
पर सेट किया गया.name
फ़ील्ड कोusers/app
पर सेट किया गया है; यह एक उपनाम है, जो Chat API को कॉल करने वाले ऐप्लिकेशन को दिखाता है.
इस उदाहरण में, किसी स्पेस में Chat ऐप्लिकेशन जोड़ा गया है:
Node.js
Python
Java
Apps Script
सैंपल चलाने के लिए, SPACE_NAME
को स्पेस के name
से मिले आईडी से बदलें.
आईडी पाने के लिए, ListSpaces()
तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.
Chat API, Membership
का एक इंस्टेंस दिखाता है. इसमें, उपयोगकर्ता की बनाई गई सदस्यता की जानकारी होती है.
Chat ऐप्लिकेशन के तौर पर किसी व्यक्ति को स्पेस में शामिल होने का न्योता भेजना या जोड़ना
ऐप्लिकेशन की पुष्टि करने के लिए, एडमिन की अनुमति एक बार लेनी होगी.
ऐप्लिकेशन से पुष्टि करने की सुविधा का इस्तेमाल करके, किसी उपयोगकर्ता को स्पेस में शामिल होने का न्योता भेजने या जोड़ने के लिए, अपने अनुरोध में ये चीज़ें शामिल करें:
chat.app.memberships
अनुमति का स्कोप बताएं.membership
संसाधन पर,create
तरीके को कॉल करें.parent
को उस स्पेस के संसाधन के नाम पर सेट करें जिसमें सदस्यता बनानी है.member
कोusers/{user}
पर सेट करें. यहां{user}
वह व्यक्ति है जिसके लिए आपको सदस्यता बनानी है. यह व्यक्ति इनमें से कोई एक हो सकता है:- People API में व्यक्ति का आईडी. उदाहरण के लिए, अगर People API के person
resourceName
एट्रिब्यूट की वैल्यूpeople/123456789
है, तोmembership.member.name
एट्रिब्यूट की वैल्यूusers/123456789
पर सेट करें. - Directory API में उपयोगकर्ता का आईडी.
- उपयोगकर्ता का ईमेल पता. उदाहरण के लिए,
users/222larabrown@gmail.com
याusers/larabrown@cymbalgroup.com
. अगर वह उपयोगकर्ता Google खाते का इस्तेमाल करता है या वह Google Workspace का इस्तेमाल करने वाले किसी अन्य संगठन का है, तो आपको उसके ईमेल पते का इस्तेमाल करना होगा.
- People API में व्यक्ति का आईडी. उदाहरण के लिए, अगर People API के person
एपीआई पासकोड बनाना
डेवलपर झलक एपीआई तरीके को कॉल करने के लिए, आपको एपीआई खोज दस्तावेज़ के ऐसे वर्शन का इस्तेमाल करना होगा जो सार्वजनिक नहीं है. अनुरोध की पुष्टि करने के लिए, आपको एपीआई पासकोड डालना होगा.
एपीआई पासकोड बनाने के लिए, अपने ऐप्लिकेशन का Google Cloud प्रोजेक्ट खोलें और यह तरीका अपनाएं:
- Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.
- क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
- आपको अपनी नई एपीआई कुंजी दिखेगी.
- अपने ऐप्लिकेशन के कोड में इस्तेमाल करने के लिए, एपीआई पासकोड कॉपी करने के लिए, कॉपी करें पर क्लिक करें. एपीआई पासकोड, प्रोजेक्ट के क्रेडेंशियल के "एपीआई पासकोड" सेक्शन में भी मिल सकता है.
- बेहतर सेटिंग अपडेट करने और एपीआई पासकोड के इस्तेमाल को सीमित करने के लिए, पासकोड पर पाबंदी लगाएं पर क्लिक करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदियां लगाना लेख पढ़ें.
Chat API को कॉल करने वाली स्क्रिप्ट लिखना
इस उदाहरण में, ऐप्लिकेशन की मदद से पुष्टि करने की सुविधा का इस्तेमाल करके, किसी उपयोगकर्ता को स्पेस में जोड़ा गया है:
Python
- अपनी वर्किंग डायरेक्ट्री में,
chat_membership_app_create.py
नाम की फ़ाइल बनाएं. chat_membership_app_create.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.memberships"] def main(): ''' Authenticates with Chat API using app authentication, then adds a user to a Chat space by creating a membership. ''' # 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().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Specify which user the membership is for. body = { 'member': { 'name':'users/USER', 'type': 'HUMAN' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
कोड में, इन्हें बदलें:
API_KEY
: Chat API के लिए सेवा एंडपॉइंट बनाने के लिए, आपने जो एपीआई पासकोड बनाया है.SPACE
: स्पेस का नाम, जो आपको Chat API मेंspaces.list
तरीके या स्पेस के यूआरएल से मिल सकता है.USER
: यूज़र आईडी.
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:
python3 chat_membership_app_create.py
Google Workspace एडमिन के तौर पर, किसी स्पेस में उपयोगकर्ताओं या Google ग्रुप को जोड़ना
अगर आप Google Workspace एडमिन हैं, तो आपके पास अपने Google Workspace संगठन के किसी भी स्पेस में उपयोगकर्ताओं, Google Groups या चैट ऐप्लिकेशन को जोड़ने के लिए, create()
तरीके को कॉल करने का विकल्प होता है.
Google Workspace एडमिन के तौर पर, इस तरीके को कॉल करने के लिए यह तरीका अपनाएं:
- उपयोगकर्ता की पुष्टि करने के तरीके का इस्तेमाल करके, उस तरीके को कॉल करें. साथ ही, ऐसा अनुमति का दायरा तय करें जिससे एडमिन के अधिकारों का इस्तेमाल करके, उस तरीके को कॉल किया जा सके.
- अपने अनुरोध में,
useAdminAccess
सेtrue
तक के क्वेरी पैरामीटर की जानकारी दें.
ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर, Google Chat के स्पेस मैनेज करना लेख पढ़ें.
सीमाएं और विचार
- ऐप्लिकेशन की पुष्टि करने की सुविधा की मदद से,
Chat ऐप्लिकेशन में उपयोगकर्ताओं को न्योता भेजा जा सकता है या उन्हें जोड़ा जा सकता है. हालांकि, Google Groups या
Chat ऐप्लिकेशन के ज़रिए ऐसा नहीं किया जा सकता. Chat ऐप्लिकेशन को खुद को जोड़ने के लिए,
chat.memberships
ऑथराइज़ेशन स्कोप के साथ उपयोगकर्ता की पहचान की पुष्टि करने की प्रोसेस का इस्तेमाल करना होगा.
मिलते-जुलते विषय
- किसी उपयोगकर्ता या Chat ऐप्लिकेशन की सदस्यता के बारे में जानकारी पाना.
- स्पेस में सदस्यों की सूची देखना.
- Google Chat के स्पेस में किसी उपयोगकर्ता की सदस्यता की स्थिति अपडेट करना.
- स्पेस से किसी उपयोगकर्ता या Chat ऐप्लिकेशन को हटाना.