এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর SpaceEvent
রিসোর্সে list()
পদ্ধতি ব্যবহার করতে হয় একটি স্পেসে রিসোর্সে পরিবর্তনের তালিকা করতে।
SpaceEvent
রিসোর্স টার্গেট স্পেসের পরিবর্তনের প্রতিনিধিত্ব করে, যার মধ্যে স্থানের চাইল্ড রিসোর্স যেমন বার্তা, প্রতিক্রিয়া এবং সদস্যতা রয়েছে। সমর্থিত ইভেন্ট প্রকার এবং ইভেন্ট পেলোডের তালিকা সম্পর্কে আরও তথ্যের জন্য, SpaceEvent
রিসোর্স রেফারেন্স ডকুমেন্টেশনের eventType
এবং payload
ক্ষেত্রগুলি দেখুন।
আপনি অনুরোধের সময়ের 28 দিন আগে পর্যন্ত ইভেন্ট তালিকাভুক্ত করতে পারেন। সার্ভারটি এমন ইভেন্টগুলি ফেরত দেয় যাতে প্রভাবিত সংস্থানটির সাম্প্রতিকতম সংস্করণ রয়েছে৷ উদাহরণস্বরূপ, যদি আপনি নতুন স্পেস সদস্যদের সম্পর্কে ইভেন্টগুলি তালিকাভুক্ত করেন, সার্ভার Membership
সংস্থানগুলি ফেরত দেয় যাতে সর্বশেষ সদস্যতার বিবরণ রয়েছে। অনুরোধ করা সময়ের মধ্যে যদি নতুন সদস্যদের সরানো হয়, তাহলে ইভেন্ট পেলোডে একটি খালি Membership
সম্পদ থাকে।
এই পদ্ধতিতে কল করার জন্য, আপনাকে অবশ্যই ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করতে হবে। একটি স্থান থেকে ইভেন্ট তালিকাভুক্ত করতে, প্রমাণীকৃত ব্যবহারকারীকে অবশ্যই স্থানের সদস্য হতে হবে।
পূর্বশর্ত
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
স্থান ঘটনা তালিকা
চ্যাট স্পেস থেকে স্পেস ইভেন্টগুলি তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতগুলি পাস করুন:
আপনার অনুরোধে প্রতিটি ইভেন্ট প্রকারকে সমর্থন করার জন্য এক বা একাধিক অনুমোদনের সুযোগ নির্দিষ্ট করুন। একটি সর্বোত্তম অনুশীলন হিসাবে, সর্বাধিক সীমাবদ্ধ সুযোগ বেছে নিন যা এখনও আপনার অ্যাপটিকে কাজ করার অনুমতি দেয়। একটি সুযোগ নির্বাচন করতে, প্রমাণীকরণ এবং অনুমোদন ওভারভিউ দেখুন।
ListSpaceEvents()
পদ্ধতিতে কল করুন, ইভেন্টের প্রকারেরfilter
তালিকায় পাস করে। আপনাকে অবশ্যই কমপক্ষে একটি ইভেন্টের ধরণ নির্দিষ্ট করতে হবে এবং আপনি তারিখ অনুসারে ফিল্টারও করতে পারেন৷ সমর্থিত ইভেন্ট প্রকারের তালিকার জন্য,SpaceEvent
রিসোর্স রেফারেন্স ডকুমেন্টেশনেরeventType
ক্ষেত্রটি দেখুন।
নিম্নলিখিত উদাহরণে একটি স্পেসে নতুন সদস্যতা এবং বার্তাগুলি সম্পর্কে ইভেন্টগুলি তালিকাভুক্ত করা হয়েছে:
Node.js
এই নমুনাটি চালানোর জন্য, স্পেস এর name
আইডি দিয়ে SPACE_NAME
প্রতিস্থাপন করুন। আপনি ListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
চ্যাট এপিআই নতুন সদস্যতা এবং বার্তা সম্পর্কে স্পেস ইভেন্টের পৃষ্ঠাযুক্ত তালিকার একটি তালিকা প্রদান করে।