Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 de 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 escribes código 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 las APIs de Google se organizan como servicios que contienen objetos o clases que se corresponden con recursos de REST, que también contienen 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 snake case.
Los nombres de campos REST usan camel case, aunque el servicio de API aceptará un camel case o snake case.
Los nombres de campos de la biblioteca cliente usan 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 una comprensión básica de los tipos conocidos de 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 generar campos faltantes en una respuesta JSON. Estos campos se establecen en 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 las funciones de versión preliminar más recientes, obtener una vista previa de ellas y ofrecer comentarios, únete al Programa de versión preliminar para desarrolladores.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eThis page offers guidance on utilizing the Google Chat API and navigating its reference documentation, including gRPC and REST interfaces.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to use the provided client libraries for Python, Java, Node.js, or the Advanced Chat service for Google Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eType, method, and field names may vary slightly depending on whether you are using client libraries, gRPC, or REST, with details provided on their respective conventions.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Chat API is built upon protocol buffers, specifically proto3, which may require a basic understanding for certain request and response fields.\u003c/p\u003e\n"],["\u003cp\u003eStable API version v1 is currently available, with access to developer preview features obtainable through the Developer Preview Program.\u003c/p\u003e\n"]]],["The Google Chat API offers gRPC and REST interfaces, with corresponding client libraries or the option to create custom ones. Developers can use Cloud Client Libraries, or the Advanced Chat service with Google Apps Script. Type, method, and field names vary across libraries, gRPC, and REST. The API relies on protocol buffers (proto3), which can impact JSON responses due to default value behavior. The current stable version is v1, with a Developer Preview program for testing new features.\n"],null,["# Google Chat API overview\n\nThis page provides an overview of how to use Google Chat API and its reference\ndocumentation.\n\nGoogle Chat API has both [gRPC](/workspace/chat/api/reference/rpc) and\n[REST](/workspace/chat/api/reference/rest) interfaces, and\n[client libraries](/workspace/chat/libraries) that support both. Optionally, if\nthe provided client libraries don't meet your needs, you can write your own\nclient libraries that use the gRPC or REST interface.\n\nClient libraries\n----------------\n\nThe recommended way for most developers to call the Google Chat API\nis with our officially supported\n[Cloud Client Libraries](/workspace/chat/libraries)\nfor your preferred language, like Python, Java, or Node.js.\n\nIf you're coding with Google Apps Script, use the\n[Advanced Chat service](/apps-script/advanced/chat)\ninstead of installing a client library.\n\nType, method, and field names\n-----------------------------\n\nDepending on whether you're using client libraries, gRPC, or REST, the type,\nmethod, and field names for the Google Chat API vary somewhat:\n\n- Cloud Client Libraries are arranged by gRPC services and their methods. Google API Client Libraries are arranged as services that contain objects or classes that correspond with REST resources, which also contain corresponding methods.\n- gRPC is arranged by services and their methods.\n- REST is arranged by resource hierarchies and their methods.\n- gRPC field names use snake case.\n- REST field names use camel case, though the API service will accept either camel case or snake case.\n- Client library field names use either title case, camel case or snake case, depending on which name is idiomatic for the language.\n\nProtocol buffers\n----------------\n\nWhether you are using client libraries, REST, or gRPC, the underlying service is\ndefined using [protocol buffers](/protocol-buffers). In particular, the service\nuses [proto3](/protocol-buffers/docs/proto3).\n\nWhen calling the API, some request or response fields can require a basic\nunderstanding of\n[protocol buffer well-known types](/protocol-buffers/docs/reference/google.protobuf).\n\nIn addition, when calling the REST API, the\n[default value](/protocol-buffers/docs/proto3#default) behavior for protocol\nbuffers may result in missing fields in a JSON response. These fields are\nset to the default value, so they are not included in the response.\n\nAPI versions\n------------\n\nThe following API versions are available:\n\n- **v1**: Stable.\n\nDeveloper Preview\n-----------------\n\nIn the documentation, you might see API methods or fields that are only\navailable through the Developer Preview Program. To test and preview and offer\nfeedback on the latest preview features, join the\n[Developer Preview Program](/workspace/preview).\n\nRelated topics\n--------------\n\n- [Call the Google Chat API](/workspace/chat/api-overview)"]]
