Method: spaces.messages.list

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

নিম্নলিখিত ধরনের প্রমাণীকরণ সমর্থন করে:

HTTP অনুরোধ

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

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

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

পরামিতি
parent

string

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

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

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

পরামিতি
pageSize

integer

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

অনির্দিষ্ট থাকলে, সর্বাধিক 25টি ফেরত দেওয়া হয়।

সর্বাধিক মান হল 1000৷ আপনি যদি 1000-এর বেশি একটি মান ব্যবহার করেন তবে এটি স্বয়ংক্রিয়ভাবে 1000-এ পরিবর্তিত হবে৷

নেতিবাচক মান একটি 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

ঐচ্ছিক। মুছে ফেলা বার্তা অন্তর্ভুক্ত করা হবে কিনা। মুছে ফেলা বার্তাগুলি মুছে ফেলার সময় এবং তাদের মুছে ফেলার মেটাডেটা অন্তর্ভুক্ত করে, কিন্তু বার্তা সামগ্রী অনুপলব্ধ৷

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

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

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

বার্তা তালিকার জন্য প্রতিক্রিয়া বার্তা.

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

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

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