এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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 কীভাবে ইভেন্ট ডেলিভার করে তার উদাহরণ।

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

আপনার অ্যাপটি Google Workspace অ্যাপ্লিকেশনের রিসোর্সে সাবস্ক্রাইব করে, যেমন Google Chat স্পেস।
আপনি যে সংস্থানটিতে সদস্যতা নিয়েছেন তা পরিবর্তন হয়৷
Google Workspace অ্যাপ্লিকেশানটি Google Cloud Pub/Sub- এ একটি বিষয়ের জন্য একটি ইভেন্ট ডেলিভার করে, যেটি আপনার Google Workspace সাবস্ক্রিপশনের জন্য বিজ্ঞপ্তির শেষ পয়েন্ট হিসেবে কাজ করে। ইভেন্টে রিসোর্সে কী পরিবর্তন হয়েছে সে সম্পর্কে ডেটা রয়েছে।
আপনার অ্যাপটি 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 চ্যাট স্পেস	`//chat.googleapis.com/spaces/ SPACE_ID`	বার্তা সদস্যপদ প্রতিক্রিয়া স্থান বিস্তারিত জানার জন্য, Google Chat ইভেন্টে সদস্যতা নিন দেখুন।	সাবস্ক্রিপশন অনুমোদনকারী Google Chat ব্যবহারকারীকে অবশ্যই তাদের Google Workspace বা Google অ্যাকাউন্টের মাধ্যমে স্পেসের সদস্য হতে হবে।
গুগল চ্যাট ব্যবহারকারীরা	`//cloudidentity.googleapis.com/users/ USER_ID`	সদস্যপদ বিস্তারিত জানার জন্য, Google Chat ইভেন্টে সদস্যতা নিন দেখুন।	সাবস্ক্রিপশন শুধুমাত্র সেই ব্যবহারকারীর সম্পর্কে ইভেন্টগুলি গ্রহণ করে যে সদস্যতা অনুমোদন করেছে৷ একজন ব্যবহারকারী অন্য ব্যবহারকারীদের পক্ষে সাবস্ক্রিপশন অনুমোদন করতে পারে না।
গুগল মিট
Google Meet মিটিং স্পেস	`//meet.googleapis.com/spaces/ SPACE_ID`	সম্মেলন অংশগ্রহণকারী সেশন রেকর্ডিং প্রতিলিপি বিস্তারিত জানার জন্য, Google Meet ইভেন্টে সদস্যতা নিন দেখুন।
Google Meet ব্যবহারকারীরা	`//cloudidentity.googleapis.com/users/ USER_ID`	সম্মেলন অংশগ্রহণকারী সেশন রেকর্ডিং প্রতিলিপি বিস্তারিত জানার জন্য, Google Meet ইভেন্টে সদস্যতা নিন দেখুন।	সদস্যতা মিটিং স্পেস সম্পর্কে ইভেন্টগুলি গ্রহণ করে যেখানে ব্যবহারকারী নিম্নলিখিতগুলির মধ্যে একটি: সভাস্থলের মালিক। মিটিং স্পেসের সাথে যুক্ত Google ক্যালেন্ডার ইভেন্টের আয়োজক ।

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 ক্লাউড পাব/সাব প্রোটোকল বাইন্ডিং দেখুন।

Google চ্যাট ইভেন্টগুলিতে সদস্যতা নিন
Google Workspace সাবস্ক্রিপশনের জন্য লাইফসাইকেল ইভেন্ট
Google Workspace Events API স্কোপ বেছে নিন
একটি Google Workspace সদস্যতা তৈরি করুন