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

Apps Script

• Google Workspace की सदस्यता. इसे बनाने के लिए, सदस्यता बनाना लेख पढ़ें.

• Apps Script प्रोजेक्ट:
  • Apps Script से अपने-आप बनाए गए डिफ़ॉल्ट प्रोजेक्ट के बजाय, अपने Google Cloud प्रोजेक्ट का इस्तेमाल करें.
  • आपने OAuth सहमति स्क्रीन को कॉन्फ़िगर करने के लिए जो भी स्कोप जोड़े हैं उन्हें आपको अपने Apps Script प्रोजेक्ट की appsscript.json फ़ाइल में भी जोड़ना होगा. उदाहरण के लिए, अगर आपने chat.messages स्कोप तय किया है, तो यह जानकारी जोड़ें:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages"
  ]
      

  • Google Workspace Events बेहतर सेवा को चालू करें.

• इसके लिए, पुष्टि करना और सदस्यता में हर इवेंट टाइप के लिए अनुमति का सही दायरा तय करना ज़रूरी है:

  • उपयोगकर्ता की पुष्टि करने के लिए, एक या उससे ज़्यादा ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करते हों. स्कोप की पहचान करने के लिए, इवेंट टाइप के हिसाब से स्कोप देखें.
  • Chat ऐप्लिकेशन के तौर पर किसी Chat इवेंट की सदस्यता लेने के लिए, ऐप्लिकेशन की पुष्टि करना और एडमिन से एक बार अनुमति लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर, Chat इवेंट की सदस्यता लेने की सुविधा डेवलपर के लिए झलक में उपलब्ध है.

Python

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

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• Google Workspace की सदस्यता. इसे बनाने के लिए, सदस्यता बनाना लेख पढ़ें.

• इसके लिए, पुष्टि करना और सदस्यता में हर इवेंट टाइप के लिए अनुमति का सही दायरा तय करना ज़रूरी है:

  • उपयोगकर्ता की पुष्टि करने के लिए, एक या उससे ज़्यादा ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करते हों. स्कोप की पहचान करने के लिए, इवेंट टाइप के हिसाब से स्कोप देखें.
  • Chat ऐप्लिकेशन के तौर पर किसी Chat इवेंट की सदस्यता लेने के लिए, ऐप्लिकेशन की पुष्टि करना और एडमिन से एक बार अनुमति लेना ज़रूरी है. Chat ऐप्लिकेशन के तौर पर, Chat इवेंट की सदस्यता लेने की सुविधा डेवलपर के लिए झलक में उपलब्ध है.

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

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,
      discoveryServiceUrl='https://workspaceevents.googleapis.com/$discovery/rest?version=v1beta&labels=DEVELOPER_PREVIEW&key=API_KEY',
  )

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