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

Google Workspace রিসোর্সে সাবস্ক্রিপশন তৈরি করতে কীভাবে Google Workspace Events API ব্যবহার করতে হয় এই পৃষ্ঠাটি ব্যাখ্যা করে। একটি Google Workspace সাবস্ক্রিপশন আপনার অ্যাপকে Google Workspace ইভেন্ট সম্পর্কে তথ্য পেতে দেয়, যা Google Workspace রিসোর্সে পরিবর্তনের প্রতিনিধিত্ব করে। Google Workspace Events API সমর্থন করে কোন রিসোর্স এবং ইভেন্টের ধরন সম্পর্কে জানতে, Google Workspace Events API ওভারভিউ দেখুন।

এই পৃষ্ঠায় Google Workspace সাবস্ক্রিপশন তৈরি করার জন্য নিম্নলিখিত ধাপগুলি অন্তর্ভুক্ত রয়েছে:

  1. আপনার পরিবেশ সেট আপ করুন।
  2. একটি Google ক্লাউড পাব/সাব বিষয় তৈরি করুন এবং সদস্যতা নিন। Google Workspace ইভেন্টগুলি পেতে আপনি এই বিষয়টিকে এন্ডপয়েন্ট হিসেবে ব্যবহার করেন।
  3. Subscription রিসোর্সে Google Workspace Events API-এর create() পদ্ধতিতে কল করুন।
  4. আপনার সাবস্ক্রাইব করা ইভেন্টগুলি আপনার পাব/সাব টপিক পাচ্ছে কিনা তা নিশ্চিত করতে আপনার Google Workspace সাবস্ক্রিপশন পরীক্ষা করুন।
  5. ঐচ্ছিকভাবে, কীভাবে আপনার অ্যাপের জন্য ইভেন্টগুলিকে একটি এন্ডপয়েন্টে ঠেলে দেওয়া যায় তা কনফিগার করুন, যাতে আপনার অ্যাপ ইভেন্টটি প্রক্রিয়া করতে পারে এবং প্রয়োজনে পদক্ষেপ নিতে পারে।

পূর্বশর্ত

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

  • এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
    1. Google Cloud CLI ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:
    3.   gcloud init
        
  • বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
  • অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।
  • একটি Apps স্ক্রিপ্ট প্রকল্প:
    • অ্যাপস স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টের পরিবর্তে আপনার Google ক্লাউড প্রকল্প ব্যবহার করুন।
    • OAuth সম্মতি স্ক্রীন কনফিগার করার জন্য আপনি যেকোন স্কোপ যোগ করেছেন, আপনাকে অবশ্যই আপনার Apps Script প্রোজেক্টের appsscript.json ফাইলে স্কোপ যোগ করতে হবে। যেমন:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Google Workspace Events উন্নত পরিষেবা চালু করুন

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পাইপ প্যাকেজ ম্যানেজমেন্ট টুল
  • পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
    1. Google Cloud CLI ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:
    3.   gcloud init
        
  • বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
  • অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।

আপনার পরিবেশ সেট আপ করুন

Google Workspace সাবস্ক্রিপশন তৈরি করার আগে কীভাবে আপনার পরিবেশ সেট-আপ করবেন তা নিম্নলিখিত বিভাগে ব্যাখ্যা করা হয়েছে।

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

Google API ব্যবহার করার আগে, আপনাকে একটি Google ক্লাউড প্রকল্পে সেগুলি চালু করতে হবে। আপনি একটি একক Google ক্লাউড প্রকল্পে এক বা একাধিক API চালু করতে পারেন৷

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

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

OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন

কিভাবে একটি OAuth ক্লায়েন্ট আইডি তৈরি করতে হয় সে সম্পর্কে নির্দিষ্ট নির্দেশাবলীর জন্য আপনার আবেদনের ধরন বেছে নিন:

ওয়েব অ্যাপ্লিকেশন

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ওয়েব অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. আপনার অ্যাপের সাথে সম্পর্কিত অনুমোদিত URI যোগ করুন:
    • ক্লায়েন্ট-সাইড অ্যাপস (জাভাস্ক্রিপ্ট) -অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন-এর অধীনে, URI যোগ করুন-এ ক্লিক করুন। তারপর, ব্রাউজার অনুরোধের জন্য ব্যবহার করার জন্য একটি URI লিখুন। এটি সেই ডোমেনগুলিকে চিহ্নিত করে যেগুলি থেকে আপনার অ্যাপ্লিকেশনটি OAuth 2.0 সার্ভারে API অনুরোধ পাঠাতে পারে৷
    • সার্ভার-সাইড অ্যাপস (জাভা, পাইথন, এবং আরও) -অথরাইজড রিডাইরেক্ট ইউআরআই-এর অধীনে, ইউআরআই যোগ করুন ক্লিক করুন। তারপর, একটি এন্ডপয়েন্ট URI লিখুন যেখানে OAuth 2.0 সার্ভার প্রতিক্রিয়া পাঠাতে পারে।
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্রটি OAuth 2.0 ক্লায়েন্ট আইডির অধীনে প্রদর্শিত হয়।

    ক্লায়েন্ট আইডি নোট করুন। ক্লায়েন্ট গোপনীয়তা ওয়েব অ্যাপ্লিকেশনের জন্য ব্যবহার করা হয় না.

অ্যান্ড্রয়েড

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > অ্যান্ড্রয়েড ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "প্যাকেজের নাম" ক্ষেত্রে, আপনার AndroidManifest.xml ফাইল থেকে প্যাকেজের নাম লিখুন।
  6. "SHA-1 শংসাপত্রের ফিঙ্গারপ্রিন্ট" ক্ষেত্রে, আপনার তৈরি করা SHA-1 শংসাপত্রের আঙ্গুলের ছাপ লিখুন৷
  7. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

iOS

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > iOS এ ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "বান্ডেল আইডি" ফিল্ডে, অ্যাপের Info.plist ফাইলে তালিকাভুক্ত বান্ডিল শনাক্তকারী লিখুন।
  6. ঐচ্ছিক: অ্যাপল অ্যাপ স্টোরে আপনার অ্যাপটি দেখা গেলে অ্যাপ স্টোর আইডি লিখুন।
  7. ঐচ্ছিক: "টিম আইডি" ফিল্ডে, অ্যাপল দ্বারা তৈরি এবং আপনার দলকে বরাদ্দ করা অনন্য 10-অক্ষরের স্ট্রিংটি লিখুন।
  8. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ক্রোম অ্যাপ

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > Chrome এক্সটেনশন ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "আইটেম আইডি" ক্ষেত্রে, আপনার অ্যাপের অনন্য 32-অক্ষরের আইডি স্ট্রিং লিখুন। আপনি আপনার অ্যাপের Chrome ওয়েব স্টোর URL এবং Chrome ওয়েব স্টোর ডেভেলপার ড্যাশবোর্ডে এই আইডি মানটি খুঁজে পেতে পারেন৷
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ডেস্কটপ অ্যাপ

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. Application type > Desktop app এ ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

টিভি এবং সীমিত ইনপুট ডিভাইস

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > টিভি এবং সীমিত ইনপুট ডিভাইসে ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (UWP)

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. Application type > Universal Windows Platform (UWP) এ ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "স্টোর আইডি" ক্ষেত্রে, আপনার অ্যাপের অনন্য, 12-অক্ষরের Microsoft স্টোর আইডি মান লিখুন। আপনি আপনার অ্যাপের Microsoft স্টোর URL এবং অংশীদার কেন্দ্রে এই আইডিটি খুঁজে পেতে পারেন।
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ক্লায়েন্ট গোপন JSON ফাইল ডাউনলোড করুন

ক্লায়েন্ট সিক্রেট ফাইল হল OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলির একটি JSON উপস্থাপনা যা আপনার অ্যাপ শংসাপত্রগুলি প্রদান করার সময় উল্লেখ করতে পারে।

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. OAuth 2.0 ক্লায়েন্ট আইডির অধীনে, আপনার তৈরি করা ক্লায়েন্ট আইডিটিতে ক্লিক করুন।

  3. JSON ডাউনলোড এ ক্লিক করুন।

  4. ফাইলটিকে client_secrets.json হিসাবে সংরক্ষণ করুন।

একটি পাব/সাব বিষয় তৈরি করুন এবং সদস্যতা নিন

এই বিভাগে, আপনি একটি পাব/সাব বিষয় এবং বিষয়ের সদস্যতা তৈরি করেন। আপনার পাব/সাব টপিক নোটিফিকেশন এন্ডপয়েন্ট হিসেবে কাজ করে যেখানে আপনার Google Workspace সাবস্ক্রিপশন ইভেন্ট গ্রহণ করে।

পাব/সাব বিষয়গুলি তৈরি এবং পরিচালনা করার বিষয়ে আরও জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

একটি পাব/সাব বিষয় তৈরি করতে এবং সদস্যতা নিতে:

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

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

    Google Cloud Pub/Sub-এ যান

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

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

    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. Meet ইভেন্টের জন্য, meet-api-event-push@system.gserviceaccount.com
    4. ভূমিকা বরাদ্দ মেনুতে, Pub/Sub Publisher নির্বাচন করুন।
    5. Save এ ক্লিক করুন। আপনার বিষয়ের অনুমতি আপডেট করতে কয়েক মিনিট সময় লাগতে পারে।

জিক্লাউড

  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 ব্যবহার করুন।
      • 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 : আপনার বিষয়ের নাম যা আপনি পূর্ববর্তী ধাপে তৈরি করেছেন।

Google Workspace রিসোর্সে সাবস্ক্রাইব করুন

এই বিভাগে, আপনি Google Workspace রিসোর্সে সাবস্ক্রাইব করেছেন যেটি ইভেন্টের জন্য আপনি নিরীক্ষণ করতে চান।

টার্গেট রিসোর্স বেছে নিন এবং চিহ্নিত করুন

Google Workspace সাবস্ক্রিপশনে, টার্গেট রিসোর্স হল Google Workspace রিসোর্স যা আপনি ইভেন্টের জন্য পর্যবেক্ষণ করেন। টার্গেট রিসোর্সটি সাবস্ক্রিপশনের targetResource ফিল্ডে উপস্থাপন করা হয়, সম্পূর্ণ রিসোর্স নাম ব্যবহার করে ফরম্যাট করা হয়। উদাহরণস্বরূপ, একটি সাবস্ক্রিপশনের জন্য যা Google চ্যাট স্পেস ( spaces/AAAABBBBBBB ) নিরীক্ষণ করে, targetResource এর মান হল //chat.googleapis.com/spaces/AAAABBBBBBB

