- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Lista as assinaturas em um espaço. Confira um exemplo em Listar usuários e apps do Google Chat em um espaço. As associações da página de detalhes com autenticação de app listam as associações em espaços a que o app do Chat tem acesso, mas exclui as associações a apps do Chat, inclusive as que pertencem a ele. A listagem das associações com a autenticação de usuário lista as associações em espaços a que o usuário autenticado tem acesso.
Oferece suporte aos seguintes tipos de autenticação:
Autenticação do usuário: é possível autenticar e autorizar esse método com privilégios de administrador definindo o campo
useAdminAccess
na solicitação.
Solicitação HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O nome do recurso do espaço em que uma lista de participantes será buscada. Formato: spaces/{space} |
Parâmetros de consulta
Parâmetros | |
---|---|
pageSize |
Opcional. O número máximo de assinaturas a serem retornadas. O serviço pode retornar menos do que esse valor. Se não for especificado, serão retornadas no máximo 100 associações. O valor máximo é 1.000. Se você usar um valor maior que 1.000, ele será alterado automaticamente para 1.000. Valores negativos retornam um erro |
pageToken |
Opcional. Um token de página recebido de uma chamada anterior para listar as assinaturas. Forneça esse parâmetro para recuperar a página subsequente. Na paginação, todos os outros parâmetros precisam corresponder à chamada que informou o token da página. A transmissão de valores diferentes para os outros parâmetros pode gerar resultados inesperados. |
filter |
Opcional. Um filtro de consulta. É possível filtrar as assinaturas por função ( Para filtrar por função, defina Para filtrar por tipo, defina Para filtrar por função e tipo, use o operador É necessário usar Por exemplo, as seguintes consultas são válidas:
As consultas a seguir são inválidas:
Consultas inválidas são rejeitadas pelo servidor com um erro |
showGroups |
Opcional. Quando |
showInvited |
Opcional. Quando Requer a autenticação do usuário no momento. |
useAdminAccess |
Quando O usuário que faz a chamada precisa ser um administrador do Google Workspace com o privilégio "Gerenciar conversas de chats e espaços". Requer o escopo OAuth 2.0 Não é possível listar as associações a apps em um espaço quando você usa o acesso de administrador. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta para listar as associações do espaço.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"memberships": [
{
object ( |
Campos | |
---|---|
memberships[] |
Lista não ordenada. Lista de associações na página solicitada (ou na primeira). |
nextPageToken |
Um token que pode ser enviado como |
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.admin.memberships.readonly
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
Para mais informações, consulte o guia de autorização.