Google Chat API の概要

このページでは、Google Chat API とそのリファレンス ドキュメントの使用方法の概要について説明します。

Google Chat API には、gRPC と REST の両方のインターフェースと、両方をサポートするクライアント ライブラリがあります。必要に応じて、提供されているクライアント ライブラリがニーズを満たしていない場合は、gRPC または REST インターフェースを使用する独自のクライアント ライブラリを作成できます。

クライアント ライブラリ

ほとんどの開発者が Google Chat API を呼び出すには、Python、Java、Node.js などの任意の言語用に公式にサポートされている 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 メソッドやフィールドが記載されている場合があります。最新のプレビュー機能をテストしてプレビューし、フィードバックを提供するには、デベロッパー プレビュー プログラムにご参加ください。