Visão geral da API Google Chat

Esta seção explica como um app do Google Chat pode chamar a API Chat, que permite aos apps do Chat fazer coisas como criar, adicionar pessoas e postar mensagens.

Autenticação

Chamar a API Chat requer autenticação. Cada O método da API Chat exige autenticação de usuários (para realizar ações ou acessar em nome de um usuário) ou autenticação de apps (para realizar ações ou acessar dados como um app do Chat). Algumas oferecem suporte à autenticação do usuário e do aplicativo.

Para saber mais sobre a autenticação no Chat, consulte Visão geral da autenticação.

Bibliotecas de cliente

A maneira recomendada para a maioria dos desenvolvedores chamar a API Google Chat é com nossa plataforma Bibliotecas de cliente do Cloud para sua linguagem preferida, como Python, Java ou Node.js.

Se você estiver codificando com o Google Apps Script, use a Serviço avançado do Chat em vez de instalar uma biblioteca de cliente.

Conceitos da API Google Chat

Serviços gRPC ou recursos e métodos REST conceder acesso a espaços do Chat, participantes, mensagens e mensagens reações, anexos de mensagens, eventos do espaço e estados de leitura do usuário.

Espaços

Os espaços são lugares onde pessoas e apps podem conversar e compartilhar arquivos. há vários tipos de espaços. As mensagens diretas são conversas individuais. entre dois usuários ou um usuário e um app do Chat. Grupo Os chats são conversas entre três ou mais usuários e Apps de chat Os espaços nomeados são lugares que as pessoas costumam enviar e-mails trocar mensagens, compartilhar arquivos e colaborar.

Referência de recursos:

Para conferir exemplos de uso, consulte:

Membros

Os participantes são usuários e apps do Chat que participaram ou estão participando. foi convidado para um espaço.

Referência de recursos:

Para conferir exemplos de uso, consulte:

Mensagens

As mensagens incluem texto e card de comunicação postadas nos espaços. As mensagens podem ter arquivos anexados. As pessoas podem reagir às mensagens adicionando emojis a elas.

Referência de recursos:

Para conferir exemplos de uso, consulte:

Reações

As reações representam o emoji que as pessoas usam para reagir a uma mensagem, como 👍, 🚲 e 🎆

Referência de recursos:

Para conferir exemplos de uso, consulte:

Mídia e anexos

Mídia representa um arquivo enviado para o Google Chat, como imagens, vídeos e documentos.

Referência de recursos de mídia (indisponível em RPC):

Anexos são instâncias de mídia (arquivos) anexadas às mensagens.

Referência de recursos:

Para conferir exemplos de uso, consulte:

Eventos do espaço

Os eventos do espaço representam mudanças em um espaço ou na recursos filhos, incluindo participantes, mensagens e reações.

Referência de recursos:

Para conferir exemplos de uso, consulte:

Estados de leitura do usuário

Os estados de leitura do usuário são recursos singleton que representam detalhes sobre um a última mensagem lida de um usuário especificado em um espaço ou uma mensagem do Google Chat fio

Referência do recurso de estado de leitura do espaço:

Referência do recurso de estado de leitura da linha de execução:

Para conferir exemplos de uso, consulte:

Além de chamar a API Chat, os apps do Chat também podem: