本頁提供 Google Chat API 使用方式的總覽與參考資料 說明文件。
Google Chat API 同時包含 gRPC 和 REST 介面，以及 用戶端程式庫。選用 (如有) 提供的用戶端程式庫不符合您的需求 使用 gRPC 或 REST 介面的用戶端程式庫。
用戶端程式庫
對大多數開發人員呼叫 Google Chat API 的建議做法 包含正式支援的 Cloud 用戶端程式庫 。
如果您是透過 Google Apps Script 編寫程式碼，請使用 進階 Chat 服務 無須安裝用戶端程式庫
類型、方法和欄位名稱
類型取決於您使用的是用戶端程式庫、gRPC 還是 REST 方法和 Google Chat API 的欄位名稱可能稍有不同：
- Cloud 用戶端程式庫是由 gRPC 服務及其方法排列。 Google API 用戶端程式庫是以包含物件或 與 REST 資源相對應的類別，後者同時包含 方法。
- gRPC 是由服務及其方法排列。
- REST 是由資源階層及其方法排列而成。
- gRPC 欄位名稱採用蛇形大小寫。
- REST 欄位名稱使用駝峰式大小寫，但 API 服務接受 駝峰式大小寫或蛇殼。
- 用戶端程式庫欄位名稱採用每字字首大寫、駝峰式大小寫或蛇形 根據語言慣用的名稱而定。
通訊協定緩衝區
無論您使用用戶端程式庫、REST 還是 gRPC，基礎服務都是 使用通訊協定緩衝區定義。尤其是服務 使用的是 proto3。
呼叫 API 時，某些要求或回應欄位可能需具備 瞭解 通訊協定緩衝區常見的類型。
此外，呼叫 REST API 時 通訊協定的預設值行為 緩衝區可能導致 JSON 回應缺少欄位。這些欄位 ，因此就不會包含在回應中。
API 版本
可用的 API 版本如下：
- v1：穩定版。
開發人員預覽版
您在說明文件中看到的 API 方法或欄位， 提供的新功能測試、預覽及優惠 針對最新預覽功能提供意見，歡迎加入 開發人員預覽版計畫。