ऐसा स्पेस सेट अप करना जिसमें शुरुआत में सदस्य शामिल हों

यह गाइड बताती है कि 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
    

Node.js

  • कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
  • Node.js 14 या उसके बाद का वर्शन
  • npm पैकेज मैनेजमेंट टूल
  • Google की नई क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में यह कमांड चलाएं:
    npm install @google-cloud/local-auth @googleapis/chat
    

स्पेस सेट अप करना

स्पेस सेट अप करने के लिए, अपने अनुरोध में यह जानकारी दें:

  • 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 API groups/123456789 नाम वाला ग्रुप लौटाता है, फिर सेट करता है groups/123456789 के लिए membership.groupMember.name. Google Groups को ग्रुप चैट या डायरेक्ट मैसेज में जोड़ा गया हो, लेकिन उसे सिर्फ़ नाम वाले स्पेस में जोड़ा गया हो.
  • कॉल करने वाले व्यक्ति और दूसरे व्यक्ति के बीच डायरेक्ट मैसेज भेजने के लिए उपयोगकर्ता, अपने अनुरोध में सदस्य की सदस्यता की जानकारी दें.
  • कॉल करने वाले उपयोगकर्ता और कॉल करने वाले ऐप्लिकेशन के बीच DM बनाने के लिए, Space.singleUserBotDm से true के लिए और किसी सदस्यता की जानकारी न दें. आप इस तरीके का इस्तेमाल सिर्फ़ कॉलिंग ऐप्लिकेशन के साथ DM सेट अप करने के लिए करें. कॉल के लिए इस्तेमाल की जाने वाली सेटिंग जोड़ने के लिए स्पेस के सदस्य के रूप में या दो मानव उपयोगकर्ताओं के बीच किसी मौजूदा DM के रूप में, देखें सदस्यता बनाएं.

इस उदाहरण में, नाम वाला स्पेस बनाया गया है और स्पेस में पैसे चुकाकर ली जाने वाली सदस्यताएं बनाई गई हैं एक ग्रुप और तीन लोगों के लिए काम करता है. इसमें, पुष्टि किए गए उपयोगकर्ता और दो उपयोगकर्ता शामिल हैं तय किए गए अन्य उपयोगकर्ता).

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_space_setup.py नाम की फ़ाइल बनाएं.
  2. 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()
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_space_setup.py
    

Node.js

  1. अपनी वर्किंग डायरेक्ट्री में, setup-space.js नाम की फ़ाइल बनाएं.
  2. 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);
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:

    node setup-space.js
    

नाम वाला चैट स्पेस, जिसमें एक ग्रुप और तीन उपयोगकर्ता शामिल हों. इनमें, की पुष्टि हो चुकी है.

स्पेस में जाने के लिए, उसके संसाधन आईडी का इस्तेमाल करके स्पेस का यूआरएल बनाएं. आपको Google Chat के जवाब में, name स्पेस से संसाधन आईडी मिल सकता है शरीर. उदाहरण के लिए, अगर आपके स्पेस का name spaces/1234567 है, तो आप को स्पेस में जोड़ने के लिए नीचे दिया गया यूआरएल इस्तेमाल करें: https://mail.google.com/chat/u/0/#chat/space/1234567.