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.

O 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 tomador de decisão será 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 no 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

  • 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

Node.js

  • Node.js 14 ou mais recente
  • O npm ferramenta de gerenciamento de pacotes
  • As bibliotecas de cliente mais recentes do Google. Para instalar ou atualizar esses recursos, execute o seguinte comando na interface de linha de comando: 
    npm install @google-cloud/local-auth @googleapis/chat

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 associaçã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