একটি 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 চ্যাট স্পেস-এ সদস্যতা নিতে, একটি চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী একজন সদস্য। ব্যবহারকারীকে অবশ্যই তাদের Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে স্পেস-এর সদস্য হতে হবে (যে ব্যবহারকারীরা Google Group-এর মাধ্যমে কোনও স্পেস-এর সদস্য, তারা সমর্থিত নয়)।
    • Google Meet মিটিং স্পেসে সাবস্ক্রাইব করতে, একটি মিটিং স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী মালিক। একটি স্পেস তৈরি করতে, Google Meet ডকুমেন্টেশনে, মিটিং স্পেসের সাথে কাজ দেখুন।
    • Google Meet ব্যবহারকারীর সদস্যতা নিতে, ক্লাউড আইডেন্টিটি API-এর user আইডি
  • বিলিং সক্ষম সহ একটি 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 চ্যাট স্পেস-এ সদস্যতা নিতে, একটি চ্যাট স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী একজন সদস্য। ব্যবহারকারীকে অবশ্যই তাদের Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে স্পেস-এর সদস্য হতে হবে (যে ব্যবহারকারীরা Google Group-এর মাধ্যমে কোনও স্পেস-এর সদস্য, তারা সমর্থিত নয়)।
    • Google Meet মিটিং স্পেসে সাবস্ক্রাইব করতে, একটি মিটিং স্পেস যেখানে প্রমাণীকৃত ব্যবহারকারী মালিক। একটি স্পেস তৈরি করতে, Google Meet ডকুমেন্টেশনে, মিটিং স্পেসের সাথে কাজ দেখুন।
    • Google Meet ব্যবহারকারীর সদস্যতা নিতে, ক্লাউড আইডেন্টিটি API-এর user আইডি
  • বিলিং সক্ষম সহ একটি 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 ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

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

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

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

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

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

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

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

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

iOS

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

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

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

ক্রোম অ্যাপ

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

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

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

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

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

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

  2. ক্রিয়েট ক্রেডেনশিয়াল > OAuth ক্লায়েন্ট আইডি ক্লিক করুন।
  3. Application type > Desktop app এ ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
  5. তৈরি করুন ক্লিক করুন। OAuth ক্লায়েন্ট তৈরি করা স্ক্রীন প্রদর্শিত হবে, আপনার নতুন ক্লায়েন্ট আইডি এবং ক্লায়েন্টের গোপনীয়তা দেখাচ্ছে।
  6. ওকে ক্লিক করুন। নতুন তৈরি শংসাপত্রটি OAuth 2.0 ক্লায়েন্ট আইডিগুলির অধীনে প্রদর্শিত হয়৷

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

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

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

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

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

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

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

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

এই বিভাগে, আপনি 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 ক্লাউড পাব/সাব বার্তা হিসাবে ইভেন্ট গ্রহণ করা দেখুন।

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

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

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