Google Chat में मौजूद स्पेस इवेंट के बारे में जानकारी पाना

इस गाइड में बताया गया है कि Google Chat स्पेस के किसी इवेंट की जानकारी पाने के लिए, Google Chat API के SpaceEvent संसाधन पर get वाला तरीका कैसे इस्तेमाल किया जाता है.

SpaceEvent संसाधन, स्पेस या इसकी चाइल्ड संसाधनों (जैसे कि मैसेज, प्रतिक्रियाएं, और सदस्यताएं) में होने वाले बदलाव के बारे में बताता है. इस्तेमाल किए जा सकने वाले इवेंट टाइप के बारे में जानने के लिए, SpaceEvent संसाधन के रेफ़रंस दस्तावेज़ का eventType फ़ील्ड देखें.

अनुरोध किए जाने के समय से 28 दिन पहले तक, इवेंट के लिए अनुरोध किया जा सकता है. इवेंट में संसाधन का सबसे नया वर्शन होता है, जिसमें बदलाव हुआ है. उदाहरण के लिए, अगर किसी नए मैसेज के लिए किसी इवेंट का अनुरोध किया जाता है, लेकिन उस मैसेज को बाद में अपडेट किया जाता है, तो सर्वर, अपडेट किए गए Message रिसॉर्स को इवेंट पेलोड में दिखाता है.

इस तरीके को कॉल करने के लिए, आपको उपयोगकर्ता की पुष्टि करना होगा. इवेंट पाने के लिए, यह ज़रूरी है कि पुष्टि किया गया उपयोगकर्ता उस स्पेस का सदस्य हो जहां इवेंट हुआ था.

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

Python

  • Python 3.6 या इससे नया वर्शन
  • pip पैकेज मैनेजमेंट टूल
  • Python के लिए नई Google क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में नीचे दिया गया कमांड चलाएं:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    
  • ऐसा Google Cloud प्रोजेक्ट जिसमें Google Chat API चालू हो और उसे कॉन्फ़िगर किया गया हो. तरीका जानने के लिए, Google Chat ऐप्लिकेशन बनाना देखें.
  • Chat ऐप्लिकेशन के लिए अनुमति कॉन्फ़िगर की गई. स्पेस इवेंट पाने के लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. साथ ही, इसका स्कोप भी इवेंट टाइप के साथ काम करता हो. स्कोप चुनने के लिए, पुष्टि करने और अनुमति देने से जुड़ी खास जानकारी देखें.

किसी स्पेस इवेंट के बारे में जानकारी पाना

Google Chat में किसी SpaceEvent की जानकारी पाने के लिए, यह तरीका अपनाएं:

  • SpaceEvent संसाधन पर get वाला तरीका कॉल करें.
  • पाने के लिए SpaceEvent का name पास करें. Google Chat के SpaceEvent संसाधन से SpaceEvent नाम पाएं.
  • उपयोगकर्ता की पुष्टि करने की सुविधा की मदद से, अनुमति देने का ऐसा स्कोप बताएं जो आपके अनुरोध में इवेंट टाइप के साथ काम करता हो. सबसे सही तरीके के तौर पर, ऐसा स्कोप चुनें जो अब भी आपका ऐप्लिकेशन काम करता हो.

यहां उपयोगकर्ता की पुष्टि करने के लिए, SpaceEvent पाने का तरीका बताया गया है:

Python

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

    """Gets a SpaceEvent resource from the Chat API."""
    
    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 = ['SCOPE']
    
    # 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()
        .spaceEvents()
        .get(
            # The space event to get.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            #
            # Replace SPACE_EVENT with a SpaceEvent name.
            # Obtain the spaceEvent name from the SpaceEvent resource of
            # Chat API.
            name='spaces/SPACE/spaceEvents/SPACE_EVENT'
        )
        .execute()
    )
    
    # Prints details about the created spaceEvent.
    print(result)
    
  3. कोड में, इन्हें बदलें:

    • SCOPE: इवेंट टाइप के आधार पर, अनुमति का स्कोप. उदाहरण के लिए, अगर आपको नई सदस्यता के बारे में स्पेस इवेंट मिल रहा है, तो chat.memberships.readonly स्कोप का इस्तेमाल करें. इसे https://www.googleapis.com/auth/chat.memberships.readonly के तौर पर फ़ॉर्मैट किया गया है. आपके पास spaces.spaceEvents.list तरीके की मदद से, इवेंट टाइप की जानकारी पाने का विकल्प है. इस तरीके को इस्तेमाल करने का तरीका जानने के लिए, स्पेस के इवेंट की सूची बनाना लेख देखें.
    • SPACE: स्पेस का नाम, जिसे Chat API में spaces.list तरीके से या स्पेस के यूआरएल से पाया जा सकता है.
    • SPACE_EVENT: स्पेस इवेंट का नाम, जिसे spaces.spaceEvents.list तरीके से हासिल किया जा सकता है.
  4. अपनी वर्किंग डायरेक्ट्री में, यह सैंपल बनाएं और चलाएं:

    python3 chat_space_event_get.py
    

Chat API, इवेंट के बारे में जानकारी के साथ SpaceEvent का इंस्टेंस दिखाता है.