यह गाइड बताती है कि setup
तरीके का इस्तेमाल किस Space
संसाधन पर
Google Chat पर मौजूद स्पेस सेट अप करने के लिए Google Chat API. स्पेस को सेट अप करने पर, स्पेस बनता है
और उसमें तय किए गए उपयोगकर्ताओं को जोड़ता है.
कॉन्टेंट बनाने
Space
संसाधन
यह ऐसी जगह दिखाता है जहां लोग और Chat ऐप्लिकेशन मैसेज भेज सकते हैं,
और साथ मिलकर काम करने की सुविधा मिलती है. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या एक उपयोगकर्ता के बीच होने वाली बातचीत होते हैं एक चैट ऐप्लिकेशन.
- ग्रुप चैट में, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन.
- नाम वाले स्पेस वे स्थायी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और सहयोग करना होगा.
स्पेस सेट अप करते समय, इन बातों का ध्यान रखें:
- कॉल करने वाले (पुष्टि किए गए) उपयोगकर्ता को स्पेस में अपने-आप जोड़ दिया जाता है. इससे आपको अनुरोध में उपयोगकर्ता की सदस्यता की जानकारी देने की ज़रूरत नहीं है.
- डायरेक्ट मैसेज (DM) बनाते समय, अगर दो उपयोगकर्ताओं के बीच कोई DM मौजूद होता है, तो DM वापस भेजा जाता है. ऐसा न करने पर, एक डायरेक्ट मैसेज बनाया जाता है.
- ग्रुप चैट बनाते समय, अगर अनुरोध में दी गई सदस्यताओं की कोई जानकारी न दी गई हो ग्रुप चैट में जोड़ा जाता है (उदाहरण के लिए, अनुमति से जुड़ी समस्या), तो एक खाली ग्रुप चैट (इसमें सिर्फ़ कॉल करने वाला उपयोगकर्ता शामिल हो) बनाई जा सकती है.
- थ्रेड वाले जवाब की सुविधा वाले स्पेस सेट अप नहीं किए जा सकते. इसके अलावा, अपने संगठन से बाहर के लोगों को भी नहीं जोड़ा जा सकता Google Workspace.
- अनुरोध में दी गई डुप्लीकेट सदस्यताएं (इनमें कॉल करने वाले उपयोगकर्ता की जानकारी भी शामिल है) फ़िल्टर किए जाते हैं, न कि अनुरोध में गड़बड़ी.
ज़रूरी शर्तें
Python
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- Python 3.6 या इससे नया वर्शन
- पीआईपी पैकेज मैनेजमेंट टूल
- Google की नई क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए,
अपने कमांड-लाइन इंटरफ़ेस में यह कमांड चलाएं:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- Google Chat API को चालू और कॉन्फ़िगर करें. आइकॉन और ब्यौरा जोड़ें.
-
डेस्कटॉप ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. सैंपल को चलाने के लिए
गाइड, क्रेडेंशियल को JSON फ़ाइल (
client_secrets.json
) के रूप में लोकल डायरेक्ट्री.
- अनुमति देने का ऐसा स्कोप चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा देता हो.
Node.js
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- Node.js 14 या उसके बाद का वर्शन
- npm पैकेज मैनेजमेंट टूल
- Google की नई क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए,
अपने कमांड-लाइन इंटरफ़ेस में यह कमांड चलाएं:
npm install @google-cloud/local-auth @googleapis/chat
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- Google Chat API को चालू और कॉन्फ़िगर करें. आइकॉन और ब्यौरा जोड़ें.
-
डेस्कटॉप ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. सैंपल को चलाने के लिए
गाइड, क्रेडेंशियल को JSON फ़ाइल (
client_secrets.json
) के रूप में लोकल डायरेक्ट्री.
- अनुमति देने का ऐसा स्कोप चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा देता हो.
स्पेस सेट अप करना
स्पेस सेट अप करने के लिए, अपने अनुरोध में यह जानकारी दें:
chat.spaces.create
याchat.spaces
की अनुमति का दायरा बताएं.- कॉल करें
setup
तरीकाSpace
संसाधन पर जाएं. - किसी व्यक्ति को स्पेस के सदस्य के तौर पर जोड़ने के लिए,
users/{user}
तय करें. यहां{user}
या तो{person_id}
person
को People API से या किसीuser
को डायरेक्ट्री एपीआई में डालें. उदाहरण के लिए, अगर People API वाला कोई व्यक्तिresourceName
,people/123456789
है. आपके पास इस तरीके से उपयोगकर्ता को स्पेस में जोड़ने का विकल्प है इसमेंmember.name
के तौर परusers/123456789
की सदस्यता भी शामिल है. - स्पेस के सदस्य के तौर पर किसी ग्रुप को जोड़ने के लिए,
groups/{group}
तय करें, जहां{group}
है वह ग्रुप आईडी जिसके लिए आपको सदस्यता बनानी है. ग्रुप का आईडी ये काम कर सकता है को Cloud Identity API का इस्तेमाल करके वापस लाया जाएगा. उदाहरण के लिए, अगर Cloud Identity APIgroups/123456789
नाम वाला ग्रुप लौटाता है, फिर सेट करता हैgroups/123456789
के लिएmembership.groupMember.name
. Google Groups को ग्रुप चैट या डायरेक्ट मैसेज में जोड़ा गया हो, लेकिन उसे सिर्फ़ नाम वाले स्पेस में जोड़ा गया हो. - कॉल करने वाले व्यक्ति और दूसरे व्यक्ति के बीच डायरेक्ट मैसेज भेजने के लिए उपयोगकर्ता, अपने अनुरोध में सदस्य की सदस्यता की जानकारी दें.
- कॉल करने वाले उपयोगकर्ता और कॉल करने वाले ऐप्लिकेशन के बीच DM बनाने के लिए,
Space.singleUserBotDm
सेtrue
के लिए और किसी सदस्यता की जानकारी न दें. आप इस तरीके का इस्तेमाल सिर्फ़ कॉलिंग ऐप्लिकेशन के साथ DM सेट अप करने के लिए करें. कॉल के लिए इस्तेमाल की जाने वाली सेटिंग जोड़ने के लिए स्पेस के सदस्य के रूप में या दो मानव उपयोगकर्ताओं के बीच किसी मौजूदा DM के रूप में, देखें सदस्यता बनाएं.
इस उदाहरण में, नाम वाला स्पेस बनाया गया है और स्पेस में पैसे चुकाकर ली जाने वाली सदस्यताएं बनाई गई हैं एक ग्रुप और तीन लोगों के लिए काम करता है. इसमें, पुष्टि किए गए उपयोगकर्ता और दो उपयोगकर्ता शामिल हैं तय किए गए अन्य उपयोगकर्ता).
Python
- अपनी वर्किंग डायरेक्ट्री में,
chat_space_setup.py
नाम की फ़ाइल बनाएं. chat_space_setup.py
में यह कोड शामिल करें:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then sets up a Chat space by creating a space and adding members. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().setup( # Details about the space to set up. body = { # Attributes of the space to set up, like space type and display name. 'space': { # To set up a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space 'displayName': 'API-setup' }, # The users and groups to add to the space. # # The authenticated user is automatically added to the space, # and doesn't need to be specified in the memberships array. 'memberships': [ { 'member': { 'name':'users/123456789', 'type': 'HUMAN' } }, { 'member': { 'name':'users/987654321', 'type': 'HUMAN' } }, { 'groupMember': { 'name': 'groups/11223344' } } ] } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:
python3 chat_space_setup.py
Node.js
- अपनी वर्किंग डायरेक्ट्री में,
setup-space.js
नाम की फ़ाइल बनाएं. setup-space.js
में यह कोड शामिल करें:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Sets up a new Chat space with users. * @return {!Promise<!Object>} */ async function setupSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.setup({ requestBody: { space: { spaceType: 'SPACE', displayName: 'API-made', }, memberships: [ {member: {name: 'users/123456789', type: 'HUMAN'}}, {member: {name: 'users/987654321', type: 'HUMAN'}}, {groupMember: {name: 'groups/11223344'}}, ] } }); } setupSpace().then(console.log);
अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:
node setup-space.js
नाम वाला चैट स्पेस, जिसमें एक ग्रुप और तीन उपयोगकर्ता शामिल हों. इनमें, की पुष्टि हो चुकी है.
स्पेस में जाने के लिए, उसके संसाधन आईडी का इस्तेमाल करके स्पेस का यूआरएल बनाएं.
आपको Google Chat के जवाब में, name
स्पेस से संसाधन आईडी मिल सकता है
शरीर. उदाहरण के लिए, अगर आपके स्पेस का name
spaces/1234567
है, तो आप
को स्पेस में जोड़ने के लिए नीचे दिया गया यूआरएल इस्तेमाल करें:
https://mail.google.com/chat/u/0/#chat/space/1234567
.
मिलते-जुलते विषय
- कोई स्पेस बनाएं.
- किसी स्पेस के बारे में जानकारी पाना.
- स्पेस की सूची बनाना.
- स्पेस अपडेट करना.
- किसी स्पेस को मिटाना.
- डायरेक्ट मैसेज वाला स्पेस ढूंढें.
- स्पेस को कुछ खास लोगों के लिए उपलब्ध कराना.