একটি Google Workspace সদস্যতা তৈরি করুন

অ্যাপস স্ক্রিপ্ট

• এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
  1. Google Cloud CLI ইনস্টল করুন।
  2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:

    gcloud init
    

• একটি অ্যাপস স্ক্রিপ্ট প্রকল্প:
  • অ্যাপস স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টের পরিবর্তে আপনার Google ক্লাউড প্রকল্প ব্যবহার করুন।
  • OAuth সম্মতি স্ক্রীন কনফিগার করার জন্য আপনি যে সমস্ত স্কোপ যোগ করেছেন তার জন্য, আপনাকে অবশ্যই আপনার Apps Script প্রোজেক্টের appsscript.json ফাইলে স্কোপ যোগ করতে হবে। উদাহরণস্বরূপ, আপনি যদি chat.messages স্কোপ নির্দিষ্ট করেন, তাহলে নিম্নলিখিত যোগ করুন:

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

  • Google Workspace Events উন্নত পরিষেবা চালু করুন ।

• বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
• সাবস্ক্রিপশনে প্রতিটি ইভেন্ট প্রকারের জন্য প্রমাণীকরণ এবং উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:
  • সাধারণত অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন হয়। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।
  • চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়ার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন৷ একটি চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়া ডেভেলপার প্রিভিউতে উপলব্ধ৷

পাইথন

• পাইথন 3.6 বা তার বেশি
• পাইপ প্যাকেজ ম্যানেজমেন্ট টুল
• পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:

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

• এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
  1. Google Cloud CLI ইনস্টল করুন।
  2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:

    gcloud init
    

• বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
• সাবস্ক্রিপশনে প্রতিটি ইভেন্ট প্রকারের জন্য প্রমাণীকরণ এবং উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:
  • সাধারণত অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন হয়। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।
  • চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়ার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন৷ একটি চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়া ডেভেলপার প্রিভিউতে উপলব্ধ৷

গুগল ক্লাউড কনসোল

Google ক্লাউড কনসোলে, আপনার অ্যাপের জন্য Google ক্লাউড প্রজেক্ট খুলুন এবং Google Workspace Events API এবং Pub/Sub API চালু করুন:

APIs সক্রিয় করুন

জিক্লাউড

1. আপনার কাজের ডিরেক্টরিতে, আপনার Google অ্যাকাউন্টে সাইন ইন করুন:

   gcloud auth login

2. আপনার অ্যাপ্লিকেশনের জন্য ক্লাউড প্রকল্পে আপনার প্রকল্প সেট করুন:

   gcloud config set project PROJECT_ID

   আপনার অ্যাপ্লিকেশানের জন্য ক্লাউড প্রকল্পের জন্য প্রকল্প ID দিয়ে PROJECT_ID প্রতিস্থাপন করুন।

3. Google Workspace Events API এবং Google Cloud Pub/Sub API চালু করুন:

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

গুগল ক্লাউড কনসোল

1. Google ক্লাউড কনসোলে, পাব/সাব পৃষ্ঠাতে যান:

   Google Cloud Pub/Sub-এ যান

   আপনার অ্যাপের জন্য ক্লাউড প্রকল্প নির্বাচন করা হয়েছে তা নিশ্চিত করুন।

2. add_box ক্লিক করুন বিষয় তৈরি করুন এবং নিম্নলিখিতগুলি করুন:

   1. আপনার বিষয়ের জন্য একটি নাম লিখুন, যেমন workspace-events-topic ।
   2. নির্বাচিত একটি ডিফল্ট সদস্যতা যোগ করুন ছেড়ে দিন। Pub/Sub এই ডিফল্ট সাবস্ক্রিপশনটিকে আপনার বিষয়ের নামের অনুরূপ নাম দেয়, যেমন workspace-events-topic-sub ।
   3. ঐচ্ছিক: আপনার বিষয়ের জন্য অতিরিক্ত বৈশিষ্ট্য আপডেট বা কনফিগার করুন।

3. তৈরি করুন ক্লিক করুন। আপনার সম্পূর্ণ বিষয়ের নামটি projects/ PROJECT_ID /topics/ TOPIC_ID হিসাবে ফর্ম্যাট করা হয়েছে। আপনি পরবর্তী ধাপে এই পুরো নামটি ব্যবহার করুন।

