Esta seção explica como um app do Google Chat pode chamar a API Chat, que permite que os apps do Chat façam coisas como criar um espaço, adicionar pessoas a ele e postar uma mensagem.
Autenticação
A chamada da API Chat exige autenticação. Cada método da API Chat exige autenticação do usuário (para realizar ações ou acessar dados em nome de um usuário) ou autenticação do app (para realizar ações ou acessar dados como um app de chat). Alguns métodos oferecem suporte à autenticação do usuário e do app.
Para saber mais sobre a autenticação no Chat, consulte Visão geral da autenticação.
Bibliotecas de cliente
A maneira recomendada de chamar a API Google Chat é com nossas bibliotecas de cliente do Cloud com suporte oficial para a linguagem de sua preferência, como Python, Java ou Node.js.
Se você estiver codificando com o Google Apps Script, use o serviço de chat avançado em vez de instalar uma biblioteca de cliente.
Conceitos da API Google Chat
Os serviços gRPC ou os recursos e métodos REST concedem acesso a espaços do Chat, participantes de espaços, mensagens, reações a mensagens, anexos a mensagens, eventos de espaço e estados de leitura do usuário.
- Espaços
Os espaços são lugares onde as pessoas e os apps podem conversar e compartilhar arquivos. Há vários tipos de espaços. As mensagens diretas (DMs) são conversas individuais entre dois usuários ou um usuário e um app do Chat. Os chats em grupo são conversas entre três ou mais usuários e apps do Chat. Os espaços nomeados são lugares permanentes em que as pessoas enviam mensagens, compartilham arquivos e colaboram.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Membros
Os participantes são usuários e apps do Chat que entraram ou foram convidados para um espaço.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Mensagens
As mensagens incluem texto e cartões publicados nos espaços. As mensagens podem ter arquivos anexados. As pessoas podem reagir a mensagens anexando emojis a elas.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Reações
As reações representam os emojis que as pessoas usam para reagir a uma mensagem, como 👍, 🚲 e 🌞.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Emojis personalizados (prévia para desenvolvedores)
Emojis personalizados são emojis criados e compartilhados na organização no Google Chat. Os emojis personalizados podem ser incluídos no conteúdo de uma mensagem ou usados para reagir a ela.
Referência de recurso:
- Mídia e anexos
Mídia representa um arquivo enviado por upload ao Google Chat, como imagens, vídeos e documentos.
Referência do recurso de mídia (indisponível na RPC):
Anexos são instâncias de mídia (arquivos) anexadas a mensagens.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Eventos espaciais
Os eventos do espaço representam mudanças em um espaço ou nos recursos filhos, incluindo membros, mensagens e reações.
Referência de recurso:
Para conferir exemplos de uso, consulte:
- Estados de leitura do usuário
Os estados de leitura do usuário são recursos únicos que representam detalhes sobre a última mensagem lida de um usuário especificado em um espaço do Google Chat ou em uma linha de mensagens.
Referência de recurso de estado de leitura do espaço:
Referência de recurso de estado de leitura de linha de execução:
Para conferir exemplos de uso, consulte:
- Configurações de notificação do espaço do usuário (pré-lançamento para desenvolvedores)
As configurações de notificação do espaço do usuário são recursos únicos que representam as configurações de notificação de um usuário especificado em um espaço do Google Chat.
Referência de recurso:
Temas relacionados
- Confira exemplos de apps do Google Chat para começar a usar a API Chat.
Além de chamar a API Chat, os apps do Chat também podem:
- Receber e responder a eventos de interação do app Chat, como mensagens enviadas ao app Google Chat, em tempo real.
- Inscrever-se em eventos do Google Chat para realizar ações ou responder quando determinadas atividades ou mudanças ocorrerem no Chat, como novas mensagens e mudanças de associação.