Google Workspace Events API ব্যবহার করে ইভেন্টে সদস্যতা নিন

এই পৃষ্ঠাটি Google Workspace Events API-এর একটি ওভারভিউ প্রদান করে এবং Google Workspace জুড়ে ইভেন্ট সাবস্ক্রাইব করার জন্য আপনি কীভাবে API ব্যবহার করতে পারেন তা ব্যাখ্যা করে।

Google Workspace ইভেন্টগুলি Google Workspace রিসোর্সে পরিবর্তন দেখায়, যেমন রিসোর্স তৈরি করা, আপডেট করা বা মুছে ফেলা হয়। আপনার অ্যাপটি Google Workspace রিসোর্সে সাবস্ক্রাইব করতে পারে যাতে আপনি আপনার আগ্রহের প্রাসঙ্গিক ইভেন্টগুলি পান।

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

আপনার অ্যাপকে Google Workspace ইভেন্টগুলি পেতে দিতে, আপনি Google Workspace রিসোর্সে সাবস্ক্রিপশন তৈরি করতে Google Workspace ইভেন্ট API ব্যবহার করেন।

Google Workspace Events API কীভাবে ইভেন্ট ডেলিভার করে তার উদাহরণ।
চিত্র 1. Google Workspace Events API কীভাবে Chat অ্যাপে ইভেন্ট ডেলিভার করে তার উদাহরণ।

নিম্নলিখিত উদাহরণে, Google Workspace Events API কীভাবে সাবস্ক্রিপশনের মাধ্যমে Google Chat অ্যাপে ইভেন্ট ডেলিভার করে তা এখানে দেওয়া হল:

  1. একটি চ্যাট অ্যাপ একটি চ্যাট স্পেসে সদস্যতা নেয়।
  2. চ্যাটের স্থান পরিবর্তন হয়। উদাহরণস্বরূপ, স্পেসে একটি নতুন বার্তা পোস্ট করা হয়েছে।
  3. চ্যাট Google ক্লাউড পাব/সাব -এ একটি বিষয়ে একটি ইভেন্ট ডেলিভার করে, যা সাবস্ক্রিপশনের জন্য বিজ্ঞপ্তির শেষ পয়েন্ট হিসেবে কাজ করে। ইভেন্টে কী পরিবর্তন হয়েছে সে সম্পর্কে ডেটা রয়েছে৷ উদাহরণস্বরূপ, একটি নতুন বার্তা সম্পর্কে একটি ইভেন্টের জন্য, ইভেন্টটিতে তৈরি করা Message সংস্থান সম্পর্কে বিশদ রয়েছে৷
  4. চ্যাট অ্যাপটি Google ক্লাউড পাব/সাব মেসেজ প্রসেস করে যাতে ইভেন্টটি থাকে এবং প্রয়োজনে ব্যবস্থা নেয়।

গুরুত্বপূর্ণ পরিভাষা

Google Workspace Events API-এ ব্যবহৃত সাধারণ পদগুলির একটি তালিকা নিচে দেওয়া হল:

Google Workspace ইভেন্ট

Google Workspace রিসোর্সে পরিবর্তন। ইভেন্টগুলি CloudEvents স্পেসিফিকেশন ব্যবহার করে ফরম্যাট করা হয়, এবং হয় একটি সাবস্ক্রিপশন ইভেন্ট বা একটি জীবনচক্র ইভেন্ট হতে পারে:

