En esta página, se proporciona una descripción general del uso de la API de Google Chat y su referencia en la documentación de Google Cloud.
La API de Google Chat tiene gRPC y Interfaces de REST y bibliotecas cliente que admiten ambos. De manera opcional, si porque las bibliotecas cliente proporcionadas no satisfacen tus necesidades, puedes escribir las tuyas las bibliotecas cliente que usan la interfaz gRPC o REST.
Bibliotecas cliente
La forma recomendada para que la mayoría de los desarrolladores llamen a la API de Google Chat es con nuestra asistencia oficial Bibliotecas cliente de Cloud para tu lenguaje preferido, como Python, Java o Node.js.
Si estás programando con Google Apps Script, usa la Servicio de chat avanzado en lugar de instalar una biblioteca cliente.
Tipo, método y nombres de campo
Según si usas bibliotecas cliente, gRPC o REST, el tipo y los nombres de los campos de la API de Google Chat varían un poco:
- Las bibliotecas cliente de Cloud se organizan por servicios de gRPC y sus métodos. Las bibliotecas cliente de las APIs de Google se organizan como servicios que contienen objetos o que corresponden a los recursos REST, que también contienen las .
- gRPC se organiza por servicios y sus métodos.
- REST se organiza según las jerarquías de recursos y sus métodos.
- Los nombres de campos de gRPC usan mayúsculas y minúsculas.
- Los nombres de los campos de REST usan mayúsculas mediales, aunque el servicio de la API aceptará mayúsculas mediales o snake case.
- Los nombres de los campos de la biblioteca cliente usan mayúsculas de título, mayúsculas mediales o snake case. según qué nombre sea idiomático para el idioma.
búferes de protocolo
Ya sea que uses bibliotecas cliente, REST o gRPC, el servicio subyacente es definido mediante búferes de protocolo. En particular, el servicio usa proto3.
Cuando se llama a la API, algunos campos de solicitud o respuesta pueden requerir una comprensión de tipos conocidos de búferes de protocolo.
Además, cuando llames a la API de REST, el comportamiento del valor predeterminado para el protocolo búferes pueden provocar campos faltantes en una respuesta JSON. Estos campos son con el valor predeterminado, por lo que no se incluyen en la respuesta.
Versiones de API
Están disponibles las siguientes versiones de la API:
- v1: Estable.
Versión preliminar para desarrolladores
En la documentación, es posible que veas métodos o campos de API que solo disponibles a través del Programa de Versión preliminar para desarrolladores. Para probar, obtener una vista previa y ofrecer comentarios sobre las funciones de versión preliminar más recientes, únase al Programa de Versión preliminar para desarrolladores.