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

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

Apps Script

  • Apps Script प्रोजेक्ट:
    • Apps Script के ज़रिए अपने-आप बनाए गए डिफ़ॉल्ट प्रोजेक्ट के बजाय, अपने Google Cloud प्रोजेक्ट का इस्तेमाल करें.
    • OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करने के लिए जोड़े गए सभी स्कोप के लिए, आपको अपने Apps Script प्रोजेक्ट में appsscript.json फ़ाइल में भी स्कोप जोड़ने होंगे. उदाहरण के लिए:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • 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() तरीके का इस्तेमाल करके, सदस्यता को रिन्यू किया जाता है, ताकि वह तय समय से पहले खत्म न हो. ऐक्सेस खत्म होने का ज़्यादा से ज़्यादा समय तय करने के लिए, Subscription रिसॉर्स के ttl फ़ील्ड को 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('client_secrets.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 क्लाइंट आईडी के क्रेडेंशियल सेव किए हों और फ़ाइल को client_secrets.json नाम दिया हो. कोड सैंपल, Google Workspace से पुष्टि करने और उपयोगकर्ता के क्रेडेंशियल पाने के लिए, इस JSON फ़ाइल का इस्तेमाल करता है. निर्देशों के लिए, OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं लेख देखें.

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

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

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