En esta página, se proporciona una descripción general de cómo usar la API de Google Chat y su documentación de referencia.
La API de Google Chat tiene interfaces gRPC y REST, y bibliotecas cliente que admiten ambas. De manera opcional, si las bibliotecas cliente proporcionadas no satisfacen tus necesidades, puedes escribir tus propias bibliotecas cliente que usen 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 nuestras bibliotecas cliente de Cloud compatibles oficialmente para tu lenguaje preferido, como Python, Java o Node.js.
Si codificas con Google Apps Script, usa el 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, los métodos y los nombres de campo para la API de Google Chat varían de alguna manera:
- Las bibliotecas cliente de Cloud se organizan por servicios de gRPC y sus métodos. Las bibliotecas cliente de la API de Google se organizan como servicios que contienen objetos o clases que corresponden con recursos REST, que también contienen los métodos correspondientes.
- gRPC se organiza por servicios y sus métodos.
- REST se organiza por jerarquías de recursos y sus métodos.
- Los nombres de campo de gRPC usan el formato de escritura en mayúsculas y minúsculas.
- Los nombres de campos REST usan mayúsculas y minúsculas, aunque el servicio de API aceptará un camel case o snake case.
- Los nombres de campos de la biblioteca cliente usan mayúsculas, camel case o snake case, según el nombre idiomático para el idioma.
búferes de protocolo
Ya sea que uses bibliotecas cliente, REST o gRPC, el servicio subyacente se define con búferes de protocolo. En particular, el servicio usa proto3.
Cuando se llama a la API, algunos campos de solicitud o respuesta pueden requerir un conocimiento básico de los tipos conocidos del búfer de protocolo.
Además, cuando se llama a la API de REST, el comportamiento del valor predeterminado para los búferes de protocolo puede hacer que falten campos en una respuesta JSON. Estos campos se configuran con el valor predeterminado, por lo que no se incluyen en la respuesta.
Versiones de API
Las siguientes versiones de la API están disponibles:
- v1: Estable.
Versión preliminar para desarrolladores
En la documentación, es posible que veas métodos o campos de la API que solo están disponibles a través del programa de Versión preliminar para desarrolladores. Para probar y obtener una vista previa de las funciones de versión preliminar más recientes, y ofrecer comentarios sobre ellas, únete al Programa de Versión preliminar para desarrolladores.