একটি Google চ্যাট স্পেস থেকে ইভেন্টের তালিকা করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর SpaceEvent রিসোর্সে list() পদ্ধতি ব্যবহার করতে হয় একটি স্পেসে রিসোর্সে পরিবর্তনের তালিকা করতে।

SpaceEvent রিসোর্স টার্গেট স্পেসের পরিবর্তনের প্রতিনিধিত্ব করে, যার মধ্যে স্থানের চাইল্ড রিসোর্স যেমন বার্তা, প্রতিক্রিয়া এবং সদস্যতা রয়েছে। সমর্থিত ইভেন্ট প্রকার এবং ইভেন্ট পেলোডের তালিকা সম্পর্কে আরও তথ্যের জন্য, SpaceEvent রিসোর্স রেফারেন্স ডকুমেন্টেশনের eventType এবং payload ক্ষেত্রগুলি দেখুন।

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

এই পদ্ধতিতে কল করার জন্য, আপনাকে অবশ্যই ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করতে হবে। একটি স্থান থেকে ইভেন্ট তালিকাভুক্ত করতে, প্রমাণীকৃত ব্যবহারকারীকে অবশ্যই স্থানের সদস্য হতে হবে।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

স্থান ঘটনা তালিকা

চ্যাট স্পেস থেকে স্পেস ইভেন্টগুলি তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতগুলি পাস করুন:

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

  • ListSpaceEvents() পদ্ধতিতে কল করুন, ইভেন্টের প্রকারের filter তালিকায় পাস করে। আপনাকে অবশ্যই কমপক্ষে একটি ইভেন্টের ধরণ নির্দিষ্ট করতে হবে এবং আপনি তারিখ অনুসারে ফিল্টারও করতে পারেন৷ সমর্থিত ইভেন্ট প্রকারের তালিকার জন্য, SpaceEvent রিসোর্স রেফারেন্স ডকুমেন্টেশনের eventType ক্ষেত্রটি দেখুন।

নিম্নলিখিত উদাহরণে একটি স্পেসে নতুন সদস্যতা এবং বার্তাগুলি সম্পর্কে ইভেন্টগুলি তালিকাভুক্ত করা হয়েছে:

Node.js

chat/client-libraries/cloud/list-space-events-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

// Authorization scopes based on the event types
const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.memberships.readonly',
  'https://www.googleapis.com/auth/chat.messages.readonly'
];

// This sample shows how to list space events with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    parent: 'spaces/SPACE_NAME',
    // A required filter. Filters events about new memberships and messages
    filter: 'eventTypes:"google.workspace.chat.membership.v1.created" OR eventTypes:"google.workspace.chat.message.v1.created"'
  };

  // Make the request
  const pageResult = chatClient.listSpaceEventsAsync(request);

  // Handle the response. Iterating over pageResult will yield results and
  // resolve additional pages automatically.
  for await (const response of pageResult) {
    console.log(response);
  }
}

main().catch(console.error);

এই নমুনাটি চালানোর জন্য, স্পেস এর name আইডি দিয়ে SPACE_NAME প্রতিস্থাপন করুন। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।

চ্যাট এপিআই নতুন সদস্যতা এবং বার্তা সম্পর্কে স্পেস ইভেন্টের পৃষ্ঠাযুক্ত তালিকার একটি তালিকা প্রদান করে।