Criar um espaço

Este guia explica como usar o método create no recurso Space da a API Google Chat para criar um espaço nomeado.

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.

Um espaço nomeado é um lugar onde as pessoas enviam mensagens, compartilham arquivos e colaborar. Os espaços nomeados podem incluir apps do Chat. Espaços nomeados incluem recursos extras que permitem que as conversas em grupo e as mensagens diretas sem nome não têm, como administradores que podem aplicar configurações administrativas, descrições e adicionar ou remover pessoas e apps. Depois de criar um espaço nomeado, o único participante do espaço é o usuário autenticado. O espaço não incluir outras pessoas ou apps; nem mesmo o app do Chat que o cria. Para adicionar pessoas, crie associações no espaço chamando Método create no(a) Recurso Member. Saiba como fazer isso em Criar uma assinatura.

Para criar um espaço nomeado com vários participantes, um chat em grupo sem nome entre de três ou mais pessoas, ou uma conversa de mensagem direta entre duas pessoas, ou um pessoa e o app do Chat chamando API Chat: configurar um espaço como alternativa.

Pré-requisitos

Python

Node.js

Criar um espaço nomeado

Para criar um espaço nomeado, 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 create no(a) Recurso Space.
  • Defina spaceType como SPACE.
  • Definir displayName ao nome do espaço visível para o usuário. No exemplo a seguir, displayName é definido como API-made.
  • Também é possível definir outros atributos de espaço, como spaceDetails (uma descrição visível para o usuário e um conjunto de diretrizes para o espaço).

Veja como criar um espaço nomeado:

Python

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

  2. Inclua o seguinte código em chat_space_create_named.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 creates a Chat 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().create(

      # Details about the space to create.
      body = {

        # To create a named space, set spaceType to SPACE.
        'spaceType': 'SPACE',

        # The user-visible name of the space.
        'displayName': 'API-made'
      }

      ).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_create_named.py

Node.js

  1. No diretório de trabalho, crie um arquivo chamado create-space.js.

  2. Inclua o seguinte código em create-space.js:

    const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Creates a new chat space.
* @return {!Promise<!Object>}
*/
async function createSpace() {
  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.create(
      {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}});
}

createSpace().then(console.log);

  3. No diretório de trabalho, execute o exemplo:

    node create-space.js

Um espaço nomeado é criado. Para navegar até o espaço, use o ID do recurso dele para criar o URL do espaço. Você pode encontrar o ID do recurso no espaço name no corpo da resposta do Google Chat. Por exemplo, se seu espaço name é spaces/1234567. Para navegar até o espaço, use o seguinte: URL: https://mail.google.com/chat/u/0/#chat/space/1234567.