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

Apps Script

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

    gcloud init
    

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

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

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

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

Python

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

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

• इस गाइड में Google Cloud सीएलआई निर्देशों का इस्तेमाल करने के लिए:
  1. Google Cloud सीएलआई इंस्टॉल करें.
  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. अपने ऐप्लिकेशन के लिए क्लाउड प्रोजेक्ट पर अपना प्रोजेक्ट सेट करें:

   gcloud config set project PROJECT_ID
   

   PROJECT_ID को आपके ऐप्लिकेशन के क्लाउड प्रोजेक्ट का प्रोजेक्ट आईडी.

3. Google Workspace Events API और Google Cloud Pub/Sub चालू करना एपीआई:

   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 इवेंट के लिए, chat-api-push@system.gserviceaccount.com.
      2. 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 प्रोजेक्ट आईडी है आपके ऐप्लिकेशन के लिए. अगले चरण में, विषय के नाम का इस्तेमाल करके, बाद में सदस्यता लेने की ज़रूरत नहीं है.

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.
     • 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 का संसाधन जिसकी आपने सदस्यता ली है, जिसे इसके पूरे संसाधन नाम के तौर पर फ़ॉर्मैट किया गया हो. इसके लिए उदाहरण के लिए, स्पेस आईडी का इस्तेमाल करके Google Chat पर मौजूद किसी स्पेस की सदस्यता लेने के लिए AAAABBBB, //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 जोड़ें फ़ील्ड में बदलाव करें और बदले गए संसाधन के लिए कम से कम एक फ़ील्ड तय करें. सिर्फ़ सहायता के लिए, चैट से जुड़े संसाधनों की सदस्यता संसाधन डेटा.
     • 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('client_secrets.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 का संसाधन जिसकी आपने सदस्यता ली है, जिसे इसके पूरे संसाधन नाम के तौर पर फ़ॉर्मैट किया गया हो. इसके लिए उदाहरण के लिए, स्पेस आईडी का इस्तेमाल करके Google Chat पर मौजूद किसी स्पेस की सदस्यता लेने के लिए AAAABBBB, //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 जोड़ें फ़ील्ड में बदलाव करें और बदले गए संसाधन के लिए कम से कम एक फ़ील्ड तय करें. सिर्फ़ सहायता के लिए, चैट से जुड़े संसाधनों की सदस्यता संसाधन डेटा.
     • False: इसमें संसाधन का डेटा शामिल नहीं होता.

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

   python3 create_subscription.py
   

Google Cloud कंसोल

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

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

   Pub/Sub पर जाएं

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

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

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

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

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

gcloud

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

2. नीचे दिया गया निर्देश चलाएं:

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

   इन्हें बदलें:

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

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