Receber detalhes sobre uma assinatura

Este guia explica como usar o método get no recurso membership da API Google Chat para conferir detalhes sobre a associação a um espaço.

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

Como autenticar com autenticação de apps permite que um app do Chat receba associações dos espaços acesso no Google Chat (por exemplo, os espaços de que participa), mas exclui Assinaturas de app do Chat, inclusive as próprias Autenticação com autenticação de usuários retorna associações de espaços aos quais o usuário autenticado tem acesso.

Pré-requisitos

Python

  • Python 3.6 ou superior
  • a ferramenta de gerenciamento de pacotes PIP;
  • As bibliotecas de cliente mais recentes do Google. Para instalar ou atualizar esses recursos, execute o seguinte comando na interface de linha de comando:
    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

Receber detalhes sobre uma assinatura

Para acessar detalhes sobre uma assinatura no Google Chat, transmita as seguintes informações no seu solicitação:

  • Com autenticação do app, especifique escopo de autorização chat.bot. Com autenticação do usuário especifique a autorização chat.memberships.readonly ou chat.memberships do projeto. Como prática recomendada, escolha o escopo mais restritivo que ainda permite que seu app funcione.
  • Chame o método Método get no(a) Recurso membership.
  • Transmita o name da assinatura para receber. Consiga o nome da assinatura do recurso de assinatura do Google Chat.

Veja como assinar o autenticação do usuário:

Python

  1. No diretório de trabalho, crie um arquivo chamado chat_membership_get.py.
  2. Inclua o seguinte código em chat_membership_get.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 gets details about a specified membership.
        '''
    
        # 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().get(
    
            # The membership to get.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            #
            # Replace MEMBER with a membership name.
            # Obtain the membership name from the memberships resource of
            # Chat API.
            name='spaces/SPACE/members/MEMBER'
    
        ).execute()
    
        # Prints details about the membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. No código, substitua o seguinte:

  4. No diretório de trabalho, crie e execute o exemplo:

    python3 chat_membership_get.py
    

A API Chat retorna uma instância do membership com detalhes da associação especificada.