Method: spaces.search

ব্যবহারকারীর অনুসন্ধানের উপর ভিত্তি করে স্থানগুলির একটি তালিকা প্রদান করে৷ ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন। ব্যবহারকারীকে অবশ্যই Google Workspace সংস্থার প্রশাসক হতে হবে। অনুরোধে, useAdminAccess true সেট করুন।

HTTP অনুরোধ

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

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

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

পরামিতি
useAdminAccess

boolean

true হলে, পদ্ধতিটি ব্যবহারকারীর Google Workspace অ্যাডমিনিস্ট্রেটর বিশেষাধিকার ব্যবহার করে চলে।

কলিং ব্যবহারকারীকে অবশ্যই একজন Google Workspace অ্যাডমিনিস্ট্রেটর হতে হবে যেখানে চ্যাট এবং স্পেস কথোপকথন পরিচালনা করার সুবিধা রয়েছে

হয় chat.admin.spaces.readonly অথবা chat.admin.spaces OAuth 2.0 স্কোপ প্রয়োজন।

এই পদ্ধতিটি বর্তমানে শুধুমাত্র অ্যাডমিন অ্যাক্সেস সমর্থন করে, এইভাবে শুধুমাত্র true এই ক্ষেত্রের জন্য গৃহীত হয়।

pageSize

integer

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

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

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

pageToken

string

একটি টোকেন, আগের সার্চ স্পেস কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই প্যারামিটারটি প্রদান করুন।

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

query

string

প্রয়োজন। একটি অনুসন্ধান ক্যোয়ারী.

আপনি নিম্নলিখিত পরামিতিগুলি ব্যবহার করে অনুসন্ধান করতে পারেন: - createTime - customer - displayName - externalUserAllowed - lastActiveTime - spaceHistoryState - spaceType

createTime এবং lastActiveTime RFC-3339 ফর্ম্যাটে একটি টাইমস্ট্যাম্প গ্রহণ করে এবং সমর্থিত তুলনা অপারেটরগুলি হল: = , < , > , <= , >=

customer প্রয়োজন এবং কোন গ্রাহকের কাছ থেকে স্পেস আনতে হবে তা নির্দেশ করতে ব্যবহৃত হয়। customers/my_customer একমাত্র সমর্থিত মান।

displayName শুধুমাত্র HAS ( : ) অপারেটরকে গ্রহণ করে। মেলে লেখাটি প্রথমে টোকেনে টোকেনাইজ করা হয় এবং প্রতিটি টোকেন স্পেসের displayName যেকোনো জায়গায় একটি সাবস্ট্রিং হিসাবে অক্ষর-সংবেদনশীলভাবে এবং স্বাধীনভাবে উপসর্গ-মেলে। উদাহরণস্বরূপ, Fun Eve Fun event সাথে মেলে বা The evening was fun কিন্তু notFun event বা even নয়।

externalUserAllowed true বা false স্বীকার করে।

spaceHistoryState শুধুমাত্র একটি space সম্পদের historyState ক্ষেত্র থেকে মান গ্রহণ করে।

spaceType প্রয়োজন এবং একমাত্র বৈধ মান হল SPACE

বিভিন্ন ক্ষেত্র জুড়ে, শুধুমাত্র AND অপারেটর সমর্থিত। একটি বৈধ উদাহরণ হল spaceType = "SPACE" AND displayName:"Hello" এবং একটি অবৈধ উদাহরণ হল spaceType = "SPACE" OR displayName:"Hello"

একই ক্ষেত্রের মধ্যে, spaceType AND বা OR অপারেটর সমর্থন করে না। displayName , 'spaceHistoryState', এবং 'externalUserAllowed' শুধুমাত্র OR অপারেটর সমর্থন করে। lastActiveTime এবং createTime AND এবং OR উভয় অপারেটরকে সমর্থন করে। AND শুধুমাত্র একটি ব্যবধান উপস্থাপন করতে ব্যবহার করা যেতে পারে, যেমন lastActiveTime < "2022-01-01T00:00:00+00:00" AND lastActiveTime > "2023-01-01T00:00:00+00:00"

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

customer = "customers/my_customer" AND spaceType = "SPACE"

customer = "customers/my_customer" AND spaceType = "SPACE" AND
displayName:"Hello World"

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(lastActiveTime < "2020-01-01T00:00:00+00:00" OR lastActiveTime >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(displayName:"Hello World" OR displayName:"Fun event") AND
(lastActiveTime > "2020-01-01T00:00:00+00:00" AND lastActiveTime <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND spaceType = "SPACE" AND
(createTime > "2019-01-01T00:00:00+00:00" AND createTime <
"2020-01-01T00:00:00+00:00") AND (externalUserAllowed = "true") AND
(spaceHistoryState = "HISTORY_ON" OR spaceHistoryState = "HISTORY_OFF")
orderBy

string

ঐচ্ছিক। কিভাবে স্পেস তালিকা অর্ডার করা হয়.

অর্ডার করার জন্য সমর্থিত বৈশিষ্ট্যগুলি হল:

  • membershipCount.joined_direct_human_user_count — মানব ব্যবহারকারীর সংখ্যা নির্দেশ করে যারা সরাসরি একটি স্পেসে যোগদান করেছে।
  • lastActiveTime — এই স্থানের যেকোনো বিষয়ে শেষ যোগ্য আইটেম যোগ করার সময়কে নির্দেশ করে।
  • createTime — স্থান সৃষ্টির সময় নির্দেশ করে।

বৈধ অর্ডার অপারেশন মান হল:

  • আরোহী জন্য ASC . ডিফল্ট মান।

  • অবতরণের জন্য DESC

সমর্থিত সিনট্যাক্স হল:

  • membershipCount.joined_direct_human_user_count DESC
  • membershipCount.joined_direct_human_user_count ASC
  • lastActiveTime DESC
  • lastActiveTime ASC
  • createTime DESC
  • createTime ASC

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

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

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

অনুসন্ধান স্পেস অনুরোধের সাথে সংশ্লিষ্ট স্পেসগুলির একটি তালিকা সহ প্রতিক্রিয়া।

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

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

object ( Space )

অনুরোধ করা স্থানগুলির একটি পৃষ্ঠা৷

nextPageToken

string

একটি টোকেন যা পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে। এই ক্ষেত্রটি খালি থাকলে, পরবর্তী পৃষ্ঠাগুলি নেই৷

totalSize

integer

সমস্ত পৃষ্ঠা জুড়ে কোয়েরির সাথে মেলে এমন মোট স্থানের সংখ্যা৷ ফলাফল 10,000 স্পেস এর বেশি হলে, এই মান একটি অনুমান।

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

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

  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces.readonly

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