আপনি সাবস্ক্রিপশন তৈরি করার আগে, লক্ষ্য সম্পদ শনাক্ত এবং বিন্যাস কিভাবে শিখতে নিম্নলিখিত বিভাগ ব্যবহার করুন.

চ্যাটের জন্য একটি টার্গেট রিসোর্স শনাক্ত করুন

লক্ষ্য সম্পদ বিন্যাস সীমাবদ্ধতা
স্থান

//chat.googleapis.com/spaces/ SPACE

যেখানে SPACE হল চ্যাট এপিআই space রিসোর্সের রিসোর্সের নামের আইডি। আপনি স্পেসের URL থেকে অথবা spaces.list() পদ্ধতি ব্যবহার করে আইডি পেতে পারেন।

যে চ্যাট ব্যবহারকারী সাবস্ক্রিপশন অনুমোদন করেন তাকে অবশ্যই তাদের Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে স্পেস-এর সদস্য হতে হবে।
একজন ব্যবহারকারীর জন্য সমস্ত স্থান

//chat.googleapis.com/spaces/-

সাবস্ক্রিপশন শুধুমাত্র সেই জায়গাগুলির জন্য ইভেন্ট গ্রহণ করে যেখানে ব্যবহারকারী তার Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে সদস্য।
ব্যবহারকারী

//cloudidentity.googleapis.com/users/ USER

যেখানে USER হল Chat API user সম্পদের রিসোর্স নামের আইডি। বিশদ বিবরণের জন্য, Google চ্যাট ব্যবহারকারীদের সনাক্ত করুন এবং নির্দিষ্ট করুন দেখুন।

সাবস্ক্রিপশন শুধুমাত্র সেই ব্যবহারকারীর সম্পর্কে ইভেন্টগুলি গ্রহণ করে যে সদস্যতা অনুমোদন করেছে৷ একজন ব্যবহারকারী অন্য ব্যবহারকারীদের পক্ষে সাবস্ক্রিপশন অনুমোদন করতে পারে না।

Meet-এর জন্য একটি টার্গেট রিসোর্স শনাক্ত করুন

লক্ষ্য সম্পদ বিন্যাস সীমাবদ্ধতা (যদি প্রযোজ্য হয়)
মিটিং স্পেস //meet.googleapis.com/spaces/ SPACE

যেখানে SPACE হল Meet REST API space রিসোর্সের রিসোর্সের নামের আইডি। বিস্তারিত জানার জন্য, দেখুন কিভাবে Meet একটি মিটিং স্পেস সনাক্ত করে

ব্যবহারকারী //cloudidentity.googleapis.com/users/ USER

যেখানে USER হল Meet REST API participant রিসোর্সের signedinUser.user ক্ষেত্রের আইডি। বিস্তারিত জানার জন্য, অংশগ্রহণকারীদের সাথে কাজ দেখুন।

সদস্যতা মিটিং স্পেস সম্পর্কে ইভেন্টগুলি গ্রহণ করে যেখানে ব্যবহারকারী নিম্নলিখিতগুলির মধ্যে একটি:

  • সভাস্থলের মালিক।
  • মিটিং স্পেসে একজন অংশগ্রহণকারী।
  • মিটিং স্পেসের সাথে যুক্ত Google ক্যালেন্ডার ইভেন্টের আয়োজক

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

সাবস্ক্রিপশন তৈরি করতে, আপনি Subscription রিসোর্স তৈরি করতে Google Workspace Events API-এর subscriptions.create() পদ্ধতি ব্যবহার করেন। আপনি নিম্নলিখিত ক্ষেত্র নির্দিষ্ট করুন:

  • targetResource : একটি Google Workspace যা আপনি পূর্ববর্তী বিভাগে চিহ্নিত করেছেন, এটির সম্পূর্ণ সম্পদের নাম ব্যবহার করে ফর্ম্যাট করা হয়েছে।
  • eventTypes : এক বা একাধিক ইভেন্ট প্রকারের একটি অ্যারে যা আপনি সম্পদ সম্পর্কে পেতে চান। উদাহরণস্বরূপ, যদি আপনার অ্যাপের শুধুমাত্র একটি চ্যাট স্পেসে পোস্ট করা নতুন বার্তাগুলি সম্পর্কে জানতে হয়, তাহলে আপনার অ্যাপ তৈরি করা বার্তাগুলি সম্পর্কে ইভেন্টগুলিতে সদস্যতা নিতে পারে৷
  • notificationEndpoint : একটি বিজ্ঞপ্তি এন্ডপয়েন্ট যেখানে আপনার Google Workspace সাবস্ক্রিপশন ইভেন্ট ডেলিভার করে। আপনি আগের বিভাগে তৈরি করা পাব/সাব বিষয় ব্যবহার করেন।
  • payloadOptions : ইভেন্ট পেলোডে কতটা রিসোর্স ডেটা অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করার বিকল্প। এই কনফিগারেশন আপনার সদস্যতার মেয়াদ শেষ হওয়ার সময়কে প্রভাবিত করে। আরও জানতে, ইভেন্ট ডেটা দেখুন।

