Google Workspace की सदस्यता बनाएं

Apps Script

• इस गाइड में Google Cloud CLI के निर्देशों का इस्तेमाल करने के लिए:
  1. Google Cloud CLI इंस्टॉल करें.
  2. gcloud सीएलआई को शुरू करने के लिए, यह कोड चलाएं:

    gcloud init
    

• बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट. Chat की सदस्यता के लिए, आपको अपने Cloud प्रोजेक्ट में Chat API भी चालू करना होगा. साथ ही, ऐप्लिकेशन का नाम, अवतार का यूआरएल, और ब्यौरा फ़ील्ड कॉन्फ़िगर करने होंगे. ज़्यादा जानकारी के लिए, Google Chat ऐप्लिकेशन बनाना लेख पढ़ें.
• इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. इसके लिए, ऐप्लिकेशन के लिए कॉन्फ़िगर की गई, 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 Cloud CLI के निर्देशों का इस्तेमाल करने के लिए:
  1. Google Cloud CLI इंस्टॉल करें.
  2. gcloud सीएलआई को शुरू करने के लिए, यह कोड चलाएं:

    gcloud init
    

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

Google Cloud कंसोल

Google Cloud Console में, अपने ऐप्लिकेशन के लिए Google Cloud प्रोजेक्ट खोलें. इसके बाद, Google Workspace Events API और Pub/Sub API को चालू करें:

एपीआई चालू करना

gcloud

1. अपनी वर्किंग डायरेक्ट्री में, अपने Google खाते में साइन इन करें:

   gcloud auth login

2. अपने प्रोजेक्ट को अपने ऐप्लिकेशन के Cloud प्रोजेक्ट पर सेट करें:

   gcloud config set project PROJECT_ID

   PROJECT_ID की जगह, अपने ऐप्लिकेशन के Cloud प्रोजेक्ट का प्रोजेक्ट आईडी डालें.

3. Google Workspace Events API और Google Cloud Pub/Sub API चालू करें:

   gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com

Google Cloud कंसोल

1. Google Cloud Console में, Pub/Sub पेज पर जाएं:

   Google Cloud Pub/Sub पर जाएं

   पक्का करें कि आपके ऐप्लिकेशन के लिए, Cloud प्रोजेक्ट चुना गया हो.

2. add_box विषय बनाएं पर क्लिक करें और यह तरीका अपनाएं:

   1. अपने विषय का नाम डालें. जैसे, workspace-events-topic.
   2. डिफ़ॉल्ट सदस्यता जोड़ें विकल्प को चुना रहने दें. Pub/Sub, इस डिफ़ॉल्ट सदस्यता का नाम आपके विषय के नाम जैसा रखता है. जैसे, workspace-events-topic-sub.
   3. ज़रूरी नहीं: अपने विषय के लिए, अन्य प्रॉपर्टी अपडेट करें या उन्हें कॉन्फ़िगर करें.

3. बनाएं पर क्लिक करें. आपके विषय का पूरा नाम, इस फ़ॉर्मैट में होता है: projects/PROJECT_ID/topics/TOPIC_ID. इस पूरे नाम का इस्तेमाल अगले चरण में किया जाता है.

4. अपने विषय पर Pub/Sub मैसेज पब्लिश करने का ऐक्सेस दें:

   1. अपने विषय के पेज पर, साइड पैनल में जाएं और अनुमतियां टैब खोलें.
   2. प्रिंसिपल जोड़ें पर क्लिक करें.
   3. मुख्य खाते जोड़ें फ़ील्ड में, Google Workspace ऐप्लिकेशन का वह सेवा खाता जोड़ें जो आपकी सदस्यता के लिए इवेंट डिलीवर करता है:
      1. चैट इवेंट के लिए, chat-api-push@system.gserviceaccount.com.
      2. डेवलपर प्रीव्यू: Drive इवेंट के लिए, drive-api-event-push@system.gserviceaccount.com.
      3. Meet इवेंट के लिए, meet-api-event-push@system.gserviceaccount.com.
   4. भूमिकाएं असाइन करें मेन्यू में, Pub/Sub Publisher चुनें.
   5. सेव करें पर क्लिक करें. आपके विषय के लिए अनुमतियां अपडेट होने में कुछ मिनट लग सकते हैं.

gcloud

