Nesta página, você terá uma visão geral de como usar a API Google Chat e a documentação de referência dela.
A API Google Chat tem interfaces gRPC e REST, além de bibliotecas de cliente que oferecem suporte a ambas. Se as bibliotecas de cliente fornecidas não atenderem às suas necessidades, você poderá escrever suas próprias bibliotecas que usam a interface gRPC ou REST.
Bibliotecas de cliente
A maneira recomendada para a maioria dos desenvolvedores chamar a API Google Chat é com as bibliotecas de cliente do Cloud oficialmente compatíveis para sua linguagem preferida, como Python, Java ou Node.js.
Se você estiver programando com o Google Apps Script, use o serviço avançado do Chat em vez de instalar uma biblioteca de cliente.
Tipo, método e nomes de campos
Dependendo de você usar bibliotecas de cliente, gRPC ou REST, o tipo, o método e os nomes dos campos da API Google Chat variam um pouco:
- As bibliotecas de cliente do Cloud são organizadas por serviços gRPC e seus métodos. As bibliotecas de cliente da API do Google são organizadas como serviços que contêm objetos ou classes correspondentes a recursos REST, que também contêm métodos correspondentes.
- O gRPC é organizado por serviços e métodos.
- O REST é organizado por hierarquias de recursos e seus métodos.
- Os nomes dos campos do gRPC usam maiúsculas e minúsculas.
- Os nomes dos campos REST usam letras concatenadas, mas o serviço da API aceita maiúsculas e minúsculas.
- Os nomes dos campos das bibliotecas de cliente usam maiúsculas ou minúsculas e a concatenação de texto, dependendo do nome idiomático da linguagem.
buffers de protocolo
Se você estiver usando bibliotecas de cliente, REST ou gRPC, o serviço subjacente será definido usando buffers de protocolo. Em particular, o serviço usa proto3.
Ao chamar a API, alguns campos de solicitação ou resposta podem exigir uma compreensão básica dos tipos conhecidos de buffer de protocolo.
Além disso, ao chamar a API REST, o comportamento do valor padrão para buffers de protocolo pode resultar em campos ausentes em uma resposta JSON. Esses campos são definidos como o valor padrão e, portanto, não são incluídos na resposta.
Versões da API
As seguintes versões de API estão disponíveis:
- v1: estável.
Prévia para desenvolvedores
Na documentação, você pode encontrar métodos ou campos da API que só estão disponíveis no Programa de prévia para desenvolvedores. Para testar, visualizar e dar feedback sobre os recursos mais recentes, participe do Programa de prévia para desenvolvedores.