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

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

বার্তা তালিকাভুক্ত করার জন্য প্রতিক্রিয়া বার্তা।

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

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

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

,

কলার যে স্পেসের সদস্য, সেই স্পেসের মেসেজগুলো তালিকাভুক্ত করে, যার মধ্যে ব্লক করা সদস্য এবং স্পেসের মেসেজও অন্তর্ভুক্ত থাকে। সিস্টেম মেসেজ, যেমন নতুন স্পেস সদস্য ঘোষণার মেসেজ, এতে অন্তর্ভুক্ত নয়। যদি আপনি এমন কোনো স্পেসের মেসেজ তালিকাভুক্ত করেন যেখানে কোনো মেসেজ নেই, তাহলে রেসপন্সটি একটি খালি অবজেক্ট হবে। 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

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

বার্তা তালিকাভুক্ত করার জন্য প্রতিক্রিয়া বার্তা।

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

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

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