Google Workspace की सदस्यता के बारे में जानकारी पाना

इस पेज पर, subscriptions.get() तरीके का इस्तेमाल करके, Google Workspace की सदस्यता के बारे में जानकारी पाने का तरीका बताया गया है.

उपयोगकर्ता की पुष्टि करने के साथ इस तरीके को कॉल करने पर, यह तरीका उपयोगकर्ता की अनुमति वाली सदस्यता की जानकारी दिखाता है. ऐप्लिकेशन की पुष्टि करने के लिए, इस तरीके का इस्तेमाल करने पर, ऐप्लिकेशन की किसी भी सदस्यता की जानकारी मिल सकती है.

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

Apps Script

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

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

  ध्यान दें: इस गाइड में दिए गए कोड सैंपल को चलाने के लिए, आपको उन OAuth क्लाइंट आईडी क्रेडेंशियल का इस्तेमाल करना होगा जिनका इस्तेमाल आपने सदस्यता बनाने के लिए किया था.

• 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 की सदस्यता. सदस्यता बनाने के लिए, सदस्यता बनाएं लेख पढ़ें.

• पुष्टि की ज़रूरत है:

  • उपयोगकर्ता की पुष्टि करने के लिए, ऐसे स्कोप की ज़रूरत होती है जो सदस्यता के लिए कम से कम एक इवेंट टाइप के साथ काम करता हो. किसी स्कोप की पहचान करने के लिए, इवेंट टाइप के हिसाब से स्कोप देखें.
    ध्यान दें: इस गाइड में दिए गए कोड सैंपल को चलाने के लिए, आपको उन OAuth क्लाइंट आईडी क्रेडेंशियल का इस्तेमाल करना होगा जिनका इस्तेमाल आपने सदस्यता बनाने के लिए किया था.
  • ऐप्लिकेशन की पुष्टि करने के लिए, chat.bot स्कोप की ज़रूरत होती है. यह सिर्फ़ Google Chat ऐप्लिकेशन के लिए है.

किसी उपयोगकर्ता की अनुमति वाली सदस्यता पाना

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

किसी उपयोगकर्ता से अनुमति लेकर सदस्यता लेने के लिए:

Apps Script

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

   function getSubscription() {
     // The name of the subscription to get.
     const name = 'subscriptions/SUBSCRIPTION_ID';
   
     // Call the Workspace Events API using the advanced service.
     const subscription = WorkspaceEvents.Subscriptions.get(name);
     console.log(subscription);
   }
   

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

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

2. सदस्यता पाने के लिए, अपने Apps Script प्रोजेक्ट में getSubscription फ़ंक्शन चलाएं.

Python

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

   """Get subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['SCOPE']
   
   # 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,
   )
   
   NAME = 'subscriptions/SUBSCRIPTION_ID'
   subscription = service.subscriptions().get(name=NAME).execute()
   print(subscription)
   

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

   • SCOPE: OAuth का ऐसा दायरा जो सदस्यता से कम से कम एक इवेंट टाइप के साथ काम करता हो. उदाहरण के लिए, अगर आपकी सदस्यता में इवेंट के तौर पर, अपडेट किया गया Chat स्पेस, https://www.googleapis.com/auth/chat.spaces.readonly शामिल है.
   • SUBSCRIPTION_ID: सदस्यता का आईडी. आईडी पाने के लिए, इनमें से किसी भी तरीके का इस्तेमाल किया जा सकता है:
     • uid फ़ील्ड की वैल्यू.
     • name फ़ील्ड में दिखाए गए संसाधन के नाम का आईडी. उदाहरण के लिए, अगर संसाधन का नाम subscriptions/subscription-123 है, तो subscription-123 का इस्तेमाल करें.

2. पक्का करें कि आपने अपनी वर्किंग डायरेक्ट्री में, OAuth क्लाइंट आईडी के क्रेडेंशियल सेव किए हों और फ़ाइल को client_secrets.json नाम दिया हो. कोड सैंपल, Google Workspace से पुष्टि करने और उपयोगकर्ता के क्रेडेंशियल पाने के लिए, इस JSON फ़ाइल का इस्तेमाल करता है. निर्देशों के लिए, OAuth क्लाइंट आईडी के क्रेडेंशियल बनाएं लेख देखें.

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

   python3 get_subscription.py

मिलते-जुलते विषय

• सदस्यता को अपडेट या रिन्यू करना
• गड़बड़ियां ठीक करना और सदस्यता फिर से चालू करना
• सदस्यता मिटाना
• सदस्यताओं की सूची
• सदस्यता बनाना