- 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. Por exemplo, consulte Listar usuários e apps do Google Chat em um espaço. A listagem de adesões com autenticação de app lista as adesões em espaços a que o app Chat tem acesso, mas exclui as adesões ao app Chat, incluindo as próprias. 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: espaços/{space} |
Parâmetros de consulta
Parâmetros | |
---|---|
page |
Opcional. O número máximo de assinaturas a serem retornadas. O serviço pode retornar menos 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 |
page |
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 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. |
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 consultas a seguir são válidas:
As seguintes consultas são inválidas:
Consultas inválidas são rejeitadas pelo servidor com um erro |
show |
Opcional. Quando |
show |
Opcional. Quando Atualmente, exige autenticação do usuário. |
use |
Opcional. Quando O usuário que faz a chamada precisa ser um administrador do Google Workspace com o privilégio de gerenciar chats e conversas em espaços. Requer o escopo do 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 assinaturas na página solicitada (ou primeira). |
next |
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.