Google Chat API の概要

このセクションでは、Google Chat アプリから Chat API を使用すると、Chat アプリで次の操作を行えます。 スペースの作成、メンバーの追加、メッセージの投稿を行えます。

認証

Chat API の呼び出しには認証が必要です。各 Chat API メソッドを使用するには、 ユーザー認証 (アクションの実行や ユーザーに代わってデータを送信する場合) アプリの認証 (Chat 用アプリとしてアクションを実行したりデータにアクセスしたりする)。一部 ユーザー認証とアプリ認証の両方をサポートしています。

Chat での認証について詳しくは、以下をご覧ください。 認証の概要

クライアント ライブラリ

ほとんどのデベロッパーに推奨される Google Chat API の Google が公式にサポートしている Cloud クライアント ライブラリ Python、Java、Node.js など、使用する言語を選択できます。

Google Apps Script でコーディングする場合は、 高度な Chat サービス クライアント ライブラリをインストールする代わりに、

Google Chat API のコンセプト

gRPC サービスまたは REST リソースとメソッド Chat スペース、スペースのメンバー、メッセージ、メッセージ、 リアクション、メールの添付ファイル、スペースの予定、ユーザーの既読状況などです。

スペース

スペースは、ユーザーとアプリが会話したり、ファイルを共有したりできる場所です。そこで、 スペースにはいくつかの種類があります。ダイレクト メッセージ(DM)は 1 対 1 の会話 ユーザー間、またはユーザーと Chat 用アプリの間での通信です。グループ チャットとは、3 人以上のユーザーと、 Chat 用アプリ。名前付きスペースは、他のユーザーが メッセージの作成、ファイルの共有、共同編集が可能です。

リソース リファレンス:

使用例については、以下をご覧ください。

メンバー

メンバーとは、参加している、または参加しているユーザーと Chat アプリです。 スペースに招待されました。

リソース リファレンス:

使用例については、以下をご覧ください。

メッセージ

メッセージには、 テキスト および カード スペースに投稿されたやり取りをメッセージにはファイルを添付できます。 ユーザーは絵文字を追加してメッセージにリアクションできます。

リソース リファレンス:

使用例については、以下をご覧ください。

リアクション

リアクションとは、ユーザーがメッセージにリアクションする際に使用する絵文字を表します。たとえば、次のような絵文字です。 ✨、🚲?、GMB。

リソース リファレンス:

使用例については、以下をご覧ください。

メディアと添付ファイル

メディアは、Google Chat にアップロードされたファイル(画像、動画、 ドキュメントをご覧ください

メディア リソース リファレンス(RPC では利用できません):

添付ファイルは、メッセージに添付されたメディア(ファイル)のインスタンスです。

リソース リファレンス:

使用例については、以下をご覧ください。

スペース イベント

[スペースのイベント] は、スペースまたはスペースへの変更を表します。 子リソースとそのメンバー、メッセージ、リアクションが含まれます。

リソース リファレンス:

使用例については、以下をご覧ください。

ユーザーの読み取り状態

ユーザー読み取り状態は、読み取り状態の詳細を表すシングルトン リソースです。 Google Chat スペースまたはメッセージで特定のユーザーが最後に読んだメッセージ 使用します。

スペース読み取り状態リソースのリファレンス:

スレッド読み取り状態のリソースのリファレンス:

使用例については、以下をご覧ください。

Chat アプリでは、Chat API を呼び出すだけでなく、次のことも可能です。