Google Workspace की सदस्यता को अपडेट या रिन्यू करना

इस पेज पर, Google Workspace की सदस्यता रिन्यू करने का तरीका बताया गया है. इसके लिए, तरीके subscriptions.update() का इस्तेमाल करें. इस तरीके का इस्तेमाल करके, सदस्यता की समयसीमा खत्म होने का समय अपडेट किया जा सकता है. इसमें, सदस्यता को ज़्यादा से ज़्यादा समय के लिए रिन्यू करना भी शामिल है. इसके अलावा, टारगेट रिसॉर्स के बारे में सूचनाएं पाने के लिए, इवेंट टाइप की सूची को भी अपडेट किया जा सकता है.

Apps Script

  • Apps Script प्रोजेक्ट:
    • Apps Script से अपने-आप बनने वाले डिफ़ॉल्ट प्रोजेक्ट के बजाय, अपने Google Cloud प्रोजेक्ट का इस्तेमाल करें.
    • OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करने के लिए, आपने जो भी दायरे जोड़े हैं उन्हें अपने Apps Script प्रोजेक्ट में मौजूद appsscript.json फ़ाइल में भी जोड़ना होगा. उदाहरण के लिए, अगर आपने chat.messages दायरा तय किया है, तो यह जोड़ें:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages"
      ]
          
    • चालू करें Google Workspace Events ऐडवांस सेवा.

Python

  • Python 3.6 या इससे नया वर्शन
  • pip पैकेज मैनेजमेंट टूल
  • Python के लिए Google की क्लाइंट लाइब्रेरी का नया वर्शन. इन्हें इंस्टॉल या अपडेट करने के लिए, कमांड-लाइन इंटरफ़ेस में यह कमांड चलाएं:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      

Google Workspace की सदस्यता रिन्यू करना

इस सेक्शन में, Google Workspace Events API के subscriptions.update() तरीके का इस्तेमाल करके, किसी सदस्यता को उसकी ज़्यादा से ज़्यादा समयसीमा के लिए रिन्यू करने का तरीका बताया गया है. ज़्यादा से ज़्यादा समयसीमा तय करने के लिए, ttl रिसॉर्स के Subscription फ़ील्ड को 0 पर अपडेट करें.

ज़्यादा से ज़्यादा समयसीमा इस बात पर निर्भर करती है कि इवेंट पेलोड में कौनसे रिसॉर्स का डेटा शामिल है. समयसीमा के बारे में ज़्यादा जानने के लिए, Google Workspace इवेंट के लिए इवेंट डेटा देखें.

Google Workspace की सदस्यता रिन्यू करने के लिए:

Apps Script

  1. अपने Apps Script प्रोजेक्ट में, updateSubscription नाम की नई स्क्रिप्ट फ़ाइल बनाएं और उसमें यह कोड जोड़ें:

    function updateSubscription() {
      // The name of the subscription to update.
      const name = 'subscriptions/SUBSCRIPTION_ID';
    
      // Call the Workspace Events API using the advanced service.
      const response = WorkspaceEvents.Subscriptions.patch({
        ttl: '0s',
      }, name);
      console.log(response);
    }
    

    इनकी जगह ये डालें:

    • SUBSCRIPTION_ID: सदस्यता का आईडी. आईडी पाने के लिए, इनमें से कोई भी तरीका इस्तेमाल किया जा सकता है:
      • फ़ील्ड की वैल्यू.uid
      • name फ़ील्ड में दिखाए गए रिसॉर्स के नाम का आईडी. उदाहरण के लिए, अगर रिसॉर्स का नाम है subscriptions/subscription-123, तो subscription-123 का इस्तेमाल करें.
  2. Google Workspace की सदस्यता अपडेट करने के लिए, अपने Apps Script प्रोजेक्ट में updateSubscription फ़ंक्शन चलाएं.

Python

  1. अपनी वर्किंग डायरेक्ट्री में, update_subscription.py नाम की फ़ाइल बनाएं और उसमें यह कोड जोड़ें:

    """Update subscription."""
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = [SCOPES]
    
    # Authenticate with Google Workspace and get user authentication.
    flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
    CREDENTIALS = flow.run_local_server()
    
    # Call the Workspace Events API using the service endpoint.
    service = build(
        'workspaceevents',
        'v1',
        credentials=CREDENTIALS,
      )
    
    BODY = {
        'ttl': {'seconds': 0},
    }
    NAME = 'subscriptions/SUBSCRIPTION_ID'
    response = (
        service.subscriptions()
        .patch(name=NAME, updateMask='ttl', body=BODY)
        .execute()
    )
    print(response)
    

    इनकी जगह ये डालें:

    • SCOPES: एक या उससे ज़्यादा OAuth दायरे जो सदस्यता के लिए, हर इवेंट टाइप के साथ काम करते हों. इन्हें स्ट्रिंग के कलेक्शन के तौर पर फ़ॉर्मैट किया जाता है. एक से ज़्यादा दायरे दिखाने के लिए, उन्हें कॉमा लगाकर अलग करें. उदाहरण के लिए, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
    • SUBSCRIPTION_ID: सदस्यता का आईडी. आईडी पाने के लिए, इनमें से कोई भी तरीका इस्तेमाल किया जा सकता है:
      • फ़ील्ड की वैल्यू.uid
      • name फ़ील्ड में दिखाए गए रिसॉर्स के नाम का आईडी. उदाहरण के लिए, अगर रिसॉर्स का नाम है subscriptions/subscription-123, तो subscription-123 का इस्तेमाल करें.
  2. अपनी वर्किंग डायरेक्ट्री में, पक्का करें कि आपने OAuth क्लाइंट आईडी क्रेडेंशियल सेव किए हों और फ़ाइल का नाम credentials.json रखा हो. कोड का सैंपल, Google Workspace से पुष्टि करने और उपयोगकर्ता के क्रेडेंशियल पाने के लिए, इस JSON फ़ाइल का इस्तेमाल करता है. निर्देशों के लिए, देखें OAuth क्लाइंट आईडी क्रेडेंशियल बनाना.

  3. Google Workspace की सदस्यता अपडेट करने के लिए, अपने टर्मिनल में यह कमांड चलाएं:

    python3 update_subscription.py
