Method: spaces.messages.list

কলার যে স্পেসের মেম্বার, সেই স্পেসের মেসেজ তালিকাভুক্ত করে, যার মধ্যে ব্লক করা মেম্বার ও স্পেসের মেসেজও অন্তর্ভুক্ত। সিস্টেম মেসেজ, যেমন নতুন স্পেস মেম্বারদের ঘোষণা করা মেসেজ, অন্তর্ভুক্ত করা হয় না। আপনি যদি কোনও মেসেজ নেই এমন স্পেস থেকে মেসেজের তালিকা তৈরি করেন, তাহলে উত্তরটি একটি খালি অবজেক্ট হবে। REST/HTTP ইন্টারফেস ব্যবহার করার সময়, রেসপন্সে একটি খালি JSON অবজেক্ট, {} থাকে। উদাহরণ হিসেবে, মেসেজের তালিকা দেখুন।

এই ধরনের যাচাইকরণ কাজ করে:

  • অনুমোদনের স্কোপ সহ অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ অ্যাপ যাচাইকরণ:

    • https://www.googleapis.com/auth/chat.app.messages.readonly. এই যাচাইকরণ স্কোপ ব্যবহার করার সময়, এই পদ্ধতি শুধুমাত্র স্পেসে সর্বজনীন মেসেজ ফিরিয়ে দেয়। এতে ব্যক্তিগত মেসেজ অন্তর্ভুক্ত থাকে না।

  • নিম্নলিখিত অনুমোদনের স্কোপের মধ্যে যেকোনও একটির মাধ্যমে ব্যবহারকারীর যাচাইকরণ:

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (শুধু ইমপোর্ট মোড স্পেস)

HTTP অনুরোধ

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

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

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

প্যারামিটারগুলি
parent

string

প্রয়োজনীয়। যে স্পেস থেকে মেসেজ তালিকাভুক্ত করা হবে সেটির রিসোর্স নাম।

ফর্ম্যাট: spaces/{space}

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

প্যারামিটারগুলি
pageSize

integer

ঐচ্ছিক। সর্বাধিক যতগুলি মেসেজ ফেরত পাঠানো হয়েছে। পরিষেবাটি এই মানের চেয়ে কম মেসেজ ফেরত দিতে পারে।

অনির্দিষ্ট থাকলে, সর্বাধিক ২৫টি পাওয়া যায়।

সর্বাধিক ভ্যালু হল ১০০০। আপনি ১০০০-এর বেশি ভ্যালু ব্যবহার করলে, এটি অটোমেটিক ১০০০-এ পরিবর্তন হয়ে যায়।

নেগেটিভ ভ্যালু থাকলে INVALID_ARGUMENT সংক্রান্ত সমস্যা দেখায়।
pageToken

string

ঐচ্ছিক। আগের মেসেজ কল থেকে পাওয়া একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠা ফিরিয়ে আনতে এই প্যারামিটার প্রদান করুন।

পেজিনেট করার সময়, প্রদান করা অন্যান্য সব প্যারামিটারকে পেজ টোকেন প্রদান করা কলের সাথে মিলতে হবে। অন্যান্য প্যারামিটারে আলাদা আলাদা ভ্যালু পাস করলে অপ্রত্যাশিত ফলাফল দেখা যেতে পারে।
filter

string

ঐচ্ছিক। একটি কোয়েরি ফিল্টার।

আপনি তারিখ (createTime) ও থ্রেড (thread.name) অনুযায়ী মেসেজ ফিল্টার করতে পারবেন।

মেসেজ তৈরি করার তারিখ অনুযায়ী ফিল্টার করতে, RFC-3339 ফর্ম্যাটে টাইমস্ট্যাম্প ও ডবল কোটেশন চিহ্ন সহ createTime উল্লেখ করুন। যেমন, "2023-04-21T11:30:00-04:00"। আপনি 'এর থেকে বেশি' অপারেটর > ব্যবহার করে টাইমস্ট্যাম্পের পরে তৈরি করা মেসেজের তালিকা দেখতে পারেন অথবা 'এর থেকে কম' অপারেটর < ব্যবহার করে টাইমস্ট্যাম্পের আগে তৈরি করা মেসেজের তালিকা দেখতে পারেন। কোনও সময়সীমার মধ্যে মেসেজ ফিল্টার করতে, দুটি টাইমস্ট্যাম্পের মধ্যে AND অপারেটর ব্যবহার করুন।

থ্রেড অনুযায়ী ফিল্টার করতে, thread.name উল্লেখ করুন, যা spaces/{space}/threads/{thread} হিসেবে ফর্ম্যাট করা হয়েছে। আপনি প্রতিটি কোয়েরির জন্য শুধুমাত্র একটি thread.name উল্লেখ করতে পারবেন।

থ্রেড ও তারিখ, দুটির ভিত্তিতেই ফিল্টার করতে, আপনার কোয়েরিতে AND অপারেটর ব্যবহার করুন।

যেমন, নিম্নলিখিত কোয়েরিগুলি সঠিক:

createTime > "2012-04-21T11:30:00-04:00"

createTime > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

createTime > "2012-04-21T11:30:00+00:00" AND

createTime < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

ভুল কোয়েরি সার্ভার বাতিল করে দেয় এবং INVALID_ARGUMENT সমস্যা দেখায়।
orderBy

string

ঐচ্ছিক। মেসেজের তালিকা কীভাবে সাজানো হয়। অর্ডার করার অপারেশন দ্বারা অর্ডার করার জন্য একটি মান নির্দিষ্ট করুন। অর্ডার করার অপারেশন সংক্রান্ত সঠিক ভ্যালু নিচে দেওয়া হল:

  • ছোট থেকে বড় ক্রমে সাজাতে ASC।

  • বড় থেকে ছোট ক্রম অনুসারে সাজাতে DESC।

ডিফল্ট অর্ডারিং হল createTime ASC।
showDeleted

boolean

ঐচ্ছিক। মুছে দেওয়া মেসেজ অন্তর্ভুক্ত করা হবে কিনা। মুছে দেওয়া মেসেজের মধ্যে মুছে দেওয়ার সময় ও মুছে দেওয়া সংক্রান্ত মেটাডেটা অন্তর্ভুক্ত থাকে, তবে মেসেজের কন্টেন্ট উপলভ্য থাকে না।
markupSyntax

enum (MarkupSyntax)

ঐচ্ছিক। Chat মেসেজের formattedText ফিল্ডের জন্য পছন্দসই আউটপুট সিনট্যাক্স নির্দিষ্ট করে।

অনুরোধের বডি

অনুরোধের বডি ফাঁকা থাকতে হবে।

প্রতিক্রিয়ার বডি

মেসেজ তালিকাভুক্ত করার জন্য উত্তর মেসেজ।

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

JSON উপস্থাপনা 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
messages[]

object (Message)

মেসেজের তালিকা।
nextPageToken

string

পরবর্তী পৃষ্ঠার ফলাফল পেতে আপনি pageToken হিসেবে টোকেন পাঠাতে পারেন। ফাঁকা থাকলে, পরবর্তী কোনও পৃষ্ঠা নেই।

অনুমোদনের স্কোপ

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

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

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