Method: spaces.spaceEvents.list

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

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

একটি উদাহরণের জন্য, একটি Google চ্যাট স্পেস থেকে ইভেন্টের তালিকা দেখুন।

HTTP অনুরোধ

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। Google চ্যাট স্পেসের রিসোর্স নাম যেখানে ঘটনা ঘটেছে।

বিন্যাস: spaces/{space} ।

ক্যোয়ারী প্যারামিটার

পরামিতি
pageSize

integer

ঐচ্ছিক। স্পেস ইভেন্টের সর্বাধিক সংখ্যা ফিরে এসেছে। পরিষেবাটি এই মানের থেকে কম ফেরত দিতে পারে।

নেতিবাচক মান একটি INVALID_ARGUMENT ত্রুটি প্রদান করে৷

pageToken

string

একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী তালিকা স্থান ইভেন্ট কল থেকে প্রাপ্ত. পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।

পেজিনেট করার সময়, স্পেস ইভেন্টগুলি তালিকাভুক্ত করার জন্য প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই সেই কলের সাথে মেলে যেটি পৃষ্ঠা টোকেন প্রদান করে। অন্যান্য প্যারামিটারে বিভিন্ন মান পাস করলে অপ্রত্যাশিত ফলাফল হতে পারে।

filter

string

প্রয়োজন। একটি ক্যোয়ারী ফিল্টার।

আপনাকে অবশ্যই has : অপারেটর ব্যবহার করে অন্তত একটি ইভেন্ট টাইপ ( eventType ) নির্দিষ্ট করতে হবে। একাধিক ইভেন্ট প্রকার দ্বারা ফিল্টার করতে, OR অপারেটর ব্যবহার করুন৷ আপনার ফিল্টারে ব্যাচ ইভেন্টের ধরন বাদ দিন। অনুরোধ স্বয়ংক্রিয়ভাবে কোনো সম্পর্কিত ব্যাচ ইভেন্ট ফেরত. উদাহরণস্বরূপ, যদি আপনি নতুন প্রতিক্রিয়া দ্বারা ফিল্টার করেন ( google.workspace.chat.reaction.v1.created ), সার্ভারটি ব্যাচের নতুন প্রতিক্রিয়া ইভেন্টগুলিও ফেরত দেয় ( google.workspace.chat.reaction.v1.batchCreated )। সমর্থিত ইভেন্ট প্রকারের তালিকার জন্য, SpaceEvents রেফারেন্স ডকুমেন্টেশন দেখুন।

ঐচ্ছিকভাবে, আপনি শুরুর সময় ( startTime ) এবং শেষ সময় ( endTime ) দ্বারা ফিল্টার করতে পারেন :

  • startTime : এক্সক্লুসিভ টাইমস্ট্যাম্প যেখান থেকে স্পেস ইভেন্টের তালিকা শুরু করতে হবে। আপনি 28 দিন আগে পর্যন্ত ঘটে যাওয়া ইভেন্টগুলির তালিকা করতে পারেন৷ অনির্দিষ্ট থাকলে, গত ২৮ দিনের মহাকাশের ঘটনাগুলি তালিকাভুক্ত করে৷
  • endTime : স্পেস ইভেন্ট তালিকাভুক্ত না হওয়া পর্যন্ত অন্তর্ভুক্ত টাইমস্ট্যাম্প। অনির্দিষ্ট থাকলে, অনুরোধের সময় পর্যন্ত ইভেন্ট তালিকাভুক্ত করে।

একটি শুরু বা শেষ সময় নির্দিষ্ট করতে, RFC-3339- এ equals = অপারেটর এবং ফর্ম্যাট ব্যবহার করুন। উভয় startTime এবং endTime দ্বারা ফিল্টার করতে, AND অপারেটর ব্যবহার করুন৷

উদাহরণস্বরূপ, নিম্নলিখিত প্রশ্নগুলি বৈধ: 

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"

startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

নিম্নলিখিত প্রশ্নগুলি অবৈধ: 

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"

eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

একটি INVALID_ARGUMENT ত্রুটির সাথে সার্ভার দ্বারা অবৈধ প্রশ্নগুলি প্রত্যাখ্যান করা হয়েছে৷

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

স্থান ঘটনা তালিকার জন্য প্রতিক্রিয়া বার্তা.

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
spaceEvents[]

object ( SpaceEvent )

ফলাফলগুলি কালানুক্রমিক ক্রমে ফেরত দেওয়া হয় (প্রথম প্রাচীনতম ঘটনা)।

nextPageToken

string

আরও ইভেন্ট আনতে ব্যবহার করা ধারাবাহিকতা টোকেন। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে পরবর্তী পৃষ্ঠা থাকবে না।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।