Criar um espaço com nome no Google Chat (original) (raw)

Este guia explica como criar um espaço nomeado usando o métodocreate()no recurso Spaceda API Google Chat.

Um espaço nomeado (em que ospaceType éSPACE) é um lugar onde as pessoas enviam mensagens, compartilham arquivos e colaboram. Os espaços nomeados podem incluir apps do Chat. Os espaços nomeados têm administradores que podem aplicar configurações administrativas, descrições e adicionar ou remover pessoas e apps.

Para criar diferentes tipos de espaços do Chat (incluindo mensagens diretas ou em grupo), use o método setUp() no recursoSpace para criar o espaço e adicionar participantes ao mesmo tempo. Para mais detalhes, configure um espaço.

Depois de criar um espaço nomeado, o único membro dele é o usuário autenticado. Para adicionar membros ao espaço, chame o métodocreate() no recurso Membershippara cada pessoa ou app que você quer adicionar. Ou use o método setUp() para criar um espaço nomeado e adicionar participantes ao mesmo tempo.

Pré-requisitos

Node.js

Python

Java

Apps Script

Criar um espaço nomeado como usuário

Para criar um espaço nomeado comautenticação de usuário, transmita o seguinte na sua solicitação:

Veja como criar um espaço nomeado:

Node.js

Python

Java

Apps Script

Criar um espaço nomeado como um app do Chat

A autenticação do app exige uma única aprovação do administrador.

Para convidar ou adicionar um usuário a um espaço comautenticação de app, transmita o seguinte na sua solicitação:

Escrever um script que chama a API Chat

Veja como criar um espaço nomeado:

Python

  1. No diretório de trabalho, crie um arquivo chamado chat_space_create_named_app.py.
  2. Inclua o seguinte código em chat_space_create_named_app.py:
from google.oauth2 import service_account  
from apiclient.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.app.spaces.create"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then creates a Chat space.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # 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',  
        # The customer ID of the Workspace domain.  
        'customer': 'CUSTOMER'  
      }  
      ).execute()  
    # Prints details about the created space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. No código, substitua o seguinte:
    • CUSTOMER: o ID do cliente do domínio do espaço no formato customer/{customer}, em que {customer} é o IDdorecurso de cliente do SDK Admin. Para criar um espaço na mesma organização do Google Workspace que o app Chat, use customers/my_customer.
  2. No diretório de trabalho, crie e execute a amostra:
python3 chat_space_create_named_app.py

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

Limitações e considerações