本页面简要介绍如何使用 Google Chat API 及其参考文档。
Google Chat API 具有 gRPC 和 REST 接口，以及 支持这两种接口的客户端库。（可选）如果提供的客户端库无法满足您的需求，您可以自行编写使用 gRPC 或 REST 接口的客户端库。
客户端库
对于大多数开发者来说，调用 Google Chat API 的推荐方式是使用我们官方支持的 Cloud 客户端库 ，这些库支持您偏好的语言，例如 Python、Java 或 Node.js。
如果您使用 Google Apps 脚本进行编码，请使用 高级 Chat 服务 ，而不是安装客户端库。
类型、方法和字段名称
根据您使用的是客户端库、gRPC 还是 REST，Google Chat API 的类型、方法和字段名称略有不同：
- Cloud 客户端库按 gRPC 服务及其方法进行安排。 Google API 客户端库按服务进行安排，这些服务包含与 REST 资源对应的对象或类，这些对象或类也包含相应的方法。
- gRPC 按服务及其方法进行安排。
- REST 按资源层次结构及其方法进行安排。
- gRPC 字段名称使用蛇形命名法。
- REST 字段名称使用驼峰式命名法，但 API 服务将接受驼峰式命名法或蛇形命名法。
- 客户端库字段名称使用词首字母大写形式、驼峰式命名法或蛇形命名法，取决于哪种名称对于语言是惯用的。
Protocol Buffers
无论您使用的是客户端库、REST 还是 gRPC，底层服务都是 使用 Protocol Buffers 定义的。具体来说，该服务 使用 proto3。
调用 API 时，某些请求或响应字段可能需要您对 Protocol Buffers 的已知类型有基本的 了解 。
此外，调用 REST API 时， Protocol Buffers 的默认值行为可能会导致 JSON 响应中缺少字段。这些字段设置为默认值，因此不会包含在响应中。
API 版本
API 有以下版本：
- v1：稳定版。
开发者预览版
在文档中，您可能会看到仅通过开发者预览版计划提供的 API 方法或字段。如需测试和预览最新预览版功能并提供 反馈，请加入 开发者试用计划。