Configurar um espaço com os participantes iniciais

Este guia explica como usar o método setup no recurso Space da API Google Chat para configurar um espaço do Google Chat. Quando você configura um espaço, e adiciona usuários especificados a ela.

A Recurso Space representa um lugar onde as pessoas e os apps de chat podem enviar mensagens, compartilhar arquivos e colaborar. Há vários tipos de espaços:

  • As mensagens diretas são conversas entre dois usuários ou um usuário e um app do Chat.
  • Os grupos de chat são conversas entre três ou mais usuários e Apps de chat
  • Os espaços nomeados são lugares persistentes onde as pessoas enviam mensagens, compartilham arquivos e colaborar.

Ao configurar um espaço, considere o seguinte:

  • O usuário que fez a chamada (autenticado) é adicionado automaticamente ao espaço. não é necessário especificar a associação do usuário na solicitação.
  • Ao criar uma mensagem direta (DM), se houver uma mensagem direta entre dois usuários, o DM é retornado. Caso contrário, um DM é criado.
  • Ao criar um chat em grupo, se nenhuma das associações fornecidas na solicitação forem adicionados ao bate-papo em grupo (por exemplo, problema na permissão), um grupo vazio (incluindo apenas o usuário que fez a chamada) pode ser criado.
  • Não é possível configurar espaços com respostas agrupadas nem adicionar pessoas fora do seu Google Workspace.
  • Associações duplicadas (incluindo o usuário que fez a chamada) fornecidas na solicitação são filtrados, em vez de resultar em um erro de solicitação.

Pré-requisitos

Python

Node.js

Configurar um espaço

Para configurar um espaço, transmita o seguinte na sua solicitação:

  • Especifique o escopo de autorização chat.spaces.create ou chat.spaces.
  • Chame o método Método setup no recurso Space.
  • Para adicionar um usuário humano como participante do espaço, especifique users/{user}, em que {user} é o {person_id} dos person da API People, ou o ID de um user na API Directory. Por exemplo, se o funcionário da API People resourceName é people/123456789. Para adicionar o usuário ao espaço, faça o seguinte: incluindo uma assinatura com users/123456789 como member.name.
  • Para adicionar um grupo como participante do espaço, especifique groups/{group}, em que {group} é o ID do grupo para o qual você deseja criar a associação. O ID do grupo pode ser recuperados usando a API Cloud Identity. Por exemplo, se a API Cloud Identity retorna um grupo com o nome groups/123456789 e, em seguida, define membership.groupMember.name para groups/123456789. Os Grupos do Google não podem ser adicionado a um chat em grupo ou mensagem direta, mas apenas a um espaço nomeado.
  • Criar uma mensagem direta entre o usuário que fez a chamada e outra pessoa usuário, especifique a adesão do usuário humano na sua solicitação.
  • Para criar uma mensagem direta entre o usuário que fez a chamada e o app de chamada, defina Space.singleUserBotDm a true e não especifica nenhuma assinatura. Você pode só use esse método para configurar uma mensagem direta com o app de chamada. Para adicionar a chamada como participante de um espaço ou uma mensagem direta entre dois usuários humanos, consulte criar uma assinatura.

O exemplo a seguir cria um espaço nomeado e cria associações a ele para um grupo e três usuários humanos (incluindo o usuário autenticado e dois outros usuários especificados).

Python

  1. No diretório de trabalho, crie um arquivo chamado chat_space_setup.py.
  2. Inclua o seguinte código em chat_space_setup.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.spaces.create"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then sets up a Chat space by creating a space and adding members.
        '''
    
        # 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().setup(
    
          # Details about the space to set up.
          body = {
    
            # Attributes of the space to set up, like space type and display name.
            'space': {
    
                # To set up a named space, set spaceType to SPACE.
                'spaceType': 'SPACE',
    
                # The user-visible name of the space
                'displayName': 'API-setup'
            },
    
            # The users and groups to add to the space.
            #
            # The authenticated user is automatically added to the space,
            # and doesn't need to be specified in the memberships array.
            'memberships': [
                {
                  'member': {
                    'name':'users/123456789',
                    'type': 'HUMAN'
                  }
                },
                {
                  'member': {
                    'name':'users/987654321',
                    'type': 'HUMAN'
                  }
                },
                {
                  'groupMember': {
                    'name': 'groups/11223344'
                  }
                }
            ]
          }
    
          ).execute()
    
        # Prints details about the created space.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. No diretório de trabalho, crie e execute o exemplo:

    python3 chat_space_setup.py
    

Node.js

  1. No diretório de trabalho, crie um arquivo chamado setup-space.js.
  2. Inclua o seguinte código em setup-space.js:

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Sets up a new Chat space with users.
    * @return {!Promise<!Object>}
    */
    async function setupSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.spaces.create',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.setup({
        requestBody: {
          space: {
            spaceType: 'SPACE',
            displayName: 'API-made',
          },
          memberships: [
            {member: {name: 'users/123456789', type: 'HUMAN'}},
            {member: {name: 'users/987654321', type: 'HUMAN'}},
            {groupMember: {name: 'groups/11223344'}},
          ]
        }
      });
    }
    
    setupSpace().then(console.log);
    
  3. No diretório de trabalho, execute o exemplo:

    node setup-space.js
    

Um espaço de chat nomeado com um grupo e três usuários humanos, incluindo o "Usuário autenticado".

Para acessar o espaço, use o ID do recurso e crie o URL dele. Você pode encontrar o ID do recurso do espaço name na resposta do Google Chat corpo Por exemplo, se a name do seu espaço for spaces/1234567, você poderá acessar para o espaço usando o seguinte URL: https://mail.google.com/chat/u/0/#chat/space/1234567