Requer o escopo do OAuth 2.0chat.admin.spaces.readonly ou chat.admin.spaces.
No momento, esse método só oferece suporte ao acesso de administrador. Portanto, apenas true é aceito para esse campo.
pageSize
integer
O número máximo de espaços a serem retornados. O serviço pode retornar menos que esse valor.
Se não for especificado, serão retornados no máximo 100 espaços.
O valor máximo é 1.000. Se você usar um valor maior que 1.000, ele será alterado automaticamente para 1.000.
pageToken
string
Um token recebido da chamada de espaços de pesquisa anterior. Forneça esse parâmetro para recuperar a página seguinte.
Na paginação, todos os outros parâmetros enviados precisam corresponder à chamada que forneceu o token da página. A transmissão de valores diferentes para os outros parâmetros pode gerar resultados inesperados.
query
string
Obrigatório. Uma consulta de pesquisa.
É possível pesquisar usando os seguintes parâmetros:
createTime
customer
displayName
externalUserAllowed
lastActiveTime
spaceHistoryState
spaceType
createTime e lastActiveTime aceitam um carimbo de data/hora no formato RFC-3339, e os operadores de comparação aceitos são: =, <, >, <= e >=.
customer é obrigatório e é usado para indicar de qual cliente buscar os espaços. customers/my_customer é o único valor compatível.
displayName só aceita o operador HAS (:). O texto a ser correspondido é tokenizado primeiro, e cada token é correspondido por prefixo, sem distinção entre maiúsculas e minúsculas e de forma independente, como uma substring em qualquer lugar no displayName do espaço. Por exemplo, Fun Eve corresponde a Fun event ou The
evening was fun, mas não a notFun event ou even.
externalUserAllowed aceita true ou false.
spaceHistoryState aceita apenas valores do campo historyState de um recurso space.
spaceType é obrigatório, e o único valor válido é SPACE.
Em campos diferentes, somente os operadores AND são aceitos. Um exemplo válido é spaceType = "SPACE" AND displayName:"Hello", e um exemplo inválido é spaceType = "SPACE" OR displayName:"Hello".
No mesmo campo, spaceType não aceita operadores AND ou OR. displayName, "spaceHistoryState" e "externalUserAllowed" só aceitam operadores OR. lastActiveTime e createTime são compatíveis com os operadores AND e OR. AND só pode ser usado para representar um intervalo, como lastActiveTime
< "2022-01-01T00:00:00+00:00" AND lastActiveTime >
"2023-01-01T00:00:00+00:00".
Os exemplos de consultas a seguir são válidos:
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
Opcional. Como a lista de espaços é ordenada.
Os atributos que podem ser ordenados são:
membershipCount.joined_direct_human_user_count: indica o número de usuários que entraram diretamente em um espaço.
lastActiveTime: indica a hora em que o último item qualificado é adicionado a qualquer tema desse espaço.
createTime: denota o horário da criação do espaço.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-08 UTC."],[[["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"]]