সদস্যতা ইভেন্ট
Google Workspace রিসোর্সে একটি পরিবর্তন যা আপনি পর্যবেক্ষণ করছেন, যেমন Google Chat স্পেসে একটি নতুন মেসেজ। পরিবর্তিত সম্পদ সম্পর্কে আপনি কতটা বিস্তারিত পেতে চান তা উল্লেখ করতে পারেন। বিস্তারিত জানতে, Google Workspace ইভেন্টের কাঠামো দেখুন।
জীবনচক্র ইভেন্ট
আপনার Google Workspace সদস্যতা সম্পর্কে একটি ইভেন্ট। লাইফসাইকেল ইভেন্টগুলি আপনাকে সমস্যাগুলি এবং আপনার সদস্যতার অবস্থা সম্পর্কে অবহিত করে যাতে আপনি অনুপস্থিত সদস্যতা ইভেন্টগুলি এড়াতে পারেন। ডিফল্টরূপে, আপনার সদস্যতা সর্বদা লাইফসাইকেল ইভেন্টগুলি গ্রহণ করে৷ বিস্তারিত জানতে, Google Workspace সাবস্ক্রিপশনের লাইফসাইকেল ইভেন্ট দেখুন।
Google Workspace সদস্যতা

Google Workspace অ্যাপ্লিকেশান থেকে একটি রিসোর্স নিরীক্ষণ করে এমন একটি নাম দেওয়া সত্তা। একটি সদস্যতা একটি Subscription সম্পদ দ্বারা প্রতিনিধিত্ব করা হয়. একটি সাবস্ক্রিপশন নিম্নলিখিত তথ্য দ্বারা সংজ্ঞায়িত করা হয়:

লক্ষ্য সম্পদ
আপনি যে Google Workspace রিসোর্স নিরীক্ষণ করতে চান। এই রিসোর্সটি Google Workspace সাবস্ক্রিপশনের targetResource ফিল্ডে দেখানো হয়। প্রতিটি সদস্যতা শুধুমাত্র একটি সম্পদ নিরীক্ষণ করতে পারে. Google Workspace ইভেন্ট এপিআই কোন Google Workspace রিসোর্স সমর্থন করে তা দেখতে, সমর্থিত Google Workspace ইভেন্টগুলি দেখুন।
ইভেন্টের ধরন
লক্ষ্য সম্পদের জন্য আপনি যে ধরনের পরিবর্তনগুলি সম্পর্কে অবহিত হতে চান। উদাহরণস্বরূপ, আপনি যদি একটি Google চ্যাট স্পেস সাবস্ক্রাইব করে থাকেন তবে আপনি স্পেস এবং এর চাইল্ড রিসোর্স, যেমন সদস্যতা এবং বার্তাগুলি সম্পর্কে ইভেন্টগুলি পাবেন কিনা তা চয়ন করতে পারেন৷
বিজ্ঞপ্তির শেষ বিন্দু
শেষ পয়েন্ট যেখানে Google Workspace সাবস্ক্রিপশন ইভেন্ট গ্রহণ করে। Google Workspace Events API Google ক্লাউড পাব/সাব বিষয়গুলিকে নোটিফিকেশন এন্ডপয়েন্ট হিসেবে সমর্থন করে। Google Cloud Pub/Sub ব্যবহার সম্পর্কে আরও জানতে, Google Cloud Pub/Sub ডকুমেন্টেশন দেখুন।
পেলোড বিকল্প
পরিবর্তিত সম্পদ সম্পর্কে আপনি যে ইভেন্ট ডেটা পেতে চান।

সমর্থিত Google Workspace ইভেন্ট

আপনার অ্যাপ যে ইভেন্টগুলি পেতে পারে তা আপনার সদস্যতার লক্ষ্য সংস্থানের উপর নির্ভর করে। নিম্নলিখিত সারণী প্রতিটি সম্ভাব্য লক্ষ্য সম্পদের জন্য সমর্থিত ইভেন্টগুলি প্রদর্শন করে।

লক্ষ্য সম্পদ সমর্থিত ঘটনা
Google চ্যাট স্পেস
  • বার্তা
  • সদস্যপদ
  • প্রতিক্রিয়া
  • স্থান
গুগল চ্যাট ব্যবহারকারীরা
  • সদস্যপদ
Google Meet মিটিং স্পেস
  • সম্মেলন
  • অংশগ্রহণকারী সেশন
  • রেকর্ডিং
  • প্রতিলিপি