1. अपने Cloud प्रोजेक्ट में, यह निर्देश चलाकर कोई विषय बनाएं:

   gcloud pubsub topics create TOPIC_ID

   TOPIC_ID की जगह अपने विषय के लिए कोई यूनीक आईडी डालें. जैसे, workspace-events-topic.

   आउटपुट में विषय का पूरा नाम दिखता है, जिसे इस तरह से फ़ॉर्मैट किया जाता है: projects/PROJECT_ID/topics/TOPIC_ID. नाम नोट करें. साथ ही, पक्का करें कि PROJECT_ID की वैल्यू, आपके ऐप्लिकेशन के लिए Cloud प्रोजेक्ट आईडी हो. अगले चरण में, आपको विषय के नाम का इस्तेमाल करना होगा. साथ ही, बाद में Google Workspace की सदस्यता बनाने के लिए भी इसका इस्तेमाल करना होगा.

2. अपने विषय पर मैसेज पब्लिश करने का ऐक्सेस दें:

   gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'

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

   • TOPIC_NAME: विषय का पूरा नाम, जो पिछले चरण का आउटपुट है. इसे projects/PROJECT_ID/topics/TOPIC_ID के तौर पर फ़ॉर्मैट किया गया है.

   • GOOGLE_WORKSPACE_APPLICATION: यह Google Workspace का वह ऐप्लिकेशन है जो आपकी सदस्यता के लिए इवेंट डिलीवर करेगा:

     • Chat से इवेंट पाने के लिए, chat-api-push@system.gserviceaccount.com का इस्तेमाल करें.
     • डेवलपर के लिए झलक: Drive से इवेंट पाने के लिए, drive-api-event-push@system.gserviceaccount.com का इस्तेमाल करें.
     • Meet से इवेंट पाने के लिए, meet-api-event-push@system.gserviceaccount.com का इस्तेमाल करें.

   आपके विषय के लिए अनुमतियां अपडेट होने में कुछ मिनट लग सकते हैं.

3. विषय के लिए Pub/Sub सदस्यता बनाएं:

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

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

   • SUBSCRIPTION_NAME: सदस्यता का नाम, जैसे कि workspace-events-subscription.
   • TOPIC_NAME: आपके विषय का वह नाम जो आपने पिछले चरण में बनाया था.

Apps Script

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

   function createSubscription() {
     // The Google Workspace resource to monitor for events.
     const targetResource = 'TARGET_RESOURCE';
   
     // The types of events to receive.
     const eventTypes = [EVENT_TYPES];
   
     // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
     const pubsubTopic = 'TOPIC_NAME';
   
     // Whether to include resource data or not.
     const resourceData = RESOURCE_DATA;
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.create({
       targetResource: targetResource,
       eventTypes: eventTypes,
       notificationEndpoint: {
         pubsubTopic: pubsubTopic,
       },
       payloadOptions: {
         includeResource: resourceData
       }
     });
     console.log(response);
   }
   

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

   • TARGET_RESOURCE: यह Google Workspace संसाधन है, जिसकी सदस्यता ली जा रही है. इसे संसाधन के पूरे नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, अगर आपको स्पेस आईडी AAAABBBB वाले Google Chat स्पेस की सदस्यता लेनी है, तो //chat.googleapis.com/spaces/AAAABBBB का इस्तेमाल करें.
   • EVENT_TYPES: टारगेट रिसॉर्स में सदस्यता लेने के लिए, एक या उससे ज़्यादा इवेंट टाइप. इसे स्ट्रिंग के ऐरे के तौर पर फ़ॉर्मैट करें. जैसे, 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: Pub/Sub विषय का पूरा नाम, जिसे आपने Cloud प्रोजेक्ट में बनाया है. इसे projects/PROJECT_ID/topics/TOPIC_ID के तौर पर फ़ॉर्मैट किया गया है.

   • RESOURCE_DATA: यह एक बूलियन है. इससे यह पता चलता है कि सदस्यता में पेलोड में मौजूद संसाधन का डेटा शामिल है या नहीं:

     • True: इसमें सभी संसाधन का डेटा शामिल होता है. यह तय करने के लिए कि कौनसे फ़ील्ड शामिल किए जाएं, fieldMask फ़ील्ड जोड़ें. साथ ही, बदले गए संसाधन के लिए कम से कम एक फ़ील्ड तय करें. सिर्फ़ Chat के संसाधनों की सदस्यताएं, संसाधन का डेटा शामिल करने की सुविधा के साथ काम करती हैं.
     • False: इसमें संसाधन का डेटा शामिल नहीं होता.

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