Google Workspace Events API, ज़्यादा समय तक चलने वाली कार्रवाई दिखाता है. इसमें, Subscription रिसॉर्स का इंस्टेंस शामिल होता है.

अपडेट किए गए Subscription रिसॉर्स के बारे में जानकारी पाने के लिए, operations.get() तरीके का इस्तेमाल करें . साथ ही, subscriptions.update() के अनुरोध से मिले Operation रिसॉर्स की जानकारी दें. इसके अलावा, अगर आपने सदस्यता के पिछले वर्शन से Operation रिसॉर्स की जानकारी दी है, तो जवाब खाली होगा.

Google Chat ऐप्लिकेशन के तौर पर, सदस्यता अपडेट करना या रिन्यू करना

Chat ऐप्लिकेशन के तौर पर, Chat इवेंट की सदस्यता अपडेट या रिन्यू की जा सकती है. इसके लिए, उपयोगकर्ता के तौर पर सदस्यता लेने की ज़रूरत नहीं है. यह प्रोसेस, उपयोगकर्ता के तौर पर सदस्यता लेने की प्रोसेस जैसी ही होती है. हालांकि, इसमें यह अंतर होता है:

  1. उपयोगकर्ता की पुष्टि के बजाय, Chat ऐप्लिकेशन के तौर पर पुष्टि करें. इसके लिए, एडमिन की अनुमति एक बार लेनी होती है.

  2. अनुमति के ऐसे दायरे तय करें जिनसे Chat ऐप्लिकेशन, Chat इवेंट की सदस्यता ले सके. अनुमति के ये दायरे हमेशा chat.app से शुरू होते हैं. इनमें ये दायरे शामिल होते हैं:

    • https://www.googleapis.com/auth/chat.app.memberships: Chat स्पेस के सदस्यों से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.memberships.readonly: Chat स्पेस के सदस्यों से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.messages.readonly: Chat स्पेस के मैसेज से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.spaces: Chat स्पेस से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.spaces.readonly: Chat स्पेस से जुड़े इवेंट की सदस्यता लें.

Google Workspace Events API को कॉल करने वाली स्क्रिप्ट लिखना

नीचे दिया गया कोड का सैंपल, Chat ऐप्लिकेशन की Google Workspace की सदस्यता को अपडेट करता है:

Python

  """Update subscription."""

  from google.oauth2 import service_account
  from apiclient.discovery import build

  # Specify required scopes.
  SCOPES = [SCOPES]

  # Specify service account details.
  CREDENTIALS = (
      service_account.Credentials.from_service_account_file('credentials.json')
      .with_scopes(SCOPES)
  )

  # Call the Workspace Events API using the service endpoint.
  service = build(
      'workspaceevents',
      'v1beta',
      credentials=CREDENTIALS,
  )

  BODY = {
      'ttl': {'seconds': 0},
  }
  NAME = 'subscriptions/SUBSCRIPTION_ID'
  response = (
      service.subscriptions()
      .patch(name=NAME, updateMask='ttl', body=BODY)
      .execute()
  )
  print(response)

इनकी जगह ये डालें:

  • SCOPES: अनुमति के ऐसे दायरे तय करें जिनसे Chat ऐप्लिकेशन, Chat इवेंट की सदस्यता ले सके. अनुमति के ये दायरे हमेशा chat.app से शुरू होते हैं. इनमें ये दायरे शामिल होते हैं:

    • https://www.googleapis.com/auth/chat.app.memberships: Chat स्पेस के सदस्यों से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.memberships.readonly: Chat स्पेस के सदस्यों से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.messages.readonly: Chat स्पेस के मैसेज और रिएक्शन से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.spaces: Chat स्पेस से जुड़े इवेंट की सदस्यता लें.
    • https://www.googleapis.com/auth/chat.app.spaces.readonly: Chat स्पेस से जुड़े इवेंट की सदस्यता लें.
  • SUBSCRIPTION_ID: सदस्यता का आईडी. आईडी पाने के लिए, इनमें से कोई भी तरीका इस्तेमाल किया जा सकता है:

    • फ़ील्ड की वैल्यू.uid
    • name फ़ील्ड में दिखाए गए रिसॉर्स के नाम का आईडी. उदाहरण के लिए, अगर रिसॉर्स का नाम है subscriptions/subscription-123, तो subscription-123 का इस्तेमाल करें.