Google Meet ব্যবহারকারীরা
  • সম্মেলন
  • অংশগ্রহণকারী সেশন
  • রেকর্ডিং
  • প্রতিলিপি

আরও জানতে, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

Google Workspace ইভেন্টের কাঠামো

Google Workspace ইভেন্ট CloudEvents স্পেসিফিকেশন অনুসরণ করে, যা ইভেন্ট ডেটা বর্ণনা করার একটি ইন্ডাস্ট্রি-স্ট্যান্ডার্ড উপায়। Google Workspace ইভেন্টে নিম্নলিখিতগুলি থাকে:

  • ক্লাউড ইভেন্টের বৈশিষ্ট্য
  • ইভেন্টের ফলে পরিবর্তিত Google Workspace রিসোর্স সম্পর্কে ডেটা

নিম্নলিখিত বিভাগে Google Workspace ইভেন্টের জন্য অ্যাট্রিবিউট এবং ডেটার গঠন ব্যাখ্যা করা হয়েছে।

CloudEvent বৈশিষ্ট্য

Google Workspace ইভেন্টে নিম্নলিখিত প্রয়োজনীয় CloudEvents বৈশিষ্ট্যগুলি রয়েছে:

বৈশিষ্ট্য বর্ণনা উদাহরণ

datacontenttype

ইভেন্টে যে ধরনের ডেটা পাস করা হয়েছে।

application/json

id

CloudEvent এর জন্য একটি শনাক্তকারী।

spaces/AAAABBBBBBB/spaceEvents/ABCDEFGHIJKLMNO

source

ঘটনার উৎস। Google Workspace ইভেন্টের জন্য, এটি হল সাবস্ক্রিপশনের সম্পূর্ণ রিসোর্সের নাম। //workspaceevents.googleapis.com/subscriptions/chat-spaces-abcdefg

specversion

এই ইভেন্টের জন্য ব্যবহৃত CloudEvents স্পেসিফিকেশন সংস্করণ।

1.0

subject

Google Workspace রিসোর্স যেখানে ইভেন্টটি ঘটেছে।

//chat.googleapis.com/spaces/AAAABBBBBBB

time

RFC 3339 ফর্ম্যাটে ইভেন্টটি হওয়ার সময় টাইমস্ট্যাম্প৷

2023-09-07T21:37:36.260127Z

type

Google Workspace ইভেন্টের ধরন।

google.workspace.chat.message.v1.created

ইভেন্ট ডেটা

ইভেন্ট ডেটা হল একটি পেলোড যা আপনার সাবস্ক্রিপশনের টার্গেট রিসোর্সে পরিবর্তনের প্রতিনিধিত্ব করে, যার মধ্যে টার্গেট রিসোর্সের চাইল্ড রিসোর্স রয়েছে। আপনার সাবস্ক্রিপশনে, আপনি নির্দিষ্ট করতে পারেন যে আপনি পরিবর্তিত সংস্থান সম্পর্কে ডেটা অন্তর্ভুক্ত করতে চান কিনা বা পরিবর্তিত সংস্থানের নাম।

উদাহরণস্বরূপ, যদি আপনার একটি চ্যাট স্পেসের সদস্যতা থাকে, তাহলে আপনি স্পেসে নতুন বার্তাগুলি সম্পর্কে ইভেন্টগুলি পেতে পারেন৷ নতুন বার্তা সম্পর্কে ইভেন্টের জন্য, ইভেন্ট ডেটাতে Chat spaces.message রিসোর্সের সাথে একটি পেলোড থাকে যা তৈরি করা হয়েছিল।

