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

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

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

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

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

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

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

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

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

গুগল ওয়ার্কস্পেস ইভেন্ট

গুগল ওয়ার্কস্পেস রিসোর্সে একটি পরিবর্তন। ইভেন্টগুলি ক্লাউডইভেন্টস স্পেসিফিকেশন ব্যবহার করে ফর্ম্যাট করা হয় এবং এটি সাবস্ক্রিপশন ইভেন্ট বা লাইফসাইকেল ইভেন্ট হতে পারে:

সাবস্ক্রিপশন ইভেন্ট

আপনি যে Google Workspace রিসোর্সটি পর্যবেক্ষণ করছেন তাতে কোনও পরিবর্তন, যেমন Google Chat স্পেসে একটি নতুন বার্তা। পরিবর্তিত রিসোর্স সম্পর্কে আপনি কতটা বিশদ জানতে চান তা নির্দিষ্ট করতে পারেন। বিস্তারিত জানার জন্য, Google Workspace ইভেন্টের কাঠামো দেখুন।

জীবনচক্র ইভেন্ট

আপনার Google Workspace সাবস্ক্রিপশন সম্পর্কে একটি ইভেন্ট। লাইফসাইকেল ইভেন্টগুলি আপনাকে সমস্যা এবং আপনার সাবস্ক্রিপশনের অবস্থা সম্পর্কে অবহিত করে যাতে আপনি সাবস্ক্রিপশন ইভেন্ট মিস না করতে পারেন। ডিফল্টরূপে, আপনার সাবস্ক্রিপশন সর্বদা লাইফসাইকেল ইভেন্টগুলি পায়। বিস্তারিত জানার জন্য, Google Workspace সাবস্ক্রিপশনের জন্য লাইফসাইকেল ইভেন্টগুলি দেখুন।

Google Workspace সাবস্ক্রিপশন

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

লক্ষ্য সম্পদ

আপনি যে Google Workspace রিসোর্সটি পর্যবেক্ষণ করতে চান। এই রিসোর্সটি Google Workspace সাবস্ক্রিপশনের targetResource ফিল্ডে প্রদর্শিত হয়। প্রতিটি সাবস্ক্রিপশন শুধুমাত্র একটি রিসোর্স পর্যবেক্ষণ করতে পারে। Google Workspace Events API কোন Google Workspace রিসোর্সগুলিকে সমর্থন করে তা দেখতে, সমর্থিত Google Workspace ইভেন্টগুলি দেখুন।

ইভেন্টের ধরণ

টার্গেট রিসোর্সের জন্য আপনি যে ধরণের পরিবর্তন সম্পর্কে বিজ্ঞপ্তি পেতে চান। উদাহরণস্বরূপ, আপনি যদি কোনও Google Chat স্পেসে সাবস্ক্রাইব করে থাকেন, তাহলে আপনি স্পেস এবং এর চাইল্ড রিসোর্স, যেমন মেম্বারশিপ এবং মেসেজ সম্পর্কে ইভেন্টগুলি গ্রহণ করবেন কিনা তা বেছে নিতে পারেন।

বিজ্ঞপ্তির শেষ বিন্দু

Google Workspace সাবস্ক্রিপশন ইভেন্ট গ্রহণের শেষ বিন্দু। Google Workspace Events API Google Cloud Pub/Sub বিষয়গুলিকে বিজ্ঞপ্তির শেষ বিন্দু হিসেবে সমর্থন করে। Google Cloud Pub/Sub ব্যবহার সম্পর্কে আরও জানতে, Google Cloud Pub/Sub ডকুমেন্টেশন দেখুন।

পেলোড বিকল্পগুলি

পরিবর্তিত সম্পদ সম্পর্কে আপনি যে ইভেন্ট ডেটা পেতে চান।

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

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

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

• Google Chat ইভেন্টে সাবস্ক্রাইব করুন
• গুগল ড্রাইভ ইভেন্টগুলিতে সাবস্ক্রাইব করুন
• Google Meet ইভেন্টে সাবস্ক্রাইব করুন

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

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

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

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

ক্লাউডইভেন্ট বৈশিষ্ট্যাবলী

Google Workspace ইভেন্টগুলিতে নিম্নলিখিত প্রয়োজনীয় CloudEvents অ্যাট্রিবিউট থাকে:

ইভেন্ট ডেটা

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

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

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

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

Google ক্লাউড পাব/সাব বার্তা হিসেবে ইভেন্টগুলি

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

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

 {
    "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 : CloudEvent এর জন্য attributes , যার মধ্যে ইভেন্টের ধরণ অন্তর্ভুক্ত থাকে। এই ক্ষেত্রে, ইভেন্টটি স্পেসে একটি আপডেট করা বার্তা সম্পর্কে।
• data : আপডেট করা spaces.message রিসোর্স সম্পর্কে বিশদ সহ ইভেন্ট ডেটা , যা Base64-এনকোডেড স্ট্রিং হিসাবে ফর্ম্যাট করা হয়েছে।
• messageId : গুগল ক্লাউড পাব/সাব মেসেজের শনাক্তকারী।

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

সম্পর্কিত বিষয়

• Google Workspace Events API স্কোপ বেছে নিন
• একটি Google Workspace সাবস্ক্রিপশন তৈরি করুন