Method: spaces.findGroupChats

spaceType == GROUP_CHAT টাইপের সমস্ত স্পেস ফেরত দেয়, যেগুলোর সদস্য তালিকায় ঠিক কলিং ইউজার এবং FindGroupChatsRequest.users এ উল্লেখিত ইউজাররা অন্তর্ভুক্ত। শুধুমাত্র কথোপকথনে যোগদানকারী সদস্যরাই সমর্থিত। একটি উদাহরণের জন্য, `Find group chats` দেখুন।

যদি কলকারী ব্যবহারকারী কিছু ব্যবহারকারীকে ব্লক করে, অথবা তাদের দ্বারা ব্লক হয়, এবং নির্দিষ্ট সকল ব্যবহারকারীসহ কোনো স্পেস খুঁজে না পাওয়া যায়, তাহলে এই মেথডটি সেইসব স্পেস রিটার্ন করে যেগুলিতে ব্লক করা বা ব্লককারী ব্যবহারকারীরা অন্তর্ভুক্ত নয়।

নির্দিষ্ট ব্যবহারকারী সেটে শুধুমাত্র মানব (নন-অ্যাপ) সদস্যপদ থাকতে হবে। যে অনুরোধে অ-মানব ব্যবহারকারী থাকে, তা কোনো স্পেস ফেরত দেয় না।

নিম্নলিখিত অনুমোদন পরিধিগুলির মধ্যে যেকোনো একটির মাধ্যমে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন:

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

HTTP অনুরোধ

GET https://chat.googleapis.com/v1/spaces:findGroupChats

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

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

প্যারামিটার
users[]

string

ঐচ্ছিক। কলকারী ব্যবহারকারীর সাথে গ্রুপ চ্যাটে থাকা সকল ব্যবহারকারীর রিসোর্স নাম। অনুরোধে চ্যাট অ্যাপ অন্তর্ভুক্ত করা যাবে না।

একটি একক অনুরোধে সর্বাধিক 49 ব্যবহারকারীকে নির্দিষ্ট করা যায়।

ফর্ম্যাট: users/{user} , যেখানে {user} হলো People API থেকে প্রাপ্ত ব্যক্তির id , অথবা Directory API-তে থাকা ব্যবহারকারীর id । উদাহরণস্বরূপ, কলিং ব্যবহারকারী এবং People API প্রোফাইল আইডি 123456789 ও 987654321 সহ অন্য দুজন ব্যবহারকারীর সমস্ত গ্রুপ চ্যাট খুঁজে পেতে, আপনি users/123456789 এবং users/987654321 ব্যবহার করতে পারেন। আপনি {user} এর জন্য ইমেলকেও একটি উপনাম (alias) হিসেবে ব্যবহার করতে পারেন। উদাহরণস্বরূপ, users/example@gmail.com , যেখানে example@gmail.com হলো গুগল চ্যাট ব্যবহারকারীর ইমেল।

pageSize

integer

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

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

সর্বোচ্চ মান হলো ৩০। আপনি ৩০-এর বেশি কোনো মান ব্যবহার করলে, তা স্বয়ংক্রিয়ভাবে ৩০-এ পরিবর্তিত হয়ে যাবে।

ঋণাত্মক মান INVALID_ARGUMENT ত্রুটি দেখায়।

pageToken

string

ঐচ্ছিক। গ্রুপ চ্যাট খোঁজার জন্য পূর্ববর্তী কোনো কল থেকে প্রাপ্ত একটি পেজ টোকেন। পরবর্তী পেজটি পাওয়ার জন্য এই প্যারামিটারটি প্রদান করুন।

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

spaceView

enum ( SpaceView )

অনুরোধকৃত স্পেস ভিউ টাইপ। সেট না করা থাকলে, ডিফল্ট হিসেবে SPACE_VIEW_RESOURCE_NAME_ONLY ব্যবহৃত হয়। যে অনুরোধগুলিতে SPACE_VIEW_EXPANDED উল্লেখ করা থাকে, সেগুলিতে অবশ্যই এমন স্কোপ অন্তর্ভুক্ত করতে হবে যা স্পেস ডেটা পড়ার অনুমতি দেয়, যেমন, https://www.googleapis.com/auth/chat.spaces অথবা https://www.googleapis.com/auth/chat.spaces.readonly ।

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

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

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

এমন একটি প্রতিক্রিয়া যাতে ঠিক কলকারী ব্যবহারকারী এবং অনুরোধকৃত ব্যবহারকারীদের নিয়ে গঠিত গ্রুপ চ্যাট স্পেসগুলো অন্তর্ভুক্ত থাকবে।

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

JSON উপস্থাপনা 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
spaces[]

object ( Space )

অনুরোধকৃত (বা প্রথম) পৃষ্ঠার খালি স্থানগুলোর তালিকা।

nextPageToken

string

একটি টোকেন যা আপনি ফলাফলের পরবর্তী পৃষ্ঠা পাওয়ার জন্য pageToken হিসেবে পাঠাতে পারেন। এটি খালি থাকলে, পরবর্তী কোনো পৃষ্ঠা থাকবে না।

অনুমোদনের পরিধি

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

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

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

স্পেসভিউ

একটি ভিউ যা নির্দিষ্ট করে দেয় Space রিসোর্সের কোন ফিল্ডগুলো পূরণ করা হবে। ভবিষ্যৎ রিলিজের সাথে সামঞ্জস্যতা নিশ্চিত করতে, আমরা সুপারিশ করি যে আপনার কোডে অতিরিক্ত ভ্যালুগুলোরও ব্যবস্থা রাখা হোক।

এনাম
SPACE_VIEW_UNSPECIFIED ডিফল্ট / অনির্ধারিত মান।
SPACE_VIEW_RESOURCE_NAME_ONLY শুধুমাত্র স্পেস রিসোর্সের নামটি পূরণ করে।
SPACE_VIEW_EXPANDED স্পেস রিসোর্স ফিল্ডগুলি পূরণ করে। দ্রষ্টব্য: permissionSettings ফিল্ডটি পূরণ করা হবে না। যে অনুরোধগুলিতে SPACE_VIEW_EXPANDED উল্লেখ করা থাকে, সেগুলিতে অবশ্যই এমন স্কোপ অন্তর্ভুক্ত করতে হবে যা স্পেস ডেটা পড়ার অনুমতি দেয়, উদাহরণস্বরূপ, https://www.googleapis.com/auth/chat.spaces অথবা https://www.googleapis.com/auth/chat.spaces.readonly ।