আপনি যখন একটি সদস্যতা তৈরি করেন, তখন আপনি উল্লেখ করতে পারেন যে আপনার অ্যাপটি প্রাপ্ত ইভেন্টগুলিতে কতটা রিসোর্স ডেটা অন্তর্ভুক্ত করা হয়েছে:

  • সম্পদ তথ্য অন্তর্ভুক্ত করুন: পরিবর্তিত সম্পদের কিছু বা সমস্ত ক্ষেত্র রয়েছে। আপনি যদি রিসোর্স ডেটা অন্তর্ভুক্ত করতে বেছে নেন, তাহলে আপনার সাবস্ক্রিপশনের সময়কাল 4 ঘন্টা পর্যন্ত বা 24 ঘন্টা পর্যন্ত সীমাবদ্ধ থাকে যদি আপনি ডোমেন-ওয়াইড ডেলিগেশন ব্যবহার করেন।
  • রিসোর্স ডেটা বাদ দিন : শুধুমাত্র পরিবর্তিত রিসোর্সের নাম ধারণ করে। আপনার সদস্যতার সময়কাল 7 দিন পর্যন্ত। ইভেন্ট সম্পর্কে বিশদ বিবরণ পেতে, আপনি সম্পদের নাম ব্যবহার করে সংস্থানটি জিজ্ঞাসা করতে পারেন।

ইভেন্ট ডেটার জন্য এই বিকল্পগুলি আপনার সাবস্ক্রিপশনের payloadOptions ক্ষেত্রে উপস্থাপন করা হয়।

Google Cloud Pub/Sub বার্তা হিসাবে ইভেন্ট

Google Workspace ইভেন্ট এপিআই সাবস্ক্রিপশন Google ক্লাউড পাব/সাব বিষয়গুলিকে বিজ্ঞপ্তির শেষ পয়েন্ট হিসাবে ব্যবহার করে যা Google Workspace ইভেন্টগুলি গ্রহণ করে। ইভেন্টগুলি Google Cloud Pub/Sub বার্তা হিসাবে এনকোড করা হয়৷ আপনার অ্যাপ পদক্ষেপ নিতে বা ইভেন্টে প্রতিক্রিয়া জানাতে Google Cloud Pub/Sub বার্তা প্রক্রিয়া করতে পারে।

নিম্নলিখিত উদাহরণটি একটি Google ক্লাউড পাব/সাব বার্তা দেখায় যাতে একটি চ্যাট স্পেসে একটি আপডেট করা বার্তা সম্পর্কে একটি ইভেন্ট রয়েছে:

 {
    "message":
    {
        "attributes":
        {
            "ce-datacontenttype": "application/json",
            "ce-id": "spaces/SPACE_ID/spaceEvents/SPACE_EVENT_ID",
            "ce-source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
            "ce-specversion": "1.0",
            "ce-subject": "//chat.googleapis.com/spaces/SPACE_ID",
            "ce-time": "2023-09-07T21:37:53.274191Z",
            "ce-type": "google.workspace.chat.message.v1.updated"
        },
        "data": "EVENT_DATA",
        "messageId": "PUBSUB_MESSAGE_ID",
        "orderingKey": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
        "publishTime": "2023-09-07T21:37:53.713Z"
    }
}

নিম্নলিখিত ক্ষেত্র নোট করুন:

  • attributes : ক্লাউড ইভেন্টের জন্য বৈশিষ্ট্য , যা ইভেন্টের ধরন অন্তর্ভুক্ত করে। এই ক্ষেত্রে, ঘটনাটি স্থানের একটি আপডেট করা বার্তা সম্পর্কে।
  • data : আপডেট করা spaces.message রিসোর্স সম্পর্কে বিশদ বিবরণ সহ ইভেন্ট ডেটা , একটি Base64-এনকোডেড স্ট্রিং হিসাবে ফর্ম্যাট৷
  • messageId : Google Cloud Pub/Sub বার্তার শনাক্তকারী।

Google ক্লাউড পাব/সাব বার্তাগুলিতে ক্লাউড ইভেন্টগুলি কীভাবে নির্দিষ্ট করা হয় সে সম্পর্কে আরও জানতে, ক্লাউড ইভেন্টের জন্য Google ক্লাউড পাব/সাব প্রোটোকল বাইন্ডিং দেখুন।