يتطلب نطاق OAuth 2.0chat.admin.spaces.readonly أو chat.admin.spaces.
لا تتيح هذه الطريقة حاليًا سوى إذن وصول المشرف، وبالتالي لا يتم قبول سوى 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 سوى القيم من حقل historyState لمورد space.
يجب توفير 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: تشير إلى الوقت الذي تتم فيه إضافة آخر عنصر مؤهَّل إلى أي موضوع في هذه المساحة.
تاريخ التعديل الأخير: 2025-02-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Returns a paginated list of Google Workspace spaces based on an administrator's search criteria, including parameters like displayName, createTime, and spaceType."],["Requires administrator privileges and the `useAdminAccess` parameter set to `true` in the request."],["Utilizes the `GET https://chat.googleapis.com/v1/spaces:search` HTTP request with query parameters for customization."],["Needs authorization with either the `chat.admin.spaces` or `chat.admin.spaces.readonly` OAuth scope."],["Response body includes an array of spaces, a token for pagination, and an estimate of the total number of matching spaces."]]],["To search for Google Workspace spaces, send a `GET` request to `https://chat.googleapis.com/v1/spaces:search`, ensuring admin privileges and setting `useAdminAccess` to `true`. Define the search using query parameters, including a required `query` to filter spaces (by `customer`, `displayName`, etc.), optional `pageSize` and `pageToken` for pagination, and optional `orderBy` for sorting. You must have one of the authorization scopes: `chat.admin.spaces` or `chat.admin.spaces.readonly`. The response will list spaces matching the query.\n"]]