Google Chat API 總覽

本頁提供 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 方法或欄位， 提供的新功能測試、預覽及優惠 針對最新預覽功能提供意見，歡迎加入 開發人員預覽版計畫。