Listar usuários e apps do Google Chat em um espaço

Neste guia, explicamos como usar o método list no recurso membership da API Google Chat para listar usuários e app do Chat em um espaço como uma lista paginada e filtrável de associações em um espaço. A lista de assinaturas com autenticação de apps lista as associações em espaços a que o app do Chat tem acesso, mas exclui as associações ao app do Chat, incluindo as próprias. A listagem de associações com autenticação de usuário lista as associações em espaços a que o usuário autenticado tem acesso.

O recurso Membership representa se um usuário humano ou app do Google Chat foi convidado, parte de ou ausente de um espaço.

Pré-requisitos

Python

  • Python 3.6 ou superior
  • A ferramenta de gerenciamento de pacotes pip

  • As bibliotecas de cliente mais recentes do Google para Python. Para instalá-los ou atualizá-los, execute o seguinte comando na interface de linha de comando:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
  • Um projeto do Google Cloud com a API Google Chat ativada e configurada. Veja as etapas em Criar um app do Google Chat.

  • autorização configurada para o app do Chat. A listagem de assinaturas é compatível com os dois métodos de autenticação a seguir:

Listar usuários e o app do Chat em um espaço com autenticação de usuário

Para listar usuários e apps do Chat em um espaço a que o usuário autenticado tem acesso, transmita o seguinte na solicitação:

O exemplo a seguir lista os participantes do espaço humano (não os administradores) visíveis para o usuário autenticado porque filter está definido como ROLE_Member:

Python

  1. No diretório de trabalho, crie um arquivo chamado chat_member_list_user.py.

  2. Inclua o seguinte código em chat_member_list_user.py:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then lists human space members (but not space managers) in a
    specified space.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().list(

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # An optional filter that returns only human space members.
        filter = 'member.type = "HUMAN" AND role = "ROLE_MEMBER"'

    ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

  3. No código, substitua SPACE por um nome de espaço, que pode ser obtido no método spaces.list na API Chat ou no URL de um espaço.

  4. No diretório de trabalho, crie e execute a amostra:

    python3 chat_member_list_user.py

A API Google Chat retorna uma lista de participantes humanos (exceto administradores) e de apps do espaço especificado.

Listar usuários e o app do Chat em um espaço com autenticação de apps

Para listar os usuários e o app do Chat em um espaço a que o app autenticado tem acesso, transmita o seguinte na sua solicitação:

O exemplo a seguir lista os participantes do espaço humano (não os administradores) visíveis para o app do Chat:

Python

  1. No diretório de trabalho, crie um arquivo chamado chat_member_list_app.py.

  2. Inclua o seguinte código em chat_member_list_app.py:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Use the service endpoint to call Chat API.
result = chat.spaces().members().list(

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # An optional filter that returns only human space members.
        filter = 'member.type = "HUMAN" AND role = "ROLE_MEMBER"'

    ).execute()

print(result)

  3. No código, substitua SPACE por um nome de espaço, que pode ser obtido no método spaces.list na API Chat ou no URL de um espaço.

  4. No diretório de trabalho, crie e execute a amostra:

    python3 chat_member_list_app.py

A API Google Chat retorna uma lista de participantes humanos (com exceção dos administradores) do espaço especificado.

Personalizar a paginação ou filtrar a lista

Para listar as associações, transmita os seguintes parâmetros de consulta para personalizar a paginação ou filtrar associações listadas:

  • pageSize: 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 retornados no máximo 100 espaços. O valor máximo é 1.000. Valores acima de 1.000 são automaticamente alterados para 1.000.
  • pageToken: um token de página, recebido de uma chamada anterior de espaços da lista. Forneça esse token para recuperar a página seguinte. Ao paginar, o valor do filtro precisa corresponder à chamada que forneceu o token da página. Transmitir um valor diferente pode levar a resultados inesperados.
  • filter: um filtro de consulta. Requer autenticação do usuário. Para ver detalhes de consultas compatíveis, consulte o método spaces.members.list.