تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
Method: spaces.search
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الطريقة قائمة بالمساحات في مؤسسة Google Workspace. للاطّلاع على مثال، راجِع البحث عن المساحات وإدارتها.
عند ضبط useAdminAccess على false، تقتصر النتائج على المساحات التي يكون فيها المستخدم الذي يجري الطلب عضوًا منضمًا. للبحث باستخدام امتيازات المشرف، اضبط useAdminAccess على true. يتوفّر ضبط useAdminAccess على false في إصدار "معاينة المطور".
تتوافق هذه الطريقة مع الأنواع التالية من المصادقة:
طلب HTTP
GET https://chat.googleapis.com/v1/spaces:search
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
معامِلات طلب البحث
| المعلمات |
useAdminAccess |
boolean
عند ضبط هذه المعلمة على true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم الذي يجري الطلب مشرفًا في Google Workspace ولديه امتياز إدارة المحادثات في Chat وفي "المساحات". يجب توفير نطاق OAuth 2.0 إما chat.admin.spaces.readonly أو chat.admin.spaces . يتوفّر ضبط useAdminAccess على false في إصدار "معاينة المطور".
|
pageSize |
integer
الحد الأقصى لعدد المساحات التي سيتم عرضها. قد تعرض الخدمة عددًا أقل من هذا القيمة. إذا لم يتم تحديد هذه المعلمة، يتم عرض 100 مساحة على الأكثر. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، يتم تغييرها تلقائيًا إلى 1000.
|
pageToken |
string
رمز تم تلقّيه من طلب البحث السابق عن المساحات. يُرجى تقديم هذه المعلمة لاسترداد الصفحة التالية. عند تقسيم النتائج على صفحات، يجب أن تتطابق جميع المعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز الصفحة. قد يؤدي تمرير قيم مختلفة إلى المعلمات الأخرى إلى نتائج غير متوقّعة.
|
query |
string
الحقل مطلوب. طلب بحث. يمكنك البحث باستخدام المعلمات التالية عند ضبط useAdminAccess على true:
createTimecustomerdisplayNameexternalUserAllowedlastActiveTimespaceHistoryStatespaceType عند ضبط useAdminAccess على false:
displayNameexternalUserAllowedspaceType createTime وlastActiveTime تقبلان طابعًا زمنيًا بتنسيق RFC-3339 وعوامل المقارنة المتوافقة هي: = و< و> و<= و>=.
المعلمة customer مطلوبة عند ضبط useAdminAccess على true، وتُستخدم للإشارة إلى العميل الذي سيتم جلب المساحات منه. customers/my_customer هي القيمة الوحيدة المتوافقة. لا تقبل المعلمة displayName سوى عامل التشغيل HAS (:). يتم أولاً تقسيم النص الذي يجب مطابقته إلى رموز، ثم تتم مطابقة كل رمز بشكل مستقل وبدون مراعاة حالة الأحرف كبادئة لسلسلة فرعية في أي مكان في displayName للمساحة. على سبيل المثال، تطابق السلسلة Fun Eve السلسلتَين Fun event أو The
evening was fun، ولكن لا تطابق السلسلتَين notFun event أو even. عند ضبط useAdminAccess على false، تكون المعلمة displayName مطلوبة لاسترداد نتائج مفيدة. بخلاف ذلك، يكون السلوك التلقائي هو عرض استجابة فارغة. تقبل المعلمة 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". تكون طلبات البحث المثال التالية صالحة عند ضبط useAdminAccess على true:
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")
تكون طلبات البحث المثال التالية صالحة عند ضبط useAdminAccess على false:
displayName:"Hello World" AND spaceType = "SPACE"
(displayName:"Hello" OR displayName:"Fun") AND spaceType = "SPACE"
(externalUserAllowed = "true" AND spaceType = "SPACE") // Returns an
empty response.
(externalUserAllowed = "true" AND displayName:"Hello" AND spaceType =
"SPACE")
|
orderBy |
string
اختياريّ. طريقة ترتيب قائمة المساحات. السمات المتوافقة التي يمكن الترتيب حسبها هي:
membershipCount.joined_direct_human_user_count : يشير إلى عدد المستخدمين من البشر الذين انضموا مباشرةً إلى مساحة.lastActiveTime : يشير إلى الوقت الذي تمت فيه إضافة آخر عنصر مؤهَّل إلى أي موضوع في هذه المساحة.createTime : يشير إلى وقت إنشاء المساحة. عند ضبط useAdminAccess على false، لا يتم دعم سوى createTime وrelevance للترتيب. لا يتم دعم سوى DESC لهذه الحقول في عمليات البحث غير الخاصة بالمشرفين. قيم عملية الترتيب الصالحة هي:
بنية طلب البحث المتوافقة عند ضبط useAdminAccess على true:
membershipCount.joined_direct_human_user_count DESCmembershipCount.joined_direct_human_user_count ASClastActiveTime DESClastActiveTime ASCcreateTime DESCcreateTime ASC عند ضبط useAdminAccess على false:
createTime DESCrelevance DESC
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
استجابة تتضمّن قائمة بالمساحات التي تتطابق مع طلب البحث عن المساحات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"spaces": [
{
object (Space)
}
],
"nextPageToken": string,
"totalSize": integer,
"results": [
{
object (SearchSpaceResult)
}
]
} |
| الحقول |
spaces[]
(deprecated) |
object (Space)
متوقّف نهائيًا: يُرجى استخدام الحقل الجديد results بدلاً من ذلك. صفحة من المساحات المطلوبة. لن تتم تعبئة هذا الحقل إلا عند ضبط useAdminAccess على true، وسيتم إيقافه نهائيًا لصالح الحقل الجديد results.
|
nextPageToken |
string
رمز يمكن استخدامه لاسترداد الصفحة التالية. إذا كان هذا الحقل فارغًا، ما يعني أنّه لا توجد صفحات لاحقة.
|
totalSize |
integer
العدد الإجمالي للمساحات التي تتطابق مع طلب البحث، على مستوى جميع الصفحات. إذا كانت النتيجة تتضمّن أكثر من 10,000 مساحة، تكون هذه القيمة تقديرية.
|
results[] |
object (SearchSpaceResult)
الإخراج فقط. قائمة بنتائج البحث التي تطابقت مع طلب البحث.
|
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.admin.spaceshttps://www.googleapis.com/auth/chat.admin.spaces.readonly
لمزيد من المعلومات، راجِع دليل التفويض.
SearchSpaceResult
عنصر نتيجة فردي من عملية بحث عن مساحة.
| تمثيل JSON |
{
"space": {
object (Space)
}
} |
| الحقول |
space |
object (Space)
الإخراج فقط. المساحة التي تم العثور عليها.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2026-07-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-07-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]
