Visão geral da API Google Chat

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.