Возвращает список пространств в организации Google Workspace на основе поиска администратора. В запросе установите useAdminAccess в true . Пример см. в разделе Поиск и управление пространствами .
В настоящее время этот метод поддерживает только доступ администратора, поэтому для этого поля принимается только 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 — Обозначает время добавления последнего подходящего элемента в любую тему этого пространства.
createTime — Обозначает время создания пространства.
Токен, который можно использовать для получения следующей страницы. Если это поле пустое, последующих страниц нет.
totalSize
integer
Общее количество пробелов, соответствующих запросу, на всех страницах. Если результат превышает 10 000 пробелов, это значение является приблизительным.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-20 UTC."],[[["\u003cp\u003eReturns a paginated list of Google Workspace spaces based on an administrator's search criteria, including parameters like displayName, createTime, and spaceType.\u003c/p\u003e\n"],["\u003cp\u003eRequires administrator privileges and the \u003ccode\u003euseAdminAccess\u003c/code\u003e parameter set to \u003ccode\u003etrue\u003c/code\u003e in the request.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eGET https://chat.googleapis.com/v1/spaces:search\u003c/code\u003e HTTP request with query parameters for customization.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with either the \u003ccode\u003echat.admin.spaces\u003c/code\u003e or \u003ccode\u003echat.admin.spaces.readonly\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse body includes an array of spaces, a token for pagination, and an estimate of the total number of matching spaces.\u003c/p\u003e\n"]]],["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"],null,[]]
