स्पेस की सूची बनाएं

इस गाइड में, इसके Space संसाधन पर list संसाधन के इस्तेमाल का तरीका बताया गया है स्पेस की सूची बनाने के लिए Google Chat API का इस्तेमाल करें. स्पेस लिस्टिंग से पेज पर नंबर वाला और फ़िल्टर किया जा सकने वाला टेक्स्ट दिखता है स्पेस की सूची.

कॉन्टेंट बनाने Space संसाधन यह ऐसी जगह दिखाता है जहां लोग और Chat ऐप्लिकेशन मैसेज भेज सकते हैं, और साथ मिलकर काम करने की सुविधा मिलती है. स्पेस कई तरह के होते हैं:

  • डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या एक उपयोगकर्ता के बीच होने वाली बातचीत होते हैं एक चैट ऐप्लिकेशन.
  • ग्रुप चैट में, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन.
  • नाम वाले स्पेस वे स्थायी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और सहयोग करना होगा.

स्पेस की सूची, इनके साथ दी जाती है ऐप्लिकेशन की पुष्टि करना यह उन स्पेस की सूची बनाता है जिनका ऐक्सेस Chat ऐप्लिकेशन के पास है. सूची स्पेस उपयोगकर्ता की पुष्टि करना उन स्पेस की सूची बनाता है जिनका ऐक्सेस पुष्टि किए गए उपयोगकर्ता के पास है.

ज़रूरी शर्तें

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
    

उपयोगकर्ता की पुष्टि करने वाले स्पेस की सूची बनाएं

Google Chat में स्पेस शामिल करने के लिए, इन्हें अपने अनुरोध:

यहां दिए गए उदाहरण में, स्पेस और ग्रुप चैट के नाम की सूची दी गई है. इसमें डायरेक्ट स्पेस शामिल नहीं हैं संदेश, जिन्हें फ़िल्टर करके बाहर निकाल दिया जाता है) प्रमाणित उपयोगकर्ता को दिखाई देते हैं:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_space_list.py नाम की फ़ाइल बनाएं.
  2. chat_space_list.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.readonly"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then lists named spaces and group chats (but not direct messages)
        visible to the authenticated user.
        '''
    
        # 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().list(
    
              # An optional filter that returns named spaces or unnamed group chats,
              # but not direct messages (DMs).
              filter='spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'
    
          ).execute()
    
        # Prints the returned list of spaces.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_space_list.py
    

Node.js

  1. अपनी वर्किंग डायरेक्ट्री में, list-spaces.js नाम की फ़ाइल बनाएं.
  2. list-spaces.js में यह कोड शामिल करें:

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * List Chat spaces.
    * @return {!Promise<!Object>}
    */
    async function listSpaces() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.spaces.readonly',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.list({
        filter: 'spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'
      });
    }
    
    listSpaces().then(console.log);
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:

    node list-spaces.js
    

Chat API, नाम वाले स्पेस और ग्रुप चैट का पेज नंबर वाला अरे.

ऐप्लिकेशन की पुष्टि करने की सुविधा वाले स्पेस की सूची बनाना

Google Chat में स्पेस शामिल करने के लिए, इन्हें अपने अनुरोध:

यहां दिए गए उदाहरण में, स्पेस और ग्रुप चैट के नाम की सूची दी गई है. इसमें डायरेक्ट स्पेस शामिल नहीं हैं मैसेज) दिखाई देंगे:

Python

  1. अपनी वर्किंग डायरेक्ट्री में, chat_space_list_app.py नाम की फ़ाइल बनाएं.
  2. chat_space_list_app.py में यह कोड शामिल करें:

    from google.oauth2 import service_account
    from apiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = ['https://www.googleapis.com/auth/chat.bot']
    
    # Specify service account details.
    CREDENTIALS = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )
    
    # Build the URI and authenticate with the service account.
    chat = build('chat', 'v1', credentials=CREDENTIALS)
    
    # Use the service endpoint to call Chat API.
    result = chat.spaces().list(
    
            # An optional filter that returns named spaces or unnamed
            # group chats, but not direct messages (DMs).
            filter='spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'
    
        ).execute()
    
    print(result)
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_space_list_app.py
    

Node.js

  1. अपनी वर्किंग डायरेक्ट्री में, app-list-spaces.js नाम की फ़ाइल बनाएं.
  2. app-list-spaces.js में यह कोड शामिल करें:

    const chat = require('@googleapis/chat');
    
    /**
    * List Chat spaces.
    * @return {!Promise<!Object>}
    */
    async function listSpaces() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.bot',
      ];
    
      const auth = new chat.auth.GoogleAuth({
        scopes,
        keyFilename: 'credentials.json',
      });
    
      const authClient = await auth.getClient();
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.list({
        filter: 'spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'
      });
    }
    
    listSpaces().then(console.log);
    
  3. अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:

    node app-list-spaces.js
    

Chat API, स्पेस का पेजों वाला कलेक्शन दिखाता है.

पेजों को अपनी ज़रूरत के मुताबिक बनाएं या सूची को फ़िल्टर करें

Google Chat में स्पेस की सूची बनाने के लिए, नीचे दी गई जानकारी को पास करें. हालांकि, यह ज़रूरी नहीं है इन क्वेरी पैरामीटर का इस्तेमाल करके, सूची में शामिल स्पेस को पसंद के मुताबिक क्रम में लगाएं या उन्हें फ़िल्टर करें:

  • pageSize: लौटाए जाने वाले स्पेस की ज़्यादा से ज़्यादा संख्या. सेवा वापस मिल सकती है इस मान से कम. अगर कोई वैल्यू न दी गई हो, तो ज़्यादा से ज़्यादा 100 स्पेस लौटाए जाते हैं. कॉन्टेंट बनाने ज़्यादा से ज़्यादा वैल्यू 1,000 है; अगर वैल्यू 1,000 से ज़्यादा है, तो 1,000 रुपये तक होगी.
  • pageToken: पेज टोकन, जो पिछले स्पेस स्पेस कॉल से मिला है. अगले पेज को वापस पाने के लिए, यह टोकन उपलब्ध कराएं. पेज पर नंबर डालते समय, फ़िल्टर वैल्यू उस कॉल से मैच होनी चाहिए जिससे पेज टोकन मिला है. पासिंग अलग-अलग वैल्यू देने से अनचाहे नतीजे मिल सकते हैं.
  • filter: क्वेरी फ़िल्टर. इस्तेमाल की जा सकने वाली क्वेरी की जानकारी के लिए देखें spaces.list तरीका.