4. আপনার বিষয়ে পাব/সাব বার্তা প্রকাশের অ্যাক্সেস মঞ্জুর করুন:

   1. আপনার বিষয়ের পৃষ্ঠায়, পাশের প্যানেলে যান এবং অনুমতি ট্যাব খুলুন।
   2. অ্যাড প্রিন্সিপাল ক্লিক করুন।
   3. প্রিন্সিপাল যোগ করুন ফিল্ডে, Google Workspace অ্যাপ্লিকেশানের জন্য পরিষেবা অ্যাকাউন্ট যোগ করুন যা আপনার সাবস্ক্রিপশনে ইভেন্ট সরবরাহ করে:
      1. চ্যাট ইভেন্টের জন্য, chat-api-push@system.gserviceaccount.com ।
      2. বিকাশকারী পূর্বরূপ: : ড্রাইভ ইভেন্টের জন্য, drive-api-event-push@system.gserviceaccount.com ।
      3. Meet ইভেন্টের জন্য, meet-api-event-push@system.gserviceaccount.com ।
   4. ভূমিকা বরাদ্দ মেনুতে, Pub/Sub Publisher নির্বাচন করুন।
   5. সংরক্ষণ করুন ক্লিক করুন. আপনার বিষয়ের অনুমতি আপডেট করতে কয়েক মিনিট সময় লাগতে পারে।

জিক্লাউড

1. আপনার ক্লাউড প্রকল্পে, নিম্নলিখিত কমান্ডটি চালিয়ে একটি বিষয় তৈরি করুন:

   gcloud pubsub topics create TOPIC_ID

   আপনার বিষয়ের জন্য একটি অনন্য ID দিয়ে TOPIC_ID প্রতিস্থাপন করুন, যেমন workspace-events-topic ।

   আউটপুট পুরো বিষয়ের নাম প্রদর্শন করে, projects/ PROJECT_ID /topics/ TOPIC_ID হিসাবে ফর্ম্যাট করা হয়েছে। নামটি নোট করুন এবং নিশ্চিত করুন যে PROJECT_ID এর মানটি আপনার অ্যাপের জন্য ক্লাউড প্রকল্প আইডি। আপনি নিম্নলিখিত ধাপে বিষয়ের নাম ব্যবহার করুন এবং পরে 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-api-push@system.gserviceaccount.com ব্যবহার করুন।
     • বিকাশকারী পূর্বরূপ: : ড্রাইভ থেকে ইভেন্টগুলি পেতে, drive-api-event-push@system.gserviceaccount.com ব্যবহার করুন।
     • Meet থেকে ইভেন্ট পেতে, meet-api-event-push@system.gserviceaccount.com ব্যবহার করুন।

   আপনার বিষয়ের অনুমতি আপডেট করতে কয়েক মিনিট সময় লাগতে পারে।

3. বিষয়ের জন্য একটি পাব/সাবস্ক্রিপশন তৈরি করুন:

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • SUBSCRIPTION_NAME : আপনার সদস্যতার একটি নাম, যেমন workspace-events-subscription ।
   • TOPIC_NAME : আপনার বিষয়ের নাম যা আপনি পূর্ববর্তী ধাপে তৈরি করেছেন।

অ্যাপস স্ক্রিপ্ট

1. আপনার অ্যাপস স্ক্রিপ্ট প্রকল্পে, 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.googleapis.com/spaces/AAAABBBB ব্যবহার করুন।
   • EVENT_TYPES : এক বা একাধিক ইভেন্ট প্রকার যা আপনি লক্ষ্য সংস্থানে সদস্যতা নিতে চান৷ 'google.workspace.chat.message.v1.created' এর মতো স্ট্রিংগুলির অ্যারে হিসাবে ফর্ম্যাট করুন।
   • TOPIC_NAME : আপনার ক্লাউড প্রজেক্টে তৈরি করা পাব/সাব বিষয়ের পুরো নাম। projects/ PROJECT_ID /topics/ TOPIC_ID হিসাবে ফর্ম্যাট করা হয়েছে।

   • RESOURCE_DATA : একটি বুলিয়ান যা নির্দিষ্ট করে যে সাবস্ক্রিপশন পেলোডে রিসোর্স ডেটা অন্তর্ভুক্ত করে কিনা:

     • True : সমস্ত সম্পদ ডেটা অন্তর্ভুক্ত করে। কোন ক্ষেত্রগুলি অন্তর্ভুক্ত করা হয়েছে তা সীমিত করতে, fieldMask ক্ষেত্র যোগ করুন এবং পরিবর্তিত সংস্থানের জন্য কমপক্ষে একটি ক্ষেত্র নির্দিষ্ট করুন। রিসোর্স ডেটা সহ শুধুমাত্র চ্যাট রিসোর্স সাপোর্টের সদস্যতা।
     • False : রিসোর্স ডেটা বাদ দেয়।

2. Google Workspace সাবস্ক্রিপশন তৈরি করতে, আপনার Apps Script প্রোজেক্টে createSubscription ফাংশনটি চালান।