একটি Google Workspace সদস্যতা তৈরি করতে:

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

  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('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 রিসোর্সটিতে সদস্যতা নিচ্ছেন, সেটির পুরো রিসোর্স নাম হিসেবে ফর্ম্যাট করা হয়েছে। উদাহরণস্বরূপ, স্পেস আইডি 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

Google Workspace ইভেন্ট এপিআই আপনার তৈরি করা Subscription রিসোর্সের উদাহরণ ধারণ করে এমন একটি দীর্ঘ-চলমান অপারেশন প্রদান করে।

আপনার Google Workspace সদস্যতা পরীক্ষা করুন

আপনি Google Workspace ইভেন্টগুলি পাচ্ছেন তা পরীক্ষা করতে, আপনি একটি ইভেন্ট ট্রিগার করতে পারেন এবং Pub/Sub-এর সাবস্ক্রিপশনে মেসেজ টানতে পারেন।

আপনার Google Workspace সদস্যতা পরীক্ষা করতে:

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

  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/ SUBSCRIPTION_ID /subscriptions/ SUBSCRIPTION_ID হিসাবে ফর্ম্যাট করা হয়েছে।
    • MESSAGE_COUNT : সর্বাধিক সংখ্যক পাব/সাব বার্তা আপনি টানতে চান৷

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

আপনার ট্রিগার করা প্রতিটি Google Workspace ইভেন্টের জন্য আপনার পাব/সাবস্ক্রিপশনে একটি মেসেজ পাঠানো হয় যাতে ইভেন্টটি থাকে। বিশদ বিবরণের জন্য, Google ক্লাউড পাব/সাব বার্তা হিসাবে ইভেন্ট গ্রহণ করা দেখুন।

আপনার অ্যাপ কীভাবে ইভেন্টগুলি গ্রহণ করে তা কনফিগার করুন

আপনার তৈরি করা পাব/সাবস্ক্রিপশনটি পুল-ভিত্তিক। আপনি আপনার পাব/সাবস্ক্রিপশনটি পরীক্ষা করার পরে, আপনার অ্যাপ কীভাবে ইভেন্টগুলি গ্রহণ করে তা পরিবর্তন করতে আপনি বিতরণের ধরন আপডেট করতে পারেন। উদাহরণস্বরূপ, আপনি একটি পুশ ডেলিভারি টাইপের পাব/সাবস্ক্রিপশন কনফিগার করতে পারেন, যাতে আপনার অ্যাপ সরাসরি একটি অ্যাপ এন্ডপয়েন্টে ইভেন্টগুলি গ্রহণ করতে পারে।

একটি পাব/সাবস্ক্রিপশন কনফিগার করার বিষয়ে জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

,

Google Workspace রিসোর্সে সাবস্ক্রিপশন তৈরি করতে কীভাবে Google Workspace Events API ব্যবহার করতে হয় এই পৃষ্ঠাটি ব্যাখ্যা করে। একটি Google Workspace সাবস্ক্রিপশন আপনার অ্যাপকে Google Workspace ইভেন্ট সম্পর্কে তথ্য পেতে দেয়, যা Google Workspace রিসোর্সে পরিবর্তনের প্রতিনিধিত্ব করে। Google Workspace Events API সমর্থন করে কোন রিসোর্স এবং ইভেন্টের ধরন সম্পর্কে জানতে, Google Workspace Events API ওভারভিউ দেখুন।

এই পৃষ্ঠায় Google Workspace সাবস্ক্রিপশন তৈরি করার জন্য নিম্নলিখিত ধাপগুলি অন্তর্ভুক্ত রয়েছে:

  1. আপনার পরিবেশ সেট আপ করুন।
  2. একটি Google ক্লাউড পাব/সাব বিষয় তৈরি করুন এবং সদস্যতা নিন। Google Workspace ইভেন্টগুলি পেতে আপনি এই বিষয়টিকে এন্ডপয়েন্ট হিসেবে ব্যবহার করেন।
  3. Subscription রিসোর্সে Google Workspace Events API-এর create() পদ্ধতিতে কল করুন।
  4. আপনার সাবস্ক্রাইব করা ইভেন্টগুলি আপনার পাব/সাব টপিক পাচ্ছে কিনা তা নিশ্চিত করতে আপনার Google Workspace সাবস্ক্রিপশন পরীক্ষা করুন।
  5. ঐচ্ছিকভাবে, কীভাবে আপনার অ্যাপের জন্য ইভেন্টগুলিকে একটি এন্ডপয়েন্টে ঠেলে দেওয়া যায় তা কনফিগার করুন, যাতে আপনার অ্যাপ ইভেন্টটি প্রক্রিয়া করতে পারে এবং প্রয়োজনে পদক্ষেপ নিতে পারে।

পূর্বশর্ত

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

  • এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
    1. Google Cloud CLI ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:
    3.   gcloud init
        
  • বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
  • অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।
  • একটি Apps স্ক্রিপ্ট প্রকল্প:
    • অ্যাপস স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টের পরিবর্তে আপনার Google ক্লাউড প্রকল্প ব্যবহার করুন।
    • OAuth সম্মতি স্ক্রীন কনফিগার করার জন্য আপনি যেকোন স্কোপ যোগ করেছেন, আপনাকে অবশ্যই আপনার Apps Script প্রোজেক্টের appsscript.json ফাইলে স্কোপ যোগ করতে হবে। যেমন:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Google Workspace Events উন্নত পরিষেবা চালু করুন

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পাইপ প্যাকেজ ম্যানেজমেন্ট টুল
  • পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • এই নির্দেশিকায় Google Cloud CLI কমান্ডগুলি ব্যবহার করতে:
    1. Google Cloud CLI ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোড চালান:
    3.   gcloud init
        
  • বিলিং সক্ষম সহ একটি Google ক্লাউড প্রকল্প ৷ চ্যাটে সাবস্ক্রিপশনের জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রোজেক্টে চ্যাট API সক্রিয় করতে হবে এবং অ্যাপের নাম , অবতার URL এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ তৈরি করুন দেখুন।
  • অ্যাপের জন্য কনফিগার করা OAuth সম্মতি স্ক্রিন সহ ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রীন কনফিগার করবেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের ধরন সমর্থন করার জন্য একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রীন কনফিগার করতে এবং প্রয়োজনীয় স্কোপ শনাক্ত করতে, স্কোপ বেছে নিন দেখুন।

আপনার পরিবেশ সেট আপ করুন

Google Workspace সাবস্ক্রিপশন তৈরি করার আগে কীভাবে আপনার পরিবেশ সেট-আপ করবেন তা নিম্নলিখিত বিভাগে ব্যাখ্যা করা হয়েছে।

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

Google API ব্যবহার করার আগে, আপনাকে একটি Google ক্লাউড প্রকল্পে সেগুলি চালু করতে হবে। আপনি একটি একক Google ক্লাউড প্রকল্পে এক বা একাধিক API চালু করতে পারেন৷

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

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

OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন

কিভাবে একটি OAuth ক্লায়েন্ট আইডি তৈরি করতে হয় সে সম্পর্কে নির্দিষ্ট নির্দেশাবলীর জন্য আপনার আবেদনের ধরন বেছে নিন:

ওয়েব অ্যাপ্লিকেশন

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ওয়েব অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. আপনার অ্যাপের সাথে সম্পর্কিত অনুমোদিত URI যোগ করুন:
    • ক্লায়েন্ট-সাইড অ্যাপস (জাভাস্ক্রিপ্ট) -অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন-এর অধীনে, URI যোগ করুন-এ ক্লিক করুন। তারপর, ব্রাউজার অনুরোধের জন্য ব্যবহার করার জন্য একটি URI লিখুন। এটি সেই ডোমেনগুলিকে চিহ্নিত করে যেগুলি থেকে আপনার অ্যাপ্লিকেশনটি OAuth 2.0 সার্ভারে API অনুরোধ পাঠাতে পারে৷
    • সার্ভার-সাইড অ্যাপস (জাভা, পাইথন, এবং আরও) -অথরাইজড রিডাইরেক্ট ইউআরআই-এর অধীনে, ইউআরআই যোগ করুন ক্লিক করুন। তারপর, একটি এন্ডপয়েন্ট URI লিখুন যেখানে OAuth 2.0 সার্ভার প্রতিক্রিয়া পাঠাতে পারে।
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্রটি OAuth 2.0 ক্লায়েন্ট আইডির অধীনে প্রদর্শিত হয়।

    ক্লায়েন্ট আইডি নোট করুন। ক্লায়েন্ট গোপনীয়তা ওয়েব অ্যাপ্লিকেশনের জন্য ব্যবহার করা হয় না.

অ্যান্ড্রয়েড

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > অ্যান্ড্রয়েড ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "প্যাকেজের নাম" ক্ষেত্রে, আপনার AndroidManifest.xml ফাইল থেকে প্যাকেজের নাম লিখুন।
  6. "SHA-1 শংসাপত্রের ফিঙ্গারপ্রিন্ট" ক্ষেত্রে, আপনার তৈরি করা SHA-1 শংসাপত্রের আঙুলের ছাপ লিখুন৷
  7. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

iOS

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > iOS এ ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "বান্ডেল আইডি" ফিল্ডে, অ্যাপের Info.plist ফাইলে তালিকাভুক্ত বান্ডিল শনাক্তকারী লিখুন।
  6. ঐচ্ছিক: অ্যাপল অ্যাপ স্টোরে আপনার অ্যাপটি দেখা গেলে অ্যাপ স্টোর আইডি লিখুন।
  7. ঐচ্ছিক: "টিম আইডি" ফিল্ডে, অ্যাপল দ্বারা তৈরি এবং আপনার দলকে বরাদ্দ করা অনন্য 10-অক্ষরের স্ট্রিংটি লিখুন।
  8. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ক্রোম অ্যাপ

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > Chrome এক্সটেনশন ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "আইটেম আইডি" ক্ষেত্রে, আপনার অ্যাপের অনন্য 32-অক্ষরের আইডি স্ট্রিং লিখুন। আপনি আপনার অ্যাপের Chrome ওয়েব স্টোর URL এবং Chrome ওয়েব স্টোর ডেভেলপার ড্যাশবোর্ডে এই আইডি মানটি খুঁজে পেতে পারেন৷
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ডেস্কটপ অ্যাপ

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. Application type > Desktop app এ ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

টিভি এবং সীমিত ইনপুট ডিভাইস

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > টিভি এবং সীমিত ইনপুট ডিভাইসে ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (UWP)

  1. Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট

    ক্লায়েন্টে যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. Application type > Universal Windows Platform (UWP) এ ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. "স্টোর আইডি" ক্ষেত্রে, আপনার অ্যাপের অনন্য, 12-অক্ষরের Microsoft স্টোর আইডি মান লিখুন। আপনি আপনার অ্যাপের Microsoft স্টোর URL এবং অংশীদার কেন্দ্রে এই আইডিটি খুঁজে পেতে পারেন।
  6. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷

ক্লায়েন্ট গোপন JSON ফাইল ডাউনলোড করুন

ক্লায়েন্ট সিক্রেট ফাইল হল OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলির একটি JSON উপস্থাপনা যা আপনার অ্যাপ শংসাপত্রগুলি প্রদান করার সময় উল্লেখ করতে পারে।

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. OAuth 2.0 ক্লায়েন্ট আইডির অধীনে, আপনার তৈরি করা ক্লায়েন্ট আইডিটিতে ক্লিক করুন।

  3. JSON ডাউনলোড এ ক্লিক করুন।

  4. ফাইলটিকে client_secrets.json হিসাবে সংরক্ষণ করুন।

একটি পাব/সাব বিষয় তৈরি করুন এবং সদস্যতা নিন

এই বিভাগে, আপনি একটি পাব/সাব বিষয় এবং বিষয়ের সদস্যতা তৈরি করেন। আপনার পাব/সাব টপিক নোটিফিকেশন এন্ডপয়েন্ট হিসেবে কাজ করে যেখানে আপনার Google Workspace সাবস্ক্রিপশন ইভেন্ট গ্রহণ করে।

পাব/সাব বিষয়গুলি তৈরি এবং পরিচালনা করার বিষয়ে আরও জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

একটি পাব/সাব বিষয় তৈরি করতে এবং সদস্যতা নিতে:

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

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

    Google Cloud Pub/Sub-এ যান

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

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

    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. Meet ইভেন্টের জন্য, meet-api-event-push@system.gserviceaccount.com
    4. ভূমিকা বরাদ্দ মেনুতে, Pub/Sub Publisher নির্বাচন করুন।
    5. Save এ ক্লিক করুন। আপনার বিষয়ের অনুমতি আপডেট করতে কয়েক মিনিট সময় লাগতে পারে।

জিক্লাউড

  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 ব্যবহার করুন।
      • 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 : আপনার বিষয়ের নাম যা আপনি পূর্ববর্তী ধাপে তৈরি করেছেন।

Google Workspace রিসোর্সে সাবস্ক্রাইব করুন

এই বিভাগে, আপনি Google Workspace রিসোর্সে সাবস্ক্রাইব করেছেন যেটি ইভেন্টের জন্য আপনি নিরীক্ষণ করতে চান।

টার্গেট রিসোর্স বেছে নিন এবং চিহ্নিত করুন

Google Workspace সাবস্ক্রিপশনে, টার্গেট রিসোর্স হল Google Workspace রিসোর্স যা আপনি ইভেন্টের জন্য পর্যবেক্ষণ করেন। টার্গেট রিসোর্সটি সাবস্ক্রিপশনের targetResource ফিল্ডে উপস্থাপন করা হয়, সম্পূর্ণ রিসোর্স নাম ব্যবহার করে ফরম্যাট করা হয়। উদাহরণস্বরূপ, একটি সাবস্ক্রিপশনের জন্য যা Google চ্যাট স্পেস ( spaces/AAAABBBBBBB ) নিরীক্ষণ করে, targetResource এর মান হল //chat.googleapis.com/spaces/AAAABBBBBBB

আপনি সাবস্ক্রিপশন তৈরি করার আগে, লক্ষ্য সম্পদ শনাক্ত এবং বিন্যাস কিভাবে শিখতে নিম্নলিখিত বিভাগ ব্যবহার করুন.

চ্যাটের জন্য একটি টার্গেট রিসোর্স শনাক্ত করুন

লক্ষ্য সম্পদ বিন্যাস সীমাবদ্ধতা
স্থান

//chat.googleapis.com/spaces/ SPACE

যেখানে SPACE হল চ্যাট এপিআই space রিসোর্সের রিসোর্সের নামের আইডি। আপনি স্পেসের URL থেকে অথবা spaces.list() পদ্ধতি ব্যবহার করে আইডি পেতে পারেন।

যে চ্যাট ব্যবহারকারী সাবস্ক্রিপশন অনুমোদন করেন তাকে অবশ্যই তাদের Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে স্পেস-এর সদস্য হতে হবে।
একজন ব্যবহারকারীর জন্য সমস্ত স্থান

//chat.googleapis.com/spaces/-

সাবস্ক্রিপশন শুধুমাত্র সেই জায়গাগুলির জন্য ইভেন্ট গ্রহণ করে যেখানে ব্যবহারকারী তার Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে সদস্য।
ব্যবহারকারী

//cloudidentity.googleapis.com/users/ USER

যেখানে USER হল Chat API user সম্পদের রিসোর্স নামের আইডি। বিশদ বিবরণের জন্য, Google চ্যাট ব্যবহারকারীদের সনাক্ত করুন এবং নির্দিষ্ট করুন দেখুন।

সাবস্ক্রিপশন শুধুমাত্র সেই ব্যবহারকারীর সম্পর্কে ইভেন্টগুলি গ্রহণ করে যে সদস্যতা অনুমোদন করেছে৷ একজন ব্যবহারকারী অন্য ব্যবহারকারীদের পক্ষে সাবস্ক্রিপশন অনুমোদন করতে পারে না।

Meet-এর জন্য একটি টার্গেট রিসোর্স শনাক্ত করুন

লক্ষ্য সম্পদ বিন্যাস সীমাবদ্ধতা (যদি প্রযোজ্য হয়)
মিটিং স্পেস //meet.googleapis.com/spaces/ SPACE

যেখানে SPACE হল Meet REST API space রিসোর্সের রিসোর্সের নামের আইডি। বিস্তারিত জানার জন্য, দেখুন কিভাবে Meet একটি মিটিং স্পেস সনাক্ত করে

ব্যবহারকারী //cloudidentity.googleapis.com/users/ USER

যেখানে USER হল Meet REST API participant রিসোর্সের signedinUser.user ক্ষেত্রের আইডি। বিস্তারিত জানার জন্য, অংশগ্রহণকারীদের সাথে কাজ দেখুন।

সদস্যতা মিটিং স্পেস সম্পর্কে ইভেন্টগুলি গ্রহণ করে যেখানে ব্যবহারকারী নিম্নলিখিতগুলির মধ্যে একটি:

  • সভাস্থলের মালিক।
  • মিটিং স্পেসে একজন অংশগ্রহণকারী।
  • মিটিং স্পেসের সাথে যুক্ত Google ক্যালেন্ডার ইভেন্টের আয়োজক

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

সাবস্ক্রিপশন তৈরি করতে, আপনি Subscription রিসোর্স তৈরি করতে Google Workspace Events API-এর subscriptions.create() পদ্ধতি ব্যবহার করেন। আপনি নিম্নলিখিত ক্ষেত্র নির্দিষ্ট করুন:

  • targetResource : একটি গুগল ওয়ার্কস্পেস যা আপনি পূর্ববর্তী বিভাগে চিহ্নিত করেছেন, এর সম্পূর্ণ সংস্থান নামটি ব্যবহার করে ফর্ম্যাট করেছেন।
  • eventTypes : আপনি সংস্থান সম্পর্কে এক বা একাধিক ইভেন্টের ধরণের একটি অ্যারে পেতে চান। উদাহরণস্বরূপ, যদি আপনার অ্যাপ্লিকেশনটিকে কেবল কোনও চ্যাট স্পেসে পোস্ট করা নতুন বার্তাগুলি সম্পর্কে জানতে হয় তবে আপনার অ্যাপ্লিকেশনটি কেবল তৈরি করা বার্তাগুলি সম্পর্কে ইভেন্টগুলিতে সাবস্ক্রাইব করতে পারে।
  • notificationEndpoint : একটি বিজ্ঞপ্তি শেষ পয়েন্ট যেখানে আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন ইভেন্টগুলি সরবরাহ করে। আপনি পূর্ববর্তী বিভাগে তৈরি করা পাব/সাব বিষয় ব্যবহার করেন।
  • payloadOptions : ইভেন্টের পে -লোডে কতটা সংস্থান ডেটা অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করার বিকল্পগুলি। এই কনফিগারেশনটি আপনার সাবস্ক্রিপশনের জন্য মেয়াদোত্তীর্ণ সময়কে প্রভাবিত করে। আরও জানতে, ইভেন্টের ডেটা দেখুন।

একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে:

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

  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 : গুগল ওয়ার্কস্পেস রিসোর্স যা আপনি সাবস্ক্রাইব করছেন, এর সম্পূর্ণ সংস্থান নাম হিসাবে ফর্ম্যাট করেছেন। উদাহরণস্বরূপ, স্পেস আইডি AAAABBBB সহ একটি গুগল চ্যাট স্পেসে সাবস্ক্রাইব করতে, //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. গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে, আপনার অ্যাপ্লিকেশন স্ক্রিপ্ট প্রকল্পে ফাংশনটি 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('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 : এক বা একাধিক ওআউথ স্কোপগুলি যা সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকারকে সমর্থন করে। স্ট্রিংগুলির একটি অ্যারে হিসাবে ফর্ম্যাট করা। একাধিক স্কোপ তালিকা করতে, কমা দ্বারা পৃথক। উদাহরণস্বরূপ, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
    • TARGET_RESOURCE : গুগল ওয়ার্কস্পেস রিসোর্স যা আপনি সাবস্ক্রাইব করছেন, এর সম্পূর্ণ সংস্থান নাম হিসাবে ফর্ম্যাট করেছেন। উদাহরণস্বরূপ, স্পেস আইডি AAAABBBB সহ একটি গুগল চ্যাট স্পেসে সাবস্ক্রাইব করতে, //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. গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে, আপনার টার্মিনালে নিম্নলিখিতগুলি চালান:

    python3 create_subscription.py

গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই একটি সম্পূর্ণ দীর্ঘ-চলমান অপারেশন প্রদান করে যা আপনি তৈরি করেছেন এমন Subscription রিসোর্সের উদাহরণ রয়েছে।

আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করুন

আপনি গুগল ওয়ার্কস্পেস ইভেন্টগুলি গ্রহণ করছেন তা পরীক্ষা করার জন্য, আপনি কোনও ইভেন্ট ট্রিগার করতে পারেন এবং পাব/সাবস্ক্রিপশনে বার্তাগুলি টানতে পারেন।

আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করতে:

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

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

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

    পাব/সাব যান

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

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

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

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

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

জিক্লাউড

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

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

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

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

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

    কোনও ইভেন্টে একটি পাব/সাব বার্তা উত্পন্ন করতে কয়েক মিনিট সময় নিতে পারে।

আপনি ট্রিগার করেছেন এমন প্রতিটি গুগল ওয়ার্কস্পেস ইভেন্টের জন্য, আপনার পাব/সাব সাবস্ক্রিপশনে একটি বার্তা সরবরাহ করা হয়েছে যাতে ইভেন্টটি রয়েছে। বিশদগুলির জন্য, গুগল ক্লাউড পাব/সাব বার্তা হিসাবে ইভেন্টগুলি প্রাপ্তি দেখুন।

আপনার অ্যাপ্লিকেশন কীভাবে ইভেন্টগুলি গ্রহণ করে তা কনফিগার করুন

আপনি তৈরি করেছেন এমন পাব/সাব সাবস্ক্রিপশনটি পুল-ভিত্তিক। আপনার পাব/সাব সাবস্ক্রিপশন পরীক্ষা করার পরে, আপনার অ্যাপ্লিকেশনটি কীভাবে ইভেন্টগুলি গ্রহণ করে তা পরিবর্তন করতে আপনি বিতরণ প্রকারটি আপডেট করতে পারেন। উদাহরণস্বরূপ, আপনি একটি পুশ ডেলিভারি টাইপের সাথে পাব/সাব সাবস্ক্রিপশনটি কনফিগার করতে পারেন, যাতে আপনার অ্যাপ্লিকেশনটি সরাসরি কোনও অ্যাপ্লিকেশন শেষ পয়েন্টে ইভেন্টগুলি পেতে পারে।

একটি পাব/সাব সাবস্ক্রিপশন কনফিগার করার বিষয়ে জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

,

এই পৃষ্ঠাটি গুগল ওয়ার্কস্পেস রিসোর্সের সাবস্ক্রিপশন তৈরি করতে কীভাবে গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই ব্যবহার করবেন তা ব্যাখ্যা করে। একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন আপনার অ্যাপ্লিকেশনটিকে গুগল ওয়ার্কস্পেস ইভেন্টগুলি সম্পর্কে তথ্য পেতে দেয়, যা গুগল ওয়ার্কস্পেস রিসোর্সে পরিবর্তনের প্রতিনিধিত্ব করে। গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই সমর্থন করে কোন সংস্থান এবং ইভেন্টের ধরণের সম্পর্কে জানতে, গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই ওভারভিউ দেখুন।

এই পৃষ্ঠায় একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরির জন্য নিম্নলিখিত পদক্ষেপগুলি অন্তর্ভুক্ত রয়েছে:

  1. আপনার পরিবেশ সেট আপ করুন।
  2. একটি গুগল ক্লাউড পাব/সাব বিষয় তৈরি করুন এবং সাবস্ক্রাইব করুন। গুগল ওয়ার্কস্পেস ইভেন্টগুলি পেতে আপনি এই বিষয়টিকে শেষ পয়েন্ট হিসাবে ব্যবহার করেন।
  3. Subscription রিসোর্সে গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এর create() পদ্ধতিটি কল করুন।
  4. আপনার পাব/সাব টপিকটি আপনি সাবস্ক্রাইব করেছেন এমন ইভেন্টগুলি পেয়েছেন তা নিশ্চিত করতে আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করুন।
  5. Ally চ্ছিকভাবে, কীভাবে ইভেন্টগুলি আপনার অ্যাপ্লিকেশনটির জন্য একটি শেষ পয়েন্টে ঠেলা যায় তা কনফিগার করুন, যাতে আপনার অ্যাপ্লিকেশনটি ইভেন্টটি প্রক্রিয়া করতে পারে এবং প্রয়োজনে, পদক্ষেপ নিতে পারে।

পূর্বশর্ত

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

  • এই গাইডে গুগল ক্লাউড সিএলআই কমান্ডগুলি ব্যবহার করতে:
    1. গুগল ক্লাউড সিএলআই ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোডটি চালান:
    3.   gcloud init
        
  • বিলিং সহ একটি গুগল ক্লাউড প্রকল্প সক্ষম করা হয়েছে। সাবস্ক্রিপশনগুলির জন্য চ্যাট করার জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রকল্পে চ্যাট এপিআই সক্ষম করতে হবে এবং অ্যাপের নাম , অবতার ইউআরএল এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদগুলির জন্য, একটি গুগল চ্যাট অ্যাপ্লিকেশন তৈরি করুন
  • অ্যাপ্লিকেশনটির জন্য কনফিগার করা OAuth সম্মতি স্ক্রিনের সাথে ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রিনটি কনফিগার করেন, সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকার সমর্থন করার জন্য আপনাকে অবশ্যই একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রিনটি কনফিগার করতে এবং প্রয়োজনীয় স্কোপগুলি সনাক্ত করতে, স্কোপগুলি চয়ন করুন
  • একটি অ্যাপ্লিকেশন স্ক্রিপ্ট প্রকল্প:
    • অ্যাপ্লিকেশন স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টর পরিবর্তে আপনার গুগল ক্লাউড প্রকল্পটি ব্যবহার করুন।
    • আপনি ওএথ সম্মতি স্ক্রিনটি কনফিগার করতে যে কোনও স্কোপ যুক্ত করেছেন তার জন্য আপনাকে অবশ্যই আপনার অ্যাপস স্ক্রিপ্ট প্রকল্পে appsscript.json ফাইলে স্কোপগুলি যুক্ত করতে হবে। যেমন:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Google Workspace Events উন্নত পরিষেবা সক্ষম করুন

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পিআইপি প্যাকেজ পরিচালনার সরঞ্জাম
  • পাইথনের জন্য সর্বশেষ গুগল ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • এই গাইডে গুগল ক্লাউড সিএলআই কমান্ডগুলি ব্যবহার করতে:
    1. গুগল ক্লাউড সিএলআই ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোডটি চালান:
    3.   gcloud init
        
  • বিলিং সহ একটি গুগল ক্লাউড প্রকল্প সক্ষম করা হয়েছে। সাবস্ক্রিপশনগুলির জন্য চ্যাট করার জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রকল্পে চ্যাট এপিআই সক্ষম করতে হবে এবং অ্যাপের নাম , অবতার ইউআরএল এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদগুলির জন্য, একটি গুগল চ্যাট অ্যাপ্লিকেশন তৈরি করুন
  • অ্যাপ্লিকেশনটির জন্য কনফিগার করা OAuth সম্মতি স্ক্রিনের সাথে ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রিনটি কনফিগার করেন, সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকার সমর্থন করার জন্য আপনাকে অবশ্যই একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রিনটি কনফিগার করতে এবং প্রয়োজনীয় স্কোপগুলি সনাক্ত করতে, স্কোপগুলি চয়ন করুন

আপনার পরিবেশ সেট আপ করুন

নিম্নলিখিত বিভাগটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরির আগে কীভাবে আপনার পরিবেশ সেট আপ করবেন তা ব্যাখ্যা করে।

গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং গুগল ক্লাউড পাব/সাব এপিআই সক্ষম করুন

গুগল এপিআই ব্যবহার করার আগে আপনাকে এগুলি একটি গুগল ক্লাউড প্রকল্পে চালু করতে হবে। আপনি একক গুগল ক্লাউড প্রকল্পে এক বা একাধিক এপিআই চালু করতে পারেন।

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

গুগল ক্লাউড কনসোলে, আপনার অ্যাপ্লিকেশনটির জন্য গুগল ক্লাউড প্রকল্পটি খুলুন এবং গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং পাব/সাব এপিআই সক্ষম করুন:

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

জিক্লাউড

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

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

    gcloud config set project PROJECT_ID

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

  3. গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং গুগল ক্লাউড পাব/সাব এপিআই সক্ষম করুন:

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

OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলি তৈরি করুন

কীভাবে একটি OAuth ক্লায়েন্ট আইডি তৈরি করবেন সে সম্পর্কে নির্দিষ্ট নির্দেশাবলীর জন্য আপনার অ্যাপ্লিকেশন প্রকারটি চয়ন করুন:

ওয়েব অ্যাপ্লিকেশন

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ওয়েব অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. আপনার অ্যাপ্লিকেশন সম্পর্কিত অনুমোদিত ইউআরআই যুক্ত করুন:
    • ক্লায়েন্ট-সাইড অ্যাপস (জাভাস্ক্রিপ্ট) -অনুমোদিত জাভাস্ক্রিপ্ট উত্সের অধীনে, ইউআরআই যুক্ত করুন ক্লিক করুন। তারপরে, ব্রাউজারের অনুরোধগুলির জন্য ব্যবহার করতে একটি ইউআরআই প্রবেশ করুন। এটি ডোমেনগুলি সনাক্ত করে যা থেকে আপনার অ্যাপ্লিকেশনটি ওএউথ 2.0 সার্ভারে এপিআই অনুরোধগুলি প্রেরণ করতে পারে।
    • সার্ভার-সাইড অ্যাপ্লিকেশনগুলি (জাভা, পাইথন এবং আরও অনেক কিছু) -অনুমোদিত অনুমোদিত পুনর্নির্দেশ ইউআরআইএস , ইউআরআই যুক্ত করুন ক্লিক করুন। তারপরে, একটি শেষ পয়েন্ট ইউআরআই প্রবেশ করুন যেখানে OAuth 2.0 সার্ভার প্রতিক্রিয়া প্রেরণ করতে পারে।
  6. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রগুলি OAuth 2.0 ক্লায়েন্ট আইডির অধীনে প্রদর্শিত হবে।

    ক্লায়েন্ট আইডি নোট করুন। ক্লায়েন্টের গোপনীয়তা ওয়েব অ্যাপ্লিকেশনগুলির জন্য ব্যবহৃত হয় না।

অ্যান্ড্রয়েড

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > অ্যান্ড্রয়েড ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "প্যাকেজ নাম" ক্ষেত্রে, আপনার AndroidManifest.xml ফাইল থেকে প্যাকেজের নাম লিখুন।
  6. "SHA-1 শংসাপত্র ফিঙ্গারপ্রিন্ট" ক্ষেত্রে, আপনার উত্পন্ন SHA-1 শংসাপত্রের ফিঙ্গারপ্রিন্ট প্রবেশ করুন।
  7. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

iOS

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > আইওএস ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "বান্ডিল আইডি" ক্ষেত্রে, অ্যাপের Info.plist ফাইলে তালিকাভুক্ত হিসাবে বান্ডিল আইডেন্টিফায়ার লিখুন।
  6. Ption চ্ছিক: যদি আপনার অ্যাপটি অ্যাপল অ্যাপ স্টোরে উপস্থিত হয় তবে অ্যাপ স্টোর আইডি লিখুন।
  7. Ption চ্ছিক: "টিম আইডি" ক্ষেত্রে, অ্যাপল দ্বারা উত্পাদিত এবং আপনার দলকে নির্ধারিত অনন্য 10-চরিত্রের স্ট্রিংটি প্রবেশ করুন।
  8. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ক্রোম অ্যাপ

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ক্রোম এক্সটেনশন ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "আইটেম আইডি" ক্ষেত্রে, আপনার অ্যাপ্লিকেশনটির অনন্য 32-চরিত্র আইডি স্ট্রিং লিখুন। আপনি এই আইডি মানটি আপনার অ্যাপের ক্রোম ওয়েব স্টোর ইউআরএল এবং ক্রোম ওয়েব স্টোর বিকাশকারী ড্যাশবোর্ডে খুঁজে পেতে পারেন।
  6. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ডেস্কটপ অ্যাপ

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ডেস্কটপ অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

টিভি এবং সীমিত ইনপুট ডিভাইস

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন টাইপ > টিভি এবং সীমিত ইনপুট ডিভাইসগুলিতে ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (UWP)

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (ইউডাব্লুপি) ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "স্টোর আইডি" ক্ষেত্রে, আপনার অ্যাপ্লিকেশনটির অনন্য, 12-চরিত্রের মাইক্রোসফ্ট স্টোর আইডি মান লিখুন। আপনি এই আইডিটি আপনার অ্যাপের মাইক্রোসফ্ট স্টোর ইউআরএল এবং অংশীদার কেন্দ্রে খুঁজে পেতে পারেন।
  6. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ক্লায়েন্ট সিক্রেট জসন ফাইলটি ডাউনলোড করুন

ক্লায়েন্ট সিক্রেট ফাইলটি OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলির একটি JSON উপস্থাপনা যা আপনার অ্যাপ্লিকেশনটি শংসাপত্র সরবরাহ করার সময় উল্লেখ করতে পারে।

  1. গুগল ক্লাউড কনসোলে, মেনু > এপিআইএস এবং পরিষেবাদি > শংসাপত্রগুলিতে যান।

    শংসাপত্রগুলিতে যান

  2. OAuth 2.0 ক্লায়েন্ট আইডি এর অধীনে, আপনি তৈরি করা ক্লায়েন্ট আইডিটি ক্লিক করুন।

  3. ডাউনলোড json ক্লিক করুন।

  4. client_secrets.json হিসাবে ফাইলটি সংরক্ষণ করুন।

একটি পাব/সাব বিষয় তৈরি করুন এবং সাবস্ক্রাইব করুন

এই বিভাগে, আপনি একটি পাব/সাব বিষয় এবং বিষয়টির সাবস্ক্রিপশন তৈরি করেন। আপনার পাব/সাব বিষয়টি বিজ্ঞপ্তি শেষ হিসাবে কাজ করে যেখানে আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন ইভেন্টগুলি গ্রহণ করে।

পাব/উপ -বিষয়গুলি তৈরি এবং পরিচালনা সম্পর্কে আরও জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

একটি পাব/সাব বিষয় তৈরি এবং সাবস্ক্রাইব করতে:

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

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

    গুগল ক্লাউড পাব/সাব এ যান

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

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

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

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

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

জিক্লাউড

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

    gcloud pubsub topics create TOPIC_ID

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

    আউটপুটটি সম্পূর্ণ বিষয়ের নাম প্রদর্শন করে, projects/ PROJECT_ID /topics/ TOPIC_ID হিসাবে ফর্ম্যাট করা। নামটি নোট করুন এবং আপনার অ্যাপ্লিকেশনটির জন্য ক্লাউড প্রজেক্ট আইডি হ'ল PROJECT_ID এর মানটি নিশ্চিত করুন। আপনি নিম্নলিখিত পদক্ষেপে বিষয়ের নামটি ব্যবহার করেন এবং পরে গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে।

  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 : গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশন যা অবশ্যই আপনার সাবস্ক্রিপশনে ইভেন্টগুলি সরবরাহ করতে হবে:

      • চ্যাট থেকে ইভেন্টগুলি পেতে, chat-api-push@system.gserviceaccount.com ব্যবহার করুন।
      • সভা থেকে ইভেন্টগুলি পেতে, meet-api-event-push@system.gserviceaccount.com ব্যবহার করুন।

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

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

     gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

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

    • SUBSCRIPTION_NAME : আপনার সাবস্ক্রিপশনের জন্য একটি নাম যেমন workspace-events-subscription
    • TOPIC_NAME : আপনি আগের পদক্ষেপে তৈরি করা আপনার বিষয়ের নাম।

একটি গুগল ওয়ার্কস্পেস রিসোর্সে সাবস্ক্রাইব করুন

এই বিভাগে, আপনি ইভেন্টগুলির জন্য নিরীক্ষণ করতে চান এমন গুগল ওয়ার্কস্পেস রিসোর্সে সাবস্ক্রাইব করুন।

লক্ষ্য সংস্থানটি চয়ন করুন এবং সনাক্ত করুন

একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশনে, টার্গেট রিসোর্স হ'ল গুগল ওয়ার্কস্পেস রিসোর্স যা আপনি ইভেন্টগুলির জন্য নিরীক্ষণ করেন। টার্গেট রিসোর্সটি সাবস্ক্রিপশনের targetResource ক্ষেত্রে প্রতিনিধিত্ব করা হয়, সম্পূর্ণ সংস্থান নামটি ব্যবহার করে ফর্ম্যাট করা। উদাহরণস্বরূপ, একটি সাবস্ক্রিপশনের জন্য যা গুগল চ্যাট স্পেস ( spaces/AAAABBBBBBB ) পর্যবেক্ষণ করে, targetResource মান //chat.googleapis.com/spaces/AAAABBBBBBB

আপনি সাবস্ক্রিপশন তৈরি করার আগে, লক্ষ্য সংস্থানটি কীভাবে সনাক্ত এবং ফর্ম্যাট করতে হয় তা শিখতে নিম্নলিখিত বিভাগগুলি ব্যবহার করুন।

চ্যাটের জন্য একটি লক্ষ্য সংস্থান চিহ্নিত করুন

লক্ষ্য সংস্থান বিন্যাস সীমাবদ্ধতা
স্থান

//chat.googleapis.com/spaces/ SPACE

চ্যাট এপিআই space রিসোর্সের রিসোর্স নামের আইডি যেখানে SPACE । আপনি স্পেসের ইউআরএল থেকে বা spaces.list() পদ্ধতি ব্যবহার করে আইডিটি পেতে পারেন।

চ্যাট ব্যবহারকারী যা সাবস্ক্রিপশনকে অনুমোদন দেয় তাদের অবশ্যই তাদের গুগল ওয়ার্কস্পেস বা গুগল অ্যাকাউন্টের মাধ্যমে স্থানের সদস্য হতে হবে।
একটি ব্যবহারকারীর জন্য সমস্ত স্পেস

//chat.googleapis.com/spaces/-

সাবস্ক্রিপশন কেবলমাত্র সেই জায়গাগুলির জন্য ইভেন্টগুলি গ্রহণ করে যেখানে ব্যবহারকারী তাদের গুগল ওয়ার্কস্পেস বা গুগল অ্যাকাউন্টের মাধ্যমে সদস্য।
ব্যবহারকারী

//cloudidentity.googleapis.com/users/ USER

চ্যাট এপিআই user রিসোর্সের রিসোর্স নামের আইডি যেখানে USER । বিশদগুলির জন্য, গুগল চ্যাট ব্যবহারকারীদের সনাক্ত এবং নির্দিষ্ট করুন দেখুন।

সাবস্ক্রিপশনটি কেবলমাত্র ব্যবহারকারী সম্পর্কে ইভেন্টগুলি গ্রহণ করে যা সাবস্ক্রিপশনকে অনুমোদিত করে। একজন ব্যবহারকারী অন্যান্য ব্যবহারকারীর পক্ষে সাবস্ক্রিপশন অনুমোদন করতে পারবেন না।

মিলনের জন্য একটি লক্ষ্য সংস্থান চিহ্নিত করুন

লক্ষ্য সংস্থান বিন্যাস সীমাবদ্ধতা (প্রযোজ্য ক্ষেত্রে)
মিটিং স্পেস //meet.googleapis.com/spaces/ SPACE

মিট রেস্ট এপিআই স্পেস space রিসোর্স নামের আইডি যেখানে SPACE । বিশদগুলির জন্য, দেখুন কীভাবে মিট একটি সভার স্থান চিহ্নিত করে

ব্যবহারকারী //cloudidentity.googleapis.com/users/ USER

যেখানে USER signedinUser.user ক্ষেত্রের আইডি রয়েছে REST এপিআই participant সংস্থান বিশদের জন্য, অংশগ্রহণকারীদের সাথে কাজ দেখুন।

সাবস্ক্রিপশনটি পূরণের জায়গাগুলি সম্পর্কে ইভেন্টগুলি গ্রহণ করে যেখানে ব্যবহারকারী নিম্নলিখিতগুলির মধ্যে একটি:

  • সভার স্থানের মালিক।
  • সভার স্থানের একজন অংশগ্রহণকারী।
  • গুগল ক্যালেন্ডার ইভেন্টের সংগঠক সভার স্থানের সাথে যুক্ত।

একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করুন

সাবস্ক্রিপশন তৈরি করতে, আপনি Subscription রিসোর্স তৈরি করতে গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআইয়ের subscriptions.create() পদ্ধতি ব্যবহার করুন। আপনি নিম্নলিখিত ক্ষেত্রগুলি নির্দিষ্ট করুন:

  • targetResource : একটি গুগল ওয়ার্কস্পেস যা আপনি পূর্ববর্তী বিভাগে চিহ্নিত করেছেন, এর সম্পূর্ণ সংস্থান নামটি ব্যবহার করে ফর্ম্যাট করেছেন।
  • eventTypes : আপনি সংস্থান সম্পর্কে এক বা একাধিক ইভেন্টের ধরণের একটি অ্যারে পেতে চান। উদাহরণস্বরূপ, যদি আপনার অ্যাপ্লিকেশনটিকে কেবল কোনও চ্যাট স্পেসে পোস্ট করা নতুন বার্তাগুলি সম্পর্কে জানতে হয় তবে আপনার অ্যাপ্লিকেশনটি কেবল তৈরি করা বার্তাগুলি সম্পর্কে ইভেন্টগুলিতে সাবস্ক্রাইব করতে পারে।
  • notificationEndpoint : একটি বিজ্ঞপ্তি শেষ পয়েন্ট যেখানে আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন ইভেন্টগুলি সরবরাহ করে। আপনি পূর্ববর্তী বিভাগে তৈরি করা পাব/সাব বিষয় ব্যবহার করেন।
  • payloadOptions : ইভেন্টের পে -লোডে কতটা সংস্থান ডেটা অন্তর্ভুক্ত করতে হবে তা নির্দিষ্ট করার বিকল্পগুলি। এই কনফিগারেশনটি আপনার সাবস্ক্রিপশনের জন্য মেয়াদোত্তীর্ণ সময়কে প্রভাবিত করে। আরও জানতে, ইভেন্টের ডেটা দেখুন।

একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে:

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

  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 : গুগল ওয়ার্কস্পেস রিসোর্স যা আপনি সাবস্ক্রাইব করছেন, এর সম্পূর্ণ সংস্থান নাম হিসাবে ফর্ম্যাট করেছেন। উদাহরণস্বরূপ, স্পেস আইডি AAAABBBB সহ একটি গুগল চ্যাট স্পেসে সাবস্ক্রাইব করতে, //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. গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে, আপনার অ্যাপ্লিকেশন স্ক্রিপ্ট প্রকল্পে ফাংশনটি 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('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 : এক বা একাধিক ওআউথ স্কোপগুলি যা সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকারকে সমর্থন করে। স্ট্রিংগুলির একটি অ্যারে হিসাবে ফর্ম্যাট করা। একাধিক স্কোপ তালিকা করতে, কমা দ্বারা পৃথক। উদাহরণস্বরূপ, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
    • TARGET_RESOURCE : গুগল ওয়ার্কস্পেস রিসোর্স যা আপনি সাবস্ক্রাইব করছেন, এর সম্পূর্ণ সংস্থান নাম হিসাবে ফর্ম্যাট করেছেন। উদাহরণস্বরূপ, স্পেস আইডি AAAABBBB সহ একটি গুগল চ্যাট স্পেসে সাবস্ক্রাইব করতে, //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. গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরি করতে, আপনার টার্মিনালে নিম্নলিখিতগুলি চালান:

    python3 create_subscription.py

গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই একটি সম্পূর্ণ দীর্ঘ-চলমান অপারেশন প্রদান করে যা আপনি তৈরি করেছেন এমন Subscription রিসোর্সের উদাহরণ রয়েছে।

আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করুন

আপনি গুগল ওয়ার্কস্পেস ইভেন্টগুলি গ্রহণ করছেন তা পরীক্ষা করার জন্য, আপনি কোনও ইভেন্ট ট্রিগার করতে পারেন এবং পাব/সাবস্ক্রিপশনে বার্তাগুলি টানতে পারেন।

আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করতে:

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

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

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

    পাব/সাব যান

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

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

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

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

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

জিক্লাউড

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

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

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

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

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

    কোনও ইভেন্টে একটি পাব/সাব বার্তা উত্পন্ন করতে কয়েক মিনিট সময় নিতে পারে।

আপনি ট্রিগার করেছেন এমন প্রতিটি গুগল ওয়ার্কস্পেস ইভেন্টের জন্য, আপনার পাব/সাব সাবস্ক্রিপশনে একটি বার্তা সরবরাহ করা হয়েছে যাতে ইভেন্টটি রয়েছে। বিশদগুলির জন্য, গুগল ক্লাউড পাব/সাব বার্তা হিসাবে ইভেন্টগুলি প্রাপ্তি দেখুন।

আপনার অ্যাপ্লিকেশন কীভাবে ইভেন্টগুলি গ্রহণ করে তা কনফিগার করুন

আপনি তৈরি করেছেন এমন পাব/সাব সাবস্ক্রিপশনটি পুল-ভিত্তিক। আপনার পাব/সাব সাবস্ক্রিপশন পরীক্ষা করার পরে, আপনার অ্যাপ্লিকেশনটি কীভাবে ইভেন্টগুলি গ্রহণ করে তা পরিবর্তন করতে আপনি বিতরণ প্রকারটি আপডেট করতে পারেন। উদাহরণস্বরূপ, আপনি একটি পুশ ডেলিভারি টাইপের সাথে পাব/সাব সাবস্ক্রিপশনটি কনফিগার করতে পারেন, যাতে আপনার অ্যাপ্লিকেশনটি সরাসরি কোনও অ্যাপ্লিকেশন শেষ পয়েন্টে ইভেন্টগুলি পেতে পারে।

একটি পাব/সাব সাবস্ক্রিপশন কনফিগার করার বিষয়ে জানতে, পাব/সাব ডকুমেন্টেশন দেখুন।

,

এই পৃষ্ঠাটি গুগল ওয়ার্কস্পেস রিসোর্সের সাবস্ক্রিপশন তৈরি করতে কীভাবে গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই ব্যবহার করবেন তা ব্যাখ্যা করে। একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন আপনার অ্যাপ্লিকেশনটিকে গুগল ওয়ার্কস্পেস ইভেন্টগুলি সম্পর্কে তথ্য পেতে দেয়, যা গুগল ওয়ার্কস্পেস রিসোর্সে পরিবর্তনের প্রতিনিধিত্ব করে। গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই সমর্থন করে কোন সংস্থান এবং ইভেন্টের ধরণের সম্পর্কে জানতে, গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই ওভারভিউ দেখুন।

এই পৃষ্ঠায় একটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরির জন্য নিম্নলিখিত পদক্ষেপগুলি অন্তর্ভুক্ত রয়েছে:

  1. আপনার পরিবেশ সেট আপ করুন।
  2. একটি গুগল ক্লাউড পাব/সাব বিষয় তৈরি করুন এবং সাবস্ক্রাইব করুন। গুগল ওয়ার্কস্পেস ইভেন্টগুলি পেতে আপনি এই বিষয়টিকে শেষ পয়েন্ট হিসাবে ব্যবহার করেন।
  3. Subscription রিসোর্সে গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এর create() পদ্ধতিটি কল করুন।
  4. আপনার পাব/সাব টপিকটি আপনি সাবস্ক্রাইব করেছেন এমন ইভেন্টগুলি পেয়েছেন তা নিশ্চিত করতে আপনার গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন পরীক্ষা করুন।
  5. Ally চ্ছিকভাবে, কীভাবে ইভেন্টগুলি আপনার অ্যাপ্লিকেশনটির জন্য একটি শেষ পয়েন্টে ঠেলা যায় তা কনফিগার করুন, যাতে আপনার অ্যাপ্লিকেশনটি ইভেন্টটি প্রক্রিয়া করতে পারে এবং প্রয়োজনে, পদক্ষেপ নিতে পারে।

পূর্বশর্ত

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

  • এই গাইডে গুগল ক্লাউড সিএলআই কমান্ডগুলি ব্যবহার করতে:
    1. গুগল ক্লাউড সিএলআই ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোডটি চালান:
    3.   gcloud init
        
  • বিলিং সহ একটি গুগল ক্লাউড প্রকল্প সক্ষম করা হয়েছে। সাবস্ক্রিপশনগুলির জন্য চ্যাট করার জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রকল্পে চ্যাট এপিআই সক্ষম করতে হবে এবং অ্যাপের নাম , অবতার ইউআরএল এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদগুলির জন্য, একটি গুগল চ্যাট অ্যাপ্লিকেশন তৈরি করুন
  • অ্যাপ্লিকেশনটির জন্য কনফিগার করা OAuth সম্মতি স্ক্রিনের সাথে ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রিনটি কনফিগার করেন, সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকার সমর্থন করার জন্য আপনাকে অবশ্যই একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রিনটি কনফিগার করতে এবং প্রয়োজনীয় স্কোপগুলি সনাক্ত করতে, স্কোপগুলি চয়ন করুন
  • একটি অ্যাপ্লিকেশন স্ক্রিপ্ট প্রকল্প:
    • অ্যাপ্লিকেশন স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টর পরিবর্তে আপনার গুগল ক্লাউড প্রকল্পটি ব্যবহার করুন।
    • আপনি ওএথ সম্মতি স্ক্রিনটি কনফিগার করতে যে কোনও স্কোপ যুক্ত করেছেন তার জন্য আপনাকে অবশ্যই আপনার অ্যাপস স্ক্রিপ্ট প্রকল্পে appsscript.json ফাইলে স্কোপগুলি যুক্ত করতে হবে। যেমন:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • Google Workspace Events উন্নত পরিষেবা সক্ষম করুন

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পিআইপি প্যাকেজ পরিচালনার সরঞ্জাম
  • পাইথনের জন্য সর্বশেষ গুগল ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      
  • এই গাইডে গুগল ক্লাউড সিএলআই কমান্ডগুলি ব্যবহার করতে:
    1. গুগল ক্লাউড সিএলআই ইনস্টল করুন।
    2. gcloud CLI আরম্ভ করতে, নিম্নলিখিত কোডটি চালান:
    3.   gcloud init
        
  • বিলিং সহ একটি গুগল ক্লাউড প্রকল্প সক্ষম করা হয়েছে। সাবস্ক্রিপশনগুলির জন্য চ্যাট করার জন্য, আপনাকে অবশ্যই আপনার ক্লাউড প্রকল্পে চ্যাট এপিআই সক্ষম করতে হবে এবং অ্যাপের নাম , অবতার ইউআরএল এবং বিবরণ ক্ষেত্রগুলি কনফিগার করতে হবে। বিশদগুলির জন্য, একটি গুগল চ্যাট অ্যাপ্লিকেশন তৈরি করুন
  • অ্যাপ্লিকেশনটির জন্য কনফিগার করা OAuth সম্মতি স্ক্রিনের সাথে ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন। আপনি যখন সম্মতি স্ক্রিনটি কনফিগার করেন, সাবস্ক্রিপশনের জন্য প্রতিটি ইভেন্টের প্রকার সমর্থন করার জন্য আপনাকে অবশ্যই একটি সুযোগ নির্দিষ্ট করতে হবে। সম্মতি স্ক্রিনটি কনফিগার করতে এবং প্রয়োজনীয় স্কোপগুলি সনাক্ত করতে, স্কোপগুলি চয়ন করুন

আপনার পরিবেশ সেট আপ করুন

নিম্নলিখিত বিভাগটি গুগল ওয়ার্কস্পেস সাবস্ক্রিপশন তৈরির আগে কীভাবে আপনার পরিবেশ সেট আপ করবেন তা ব্যাখ্যা করে।

গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং গুগল ক্লাউড পাব/সাব এপিআই সক্ষম করুন

গুগল এপিআই ব্যবহার করার আগে আপনাকে এগুলি একটি গুগল ক্লাউড প্রকল্পে চালু করতে হবে। আপনি একক গুগল ক্লাউড প্রকল্পে এক বা একাধিক এপিআই চালু করতে পারেন।

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

গুগল ক্লাউড কনসোলে, আপনার অ্যাপ্লিকেশনটির জন্য গুগল ক্লাউড প্রকল্পটি খুলুন এবং গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং পাব/সাব এপিআই সক্ষম করুন:

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

জিক্লাউড

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

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

    gcloud config set project PROJECT_ID

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

  3. গুগল ওয়ার্কস্পেস ইভেন্টগুলি এপিআই এবং গুগল ক্লাউড পাব/সাব এপিআই সক্ষম করুন:

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

OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলি তৈরি করুন

কীভাবে একটি OAuth ক্লায়েন্ট আইডি তৈরি করবেন সে সম্পর্কে নির্দিষ্ট নির্দেশাবলীর জন্য আপনার অ্যাপ্লিকেশন প্রকারটি চয়ন করুন:

ওয়েব অ্যাপ্লিকেশন

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ওয়েব অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. আপনার অ্যাপ্লিকেশন সম্পর্কিত অনুমোদিত ইউআরআই যুক্ত করুন:
    • ক্লায়েন্ট-সাইড অ্যাপস (জাভাস্ক্রিপ্ট) -অনুমোদিত জাভাস্ক্রিপ্ট উত্সের অধীনে, ইউআরআই যুক্ত করুন ক্লিক করুন। তারপরে, ব্রাউজারের অনুরোধগুলির জন্য ব্যবহার করতে একটি ইউআরআই প্রবেশ করুন। এটি ডোমেনগুলি সনাক্ত করে যা থেকে আপনার অ্যাপ্লিকেশনটি ওএউথ 2.0 সার্ভারে এপিআই অনুরোধগুলি প্রেরণ করতে পারে।
    • সার্ভার-সাইড অ্যাপ্লিকেশনগুলি (জাভা, পাইথন এবং আরও অনেক কিছু) -অনুমোদিত অনুমোদিত পুনর্নির্দেশ ইউআরআইএস , ইউআরআই যুক্ত করুন ক্লিক করুন। তারপরে, একটি শেষ পয়েন্ট ইউআরআই প্রবেশ করুন যেখানে OAuth 2.0 সার্ভার প্রতিক্রিয়া প্রেরণ করতে পারে।
  6. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রগুলি OAuth 2.0 ক্লায়েন্ট আইডির অধীনে প্রদর্শিত হবে।

    ক্লায়েন্ট আইডি নোট করুন। ক্লায়েন্টের গোপনীয়তা ওয়েব অ্যাপ্লিকেশনগুলির জন্য ব্যবহৃত হয় না।

অ্যান্ড্রয়েড

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > অ্যান্ড্রয়েড ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "প্যাকেজ নাম" ক্ষেত্রে, আপনার AndroidManifest.xml ফাইল থেকে প্যাকেজের নাম লিখুন।
  6. "SHA-1 শংসাপত্র ফিঙ্গারপ্রিন্ট" ক্ষেত্রে, আপনার উত্পন্ন SHA-1 শংসাপত্রের ফিঙ্গারপ্রিন্ট প্রবেশ করুন।
  7. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

iOS

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > আইওএস ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "বান্ডিল আইডি" ক্ষেত্রে, অ্যাপের Info.plist ফাইলে তালিকাভুক্ত হিসাবে বান্ডিল আইডেন্টিফায়ার লিখুন।
  6. Ption চ্ছিক: যদি আপনার অ্যাপটি অ্যাপল অ্যাপ স্টোরে উপস্থিত হয় তবে অ্যাপ স্টোর আইডি লিখুন।
  7. Ption চ্ছিক: "টিম আইডি" ক্ষেত্রে, অ্যাপল দ্বারা উত্পাদিত এবং আপনার দলকে নির্ধারিত অনন্য 10-চরিত্রের স্ট্রিংটি প্রবেশ করুন।
  8. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ক্রোম অ্যাপ

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ক্রোম এক্সটেনশন ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. "আইটেম আইডি" ক্ষেত্রে, আপনার অ্যাপ্লিকেশনটির অনন্য 32-চরিত্র আইডি স্ট্রিং লিখুন। আপনি এই আইডি মানটি আপনার অ্যাপের ক্রোম ওয়েব স্টোর ইউআরএল এবং ক্রোম ওয়েব স্টোর বিকাশকারী ড্যাশবোর্ডে খুঁজে পেতে পারেন।
  6. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ডেস্কটপ অ্যাপ

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ডেস্কটপ অ্যাপ্লিকেশন ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

টিভি এবং সীমিত ইনপুট ডিভাইস

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন টাইপ > টিভি এবং সীমিত ইনপুট ডিভাইসগুলিতে ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. তৈরি করুন ক্লিক করুন।

    সদ্য নির্মিত শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (UWP)

  1. গুগল ক্লাউড কনসোলে, মেনু যান > > ক্লায়েন্ট

    ক্লায়েন্টদের কাছে যান

  2. ক্লায়েন্ট তৈরি ক্লিক করুন।
  3. অ্যাপ্লিকেশন প্রকার > ইউনিভার্সাল উইন্ডোজ প্ল্যাটফর্ম (ইউডাব্লুপি) ক্লিক করুন।
  4. "নাম" ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি কেবল গুগল ক্লাউড কনসোলে দেখানো হয়েছে।
  5. In the "Store ID" field, enter your app's unique, 12-character Microsoft Store ID value. You can find this ID in your app's Microsoft Store URL and in the Partner Center .
  6. তৈরি করুন ক্লিক করুন।

    The newly created credential appears under "OAuth 2.0 Client IDs."

Download the client secret JSON file

The client secret file is a JSON representation of the OAuth client ID credentials that your app can reference when providing credentials.

  1. In the Google Cloud console, go to Menu > APIs & Services > Credentials .

    Go to Credentials

  2. Under OAuth 2.0 Client IDs , click the client ID that you created.

  3. Click Download JSON .

  4. Save the file as client_secrets.json .

Create and subscribe to a Pub/Sub topic

In this section, you create a Pub/Sub topic and subscription to the topic. Your Pub/Sub topic serves as the notification endpoint where your Google Workspace subscription receives events.

To learn more about creating and managing Pub/Sub topics, see the Pub/Sub documentation .

To create and subscribe to a Pub/Sub topic:

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

  1. In the Google Cloud console, go to the Pub/Sub page:

    Go to Google Cloud Pub/Sub

    Make sure that the Cloud project for your app is selected.

  2. Click Create topic and do the following:

    1. Enter a name for your topic, such as workspace-events-topic .
    2. Leave Add a default subscription selected. Pub/Sub names this default subscription similar to your topic's name, such as workspace-events-topic-sub .
    3. Optional: Update or configure additional properties for your topic.
  3. তৈরি করুন ক্লিক করুন। Your full topic name is formatted as projects/ PROJECT_ID /topics/ TOPIC_ID . You use this full name in a later step.

  4. Grant access to publish Pub/Sub messages to your topic:

    1. On your topic's page, go to the side panel and open the Permissions tab.
    2. Click Add Principal .
    3. In the Add principals field, add the service account for the Google Workspace application that delivers events to your subscription:
      1. For Chat events, chat-api-push@system.gserviceaccount.com .
      2. For Meet events, meet-api-event-push@system.gserviceaccount.com .
    4. In the Assign roles menu, select Pub/Sub Publisher .
    5. Save এ ক্লিক করুন। It can take a few minutes to update the permissions for your topic.

জিক্লাউড

  1. In your Cloud project, create a topic by running the following command:

    gcloud pubsub topics create TOPIC_ID

    Replace TOPIC_ID with a unique ID for your topic, such as workspace-events-topic .

    The output displays the full topic name, formatted as projects/ PROJECT_ID /topics/ TOPIC_ID . Make note of the name, and make sure the value for PROJECT_ID is the Cloud project ID for your app. You use the topic name in the following step, and to create the Google Workspace subscription later.

  2. Grant access to publish messages to your topic:

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

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

    • TOPIC_NAME : The full topic name, which is the output from the previous step. Formatted as projects/ PROJECT_ID /topics/ TOPIC_ID .
    • GOOGLE_WORKSPACE_APPLICATION : The Google Workspace application that must deliver events to your subscription:

      • To receive events from Chat, use chat-api-push@system.gserviceaccount.com .
      • To receive events from Meet, use meet-api-event-push@system.gserviceaccount.com .

    It can take a few minutes to update the permissions for your topic.

  3. Create a Pub/Sub subscription for the topic:

     gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

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

    • SUBSCRIPTION_NAME : A name for your subscription, such as workspace-events-subscription .
    • TOPIC_NAME : The name of your topic that you created in the previous step.

Subscribe to a Google Workspace resource

In this section, you subscribe to the Google Workspace resource that you want to monitor for events.

Choose and identify the target resource

In a Google Workspace subscription, the target resource is the Google Workspace resource that you monitor for events. The target resource is represented in the subscription's targetResource field, formatted using the full resource name. For example, for a subscription that monitors a Google Chat space ( spaces/AAAABBBBBBB ), the value of the targetResource is //chat.googleapis.com/spaces/AAAABBBBBBB .

Before you create the subscription, use the following sections to learn how to identify and format the target resource.

Identify a target resource for Chat

Target resource বিন্যাস সীমাবদ্ধতা
স্থান

//chat.googleapis.com/spaces/ SPACE

where SPACE is the ID in the resource name of the Chat API space resource. You can obtain the ID from the space's URL or using the spaces.list() method.

The Chat user that authorizes the subscription must be a member of the space through their Google Workspace or Google Account.
All spaces for a user

//chat.googleapis.com/spaces/-

The subscription only receives events for the spaces where the user is a member through their Google Workspace or Google Account.
ব্যবহারকারী

//cloudidentity.googleapis.com/users/ USER

where USER is the ID in the resource name of the Chat API user resource. For details, see Identify and specify Google Chat users .

The subscription only receives events about the user that authorized the subscription. A user can't authorize a subscription on behalf of other users.

Identify a target resource for Meet

Target resource বিন্যাস Limitations (if applicable)
মিটিং স্পেস //meet.googleapis.com/spaces/ SPACE

where SPACE is the ID in the resource name of the Meet REST API space resource. For details, see How Meet identifies a meeting space .

ব্যবহারকারী //cloudidentity.googleapis.com/users/ USER

where USER is the ID in the signedinUser.user field of the Meet REST API participant resource. For details, see Work with participants .

The subscription receives events about meeting spaces where the user is one of the following:

  • The owner of the meeting space.
  • A participant in the meeting space.
  • The organizer of the Google Calendar event associated with the meeting space.

Create a Google Workspace subscription

To create a subscription, you use the Google Workspace Events API's subscriptions.create() method to create a Subscription resource. You specify the following fields:

  • targetResource : A Google Workspace that you identified in the previous section , formatted using its full resource name.
  • eventTypes : An array of one or more event types you want to receive about the resource. For example, if your app only needs to know about new messages posted to a Chat space, your app can just subscribe to events about created messages.
  • notificationEndpoint : A notification endpoint where your Google Workspace subscription delivers events. You use the Pub/Sub topic that you created in the previous section.
  • payloadOptions : Options to specify how much resource data to include in the event payload. This configuration affects the expiration time for your subscription. To learn more, see Event data .

To create a Google Workspace subscription:

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

  1. In your Apps Script project, create a new script file named createSubscription and add the following code:

    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 : The Google Workspace resource that you're subscribing to, formatted as its full resource name. For example, to subscribe to a Google Chat space with the space ID AAAABBBB , use //chat.googleapis.com/spaces/AAAABBBB .
    • EVENT_TYPES : One or more event types that you want to subscribe to in the target resource. Format as an array of strings such as 'google.workspace.chat.message.v1.created' .
    • TOPIC_NAME : The full name of the Pub/Sub topic that you created in your Cloud project. Formatted as projects/ PROJECT_ID /topics/ TOPIC_ID .
    • RESOURCE_DATA : A boolean that specifies whether the subscription includes resource data in the payload:

      • True : Includes all resource data. To limit which fields are included, add the fieldMask field and specify at least one field for the changed resource. Only subscriptions to Chat resources support including resource data.
      • False : Excludes resource data.
  2. To create the Google Workspace subscription, run the function createSubscription in your Apps Script project.

পাইথন

  1. In your working directory, create a file named create_subscription.py and add the following code:

    """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 : One or more OAuth scopes that support each event type for the subscription. Formatted as an array of strings. To list multiple scopes, separate by commas. For example, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly' .
    • TARGET_RESOURCE : The Google Workspace resource that you're subscribing to, formatted as its full resource name. For example, to subscribe to a Google Chat space with the space ID AAAABBBB , use //chat.googleapis.com/spaces/AAAABBBB .
    • EVENT_TYPES : One or more event types that you want to subscribe to in the target resource. Format as an array of strings such as 'google.workspace.chat.message.v1.created' .
    • TOPIC_NAME : The full name of the Pub/Sub topic that you created in your Cloud project. Formatted as projects/ PROJECT_ID /topics/ TOPIC_ID .
    • RESOURCE_DATA : A boolean that specifies whether the subscription includes resource data in the payload:

      • True : Includes all resource data. To limit which fields are included, add the fieldMask field and specify at least one field for the changed resource. Only subscriptions to Chat resources support including resource data.
      • False : Excludes resource data.
  2. To create the Google Workspace subscription, run the following in your terminal:

    python3 create_subscription.py

The Google Workspace Events API returns a completed long-running operation that contains the instance of the Subscription resource that you created.

Test your Google Workspace subscription

To test that you're receiving Google Workspace events, you can trigger an event and pull messages to the Pub/Sub subscription.

To test your Google Workspace subscription:

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

  1. Trigger one or more types of events in the target resource of your Google Workspace subscription. For example, if you've subscribed to new messages in a Chat space, post a message to the space.

  2. In the Google Cloud console, go to the Pub/Sub page:

    Go to Pub/Sub

    Make sure that the Cloud project for your app is selected.

  3. In the Pub/Sub menu, click Subscriptions .

  4. In the table, find the Pub/Sub subscription for your topic and click the subscription name.

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

  6. Click Pull . It can take up to a few minutes for an event to generate a Pub/Sub message.

জিক্লাউড

  1. Trigger one or more types of events in the target resource of your Google Workspace subscription. For example, if you've subscribed to new messages in a Chat space, post a message in the space.

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

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

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

    • PUBSUB_SUBSCRIPTION_NAME : The full name of your Pub/Sub subscription, formatted as projects/ SUBSCRIPTION_ID /subscriptions/ SUBSCRIPTION_ID .
    • MESSAGE_COUNT : The maximum number of Pub/Sub messages you want to pull.

    It can take up to a few minutes for an event to generate a Pub/Sub message.

For each Google Workspace event that you triggered, a message is delivered to your Pub/Sub subscription that contains the event. For details, see Receiving events as Google Cloud Pub/Sub messages .

Configure how your app receives events

The Pub/Sub subscription that you created is pull-based. After you've tested that your Pub/Sub subscription, you can update the delivery type to change how your app receives events. For example, you can configure the Pub/Sub subscription to a push delivery type, so that your app can receive events directly to an app endpoint.

To learn about configuring a Pub/Sub subscription, see the Pub/Sub documentation .