Python

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

   """Create 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()
   
   # The Google Workspace resource to monitor for events.
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   # The types of events to receive.
   EVENT_TYPES = [EVENT_TYPES]
   
   # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
   TOPIC = 'TOPIC_NAME'
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'target_resource': TARGET_RESOURCE,
       'event_types': EVENT_TYPES,
       'notification_endpoint': {'pubsub_topic': TOPIC},
       'payload_options': {'include_resource': RESOURCE_DATA},
   }
   response = service.subscriptions().create(body=BODY).execute()
   print(response)
   

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

   • SCOPES: एक या उससे ज़्यादा OAuth के दायरे, जो सदस्यता के लिए हर इवेंट टाइप के साथ काम करते हैं. इसे स्ट्रिंग के ऐरे के तौर पर फ़ॉर्मैट किया जाता है. एक से ज़्यादा स्कोप की सूची बनाने के लिए, उन्हें कॉमा लगाकर अलग करें. उदाहरण के लिए, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
   • TARGET_RESOURCE: यह Google Workspace संसाधन है, जिसकी सदस्यता ली जा रही है. इसे संसाधन के पूरे नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, अगर आपको स्पेस आईडी AAAABBBB वाले Google Chat स्पेस की सदस्यता लेनी है, तो //chat.googleapis.com/spaces/AAAABBBB का इस्तेमाल करें.
   • EVENT_TYPES: टारगेट रिसॉर्स में सदस्यता लेने के लिए, एक या उससे ज़्यादा इवेंट टाइप. इसे स्ट्रिंग के ऐरे के तौर पर फ़ॉर्मैट करें. जैसे, 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: Pub/Sub विषय का पूरा नाम, जिसे आपने Cloud प्रोजेक्ट में बनाया है. इसे projects/PROJECT_ID/topics/TOPIC_ID के तौर पर फ़ॉर्मैट किया गया है.

   • RESOURCE_DATA: यह एक बूलियन है. इससे यह पता चलता है कि सदस्यता में पेलोड में मौजूद संसाधन का डेटा शामिल है या नहीं:

     • True: इसमें सभी संसाधन का डेटा शामिल होता है. यह तय करने के लिए कि कौनसे फ़ील्ड शामिल किए जाएं, fieldMask फ़ील्ड जोड़ें. साथ ही, बदले गए संसाधन के लिए कम से कम एक फ़ील्ड तय करें. सिर्फ़ Chat के संसाधनों की सदस्यताएं, संसाधन का डेटा शामिल करने की सुविधा के साथ काम करती हैं.
     • False: इसमें संसाधन का डेटा शामिल नहीं होता.

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

   python3 create_subscription.py

Google Cloud कंसोल

1. Google Workspace की सदस्यता के टारगेट रिसोर्स में, एक या उससे ज़्यादा तरह के इवेंट ट्रिगर करें. उदाहरण के लिए, अगर आपने किसी Chat स्पेस में नए मैसेज पाने के लिए सदस्यता ली है, तो उस स्पेस में कोई मैसेज पोस्ट करें.

2. Google Cloud Console में, Pub/Sub पेज पर जाएं:

   Pub/Sub पर जाएं

   पक्का करें कि आपके ऐप्लिकेशन के लिए, Cloud प्रोजेक्ट चुना गया हो.

3. Pub/Sub मेन्यू में, सदस्यताएं पर क्लिक करें.

4. टेबल में, अपने विषय के लिए Pub/Sub सदस्यता ढूंढें और सदस्यता के नाम पर क्लिक करें.

5. मैसेज टैब पर क्लिक करें.

6. पुल करें पर क्लिक करें. किसी इवेंट के लिए Pub/Sub मैसेज जनरेट होने में कुछ मिनट लग सकते हैं.

gcloud

1. Google Workspace की सदस्यता के टारगेट रिसोर्स में, एक या उससे ज़्यादा तरह के इवेंट ट्रिगर करें. उदाहरण के लिए, अगर आपने किसी Chat स्पेस में नए मैसेज पाने के लिए सदस्यता ली है, तो उस स्पेस में कोई मैसेज पोस्ट करें.

2. यह कमांड चलाएं:

   gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack

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

   • PUBSUB_SUBSCRIPTION_NAME: आपकी Pub/Sub सदस्यता का पूरा नाम, जिसे projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID के तौर पर फ़ॉर्मैट किया गया है.
   • MESSAGE_COUNT: Pub/Sub के ज़्यादा से ज़्यादा मैसेज जिन्हें आपको पुल करना है.

   किसी इवेंट के लिए Pub/Sub मैसेज जनरेट होने में कुछ मिनट लग सकते हैं.