পাইথন

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.googleapis.com/spaces/AAAABBBB ব্যবহার করুন।
   • EVENT_TYPES : এক বা একাধিক ইভেন্ট প্রকার যা আপনি লক্ষ্য সংস্থানে সদস্যতা নিতে চান৷ 'google.workspace.chat.message.v1.created' এর মতো স্ট্রিংগুলির অ্যারে হিসাবে ফর্ম্যাট করুন।
   • TOPIC_NAME : আপনার ক্লাউড প্রজেক্টে তৈরি করা পাব/সাব বিষয়ের পুরো নাম। projects/ PROJECT_ID /topics/ TOPIC_ID হিসাবে ফর্ম্যাট করা হয়েছে।

   • RESOURCE_DATA : একটি বুলিয়ান যা নির্দিষ্ট করে যে সাবস্ক্রিপশন পেলোডে রিসোর্স ডেটা অন্তর্ভুক্ত করে কিনা:

     • True : সমস্ত সম্পদ ডেটা অন্তর্ভুক্ত করে। কোন ক্ষেত্রগুলি অন্তর্ভুক্ত করা হয়েছে তা সীমিত করতে, fieldMask ক্ষেত্র যোগ করুন এবং পরিবর্তিত সংস্থানের জন্য কমপক্ষে একটি ক্ষেত্র নির্দিষ্ট করুন। রিসোর্স ডেটা সহ শুধুমাত্র চ্যাট রিসোর্স সাপোর্টের সদস্যতা।
     • False : রিসোর্স ডেটা বাদ দেয়।

2. Google Workspace সাবস্ক্রিপশন তৈরি করতে, আপনার টার্মিনালে নিম্নলিখিতটি চালান:

   python3 create_subscription.py

গুগল ক্লাউড কনসোল

1. আপনার Google Workspace সাবস্ক্রিপশনের টার্গেট রিসোর্সে এক বা একাধিক ধরনের ইভেন্ট ট্রিগার করুন। উদাহরণস্বরূপ, আপনি যদি একটি চ্যাট স্পেসে নতুন বার্তাগুলিতে সদস্যতা নিয়ে থাকেন, তাহলে স্পেসটিতে একটি বার্তা পোস্ট করুন৷

2. Google ক্লাউড কনসোলে, পাব/সাব পৃষ্ঠাতে যান:

   পাব/সাব-এ যান

   আপনার অ্যাপের জন্য ক্লাউড প্রকল্প নির্বাচন করা হয়েছে তা নিশ্চিত করুন।

3. পাব/সাব মেনুতে, সাবস্ক্রিপশনে ক্লিক করুন।

4. সারণিতে, আপনার বিষয়ের জন্য পাব/সাবস্ক্রিপশন খুঁজুন এবং সদস্যতার নামে ক্লিক করুন।

5. বার্তা ট্যাবে ক্লিক করুন।

6. টানতে ক্লিক করুন। একটি ইভেন্ট একটি পাব/সাব বার্তা তৈরি করতে কয়েক মিনিট পর্যন্ত সময় নিতে পারে৷

জিক্লাউড

1. আপনার Google Workspace সাবস্ক্রিপশনের টার্গেট রিসোর্সে এক বা একাধিক ধরনের ইভেন্ট ট্রিগার করুন। উদাহরণস্বরূপ, আপনি যদি একটি চ্যাট স্পেসে নতুন বার্তাগুলিতে সদস্যতা নিয়ে থাকেন, তাহলে স্পেসে একটি বার্তা পোস্ট করুন৷

2. নিম্নলিখিত কমান্ড চালান:

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

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • PUBSUB_SUBSCRIPTION_NAME : আপনার পাব/সাবস্ক্রিপশনের পুরো নাম, projects/ PROJECT_ID /subscriptions/ SUBSCRIPTION_ID হিসাবে ফর্ম্যাট করা হয়েছে।
   • MESSAGE_COUNT : সর্বাধিক সংখ্যক পাব/সাব বার্তা আপনি টানতে চান৷

   একটি ইভেন্ট একটি পাব/সাব বার্তা তৈরি করতে কয়েক মিনিট পর্যন্ত সময় নিতে পারে৷

পাইথন

  """Create subscription."""

  from google.oauth2 import service_account
  from apiclient.discovery import build

  # Specify required scopes.
  SCOPES = ['https://www.googleapis.com/auth/chat.app.messages.readonly']

  # Specify service account details.
  CREDENTIALS = (
      service_account.Credentials.from_service_account_file('credentials.json')
      .with_scopes(SCOPES)
  )

  # The Google Workspace resource to monitor for events.
  TARGET_RESOURCE = '//chat.googleapis.com/spaces/SPACE_ID'

  # The types of events to receive.
  EVENT_TYPES = [
                  'google.workspace.chat.message.v1.created',
                  'google.workspace.chat.message.v1.updated',
                  'google.workspace.chat.message.v1.deleted',
                ]

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

  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)