Esta página oferece 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 compatíveis com ambas. Se as bibliotecas de cliente fornecidas não atenderem às suas necessidades, você pode escrever as próprias bibliotecas que usam a interface gRPC ou REST.
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.
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 métodos. As bibliotecas de cliente da API 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 hierarquia de recursos e 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
Seja usando bibliotecas de cliente, REST ou gRPC, o serviço subjacente é 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 um entendimento básico 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, 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, talvez você encontre métodos ou campos de API que só estão disponíveis no Programa de prévia para desenvolvedores. Para testar e visualizar e oferecer feedback sobre os recursos de visualização mais recentes, participe do Programa de visualização para desenvolvedores.