Configurar a API Google Chat

Cada app do Google Chat que você cria precisa de um Projeto do Google Cloud com a API Chat ativada e configurada. Esta página mostra como configurar a API Chat.

Pré-requisitos

Escolha um nome de exibição, avatar e descrição para o app do Chat

Para chamar a API Chat, você precisa configurar uma App Google Chat com as seguintes informações:

Campo Descrição Formato
Nome do app O nome de exibição do app do Chat. Até 25 caracteres alfanuméricos
URL do avatar A imagem que aparece como o nome do seu app do Chat avatar. Um URL HTTPS que aponta para uma imagem quadrada (PNG ou JPEG). O tamanho recomendado é de 256 por 256 pixels ou mais.
Descrição Uma breve descrição de que a finalidade App Chat. Até 40 caracteres alfanuméricos

O nome, o avatar e a descrição do app do Chat são exibidos para os usuários na interface do Chat. Para algumas APIs Chat de gravação, o Chat usa essas informações para atribuir os ações que um app do Chat realiza no Chat.

Por exemplo, se você chamar o método spaces.create(), o Chat inclui o nome do app do Chat no descrição de quem criou o espaço, conforme mostrado na imagem abaixo:

O app Google Chat cria um espaço para um usuário.
Figura 1. A mensagem de atribuição que o Chat aparece quando o método spaces.create() é usado para criar um em nome de um usuário.

Para interagir com os apps do Chat, os usuários também podem ver ou usar este informações da seguinte maneira:

  • Invoque o app do Chat @mencionando o nome dele.
  • Encontre e inicie uma mensagem direta com o app do Chat. No menu Apps, as mensagens diretas exibem o Nome e avatar do app de chat.
  • Na barra de escrita, os usuários podem navegar pelos apps do Chat e conferir nome, avatar e descrição.

Configurar o app do Chat no console do Google Cloud

Quando tiverem os detalhes do app do Chat, abra o Cloud e configure a API Chat:

  1. No console do Google Cloud, acesse a página da API Chat e clique no Configuração:

    Acessar a página de configuração da API Chat

  2. Em Informações do aplicativo, preencha o Nome do aplicativo, o URL do avatar, e Descrição.

  3. Em "Recursos interativos", clique no botão de alternância Ativar recursos interativos. para desativar os recursos interativos do App Chat. Você pode configurar isso mais tarde. Para saber mais sobre como configurar e criar recursos interativos, consulte Receber e responder a interações do usuário.

  4. Opcional: em Registros, marque a caixa de seleção Registrar erros no Logging para usar o Google Cloud Logging. Para mais informações, consulte Registros de erros de consulta para apps do Chat.

  5. Clique em Salvar.

Conceder a outras pessoas permissão para configurar um app do Chat

Você pode conceder acesso a usuários específicos para a página de configuração do app do Chat. Use o IAM para proprietário de apps de chat e leitor de apps de chat papéis de segurança na nuvem. Os usuários com estas funções não podem acessar os apps do Chat de configuração do Terraform usando as APIs e de serviços, mas pode acesse a página de configuração no console do Google Cloud da Projeto host do Cloud do app de chat da seguinte forma:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Em que PROJECT_ID é o ID do projeto da Projeto do Google Cloud que hospeda o app do Chat.