本文へ移動
技術を、自社の仕事に。
判断と実行を助けるメディア

記事を検索

Chat APIでスレッドを既読に 返信の未読が残る問題

目次 · 5項目

Google Chatのスペースを問い合わせの窓口にして、届いた依頼を外部のチケットや台帳に転記する運用があります。転記の処理を自動にしても、担当者のChatには未読の印が残ります。スペースを既読にするAPIはこれまでもありましたが、それではスレッドの中の返信は既読にならず、処理済みかどうかを画面から見分けにくいままでした。

2026年11月16日、Google Chat APIのリリースノートで、スレッド単位で既読・未読を書き換える users.spaces.threads.updateThreadReadState が一般提供(Generally Available)になったと告知されました。本記事では、リリースノート、開発者向けのガイドとリファレンス、Discovery文書(APIの機械向けの定義)、Googleのクライアントライブラリの状況から、何ができるようになったかと、使う前に確かめる点を整理します。

スペースの既読とスレッドの既読は別

Chat APIには、利用者ごとの「どこまで読んだか」を表す2種類の資源があります。

資源名前の形式これまで2026年11月16日以降
スペースの既読(SpaceReadState)users/{user}/spaces/{space}/spaceReadState取得・更新変更なし
スレッドの既読(ThreadReadState)users/{user}/spaces/{space}/threads/{thread}/threadReadState取得のみ取得・更新

ポイントは、スペースの既読の更新(updateSpaceReadState)の説明にある一文です。スペースの既読の位置が効くのは、スペースの一番上の流れに見えているメッセージだけで、「スレッドの中の返信はこの時刻の影響を受けず、スレッドの既読の状態に従う」と書かれています。スペースをまとめて既読にしても、返信が付いたスレッドの未読は残る、ということです。

Google Chatのスペースの既読とスレッドの既読の関係を示す図。スペースの既読の位置は一番上の流れのメッセージにだけ効き、スレッドの中の返信はスレッドごとの既読の位置で決まる。2026年11月16日に一般提供になった updateThreadReadState で、スレッドの既読の位置もAPIで書き換えられる

updateThreadReadState の書き方

ガイドとリファレンスから読み取れる仕様は次のとおりです。

  • HTTPの PATCH で、パスは v1/users/{user}/spaces/{space}/threads/{thread}/threadReadState
  • 送る本文は ThreadReadState で、書き換えられる項目は lastReadTime(Discovery文書の表記では last_read_time)だけ
  • updateMask は必須。いま指定できるのはこの1項目だけです。リファレンスとガイドの本文は lastReadTime、Discovery文書とガイドのコード例は last_read_time と書いています
  • 既読にする: スレッドの最新のメッセージの作成時刻と同じかそれより後の時刻を入れる。未来の時刻はリクエストの時刻に丸められる
  • 未読に戻す: 最新のメッセージの作成時刻より前の時刻を入れる。ガイドによると、その時刻より後のメッセージが未読として扱われ、未読の数の表示、スレッドの太字、ホームへの表示が更新される
  • 1970-01-01T00:00:00Z より前の時刻は INVALID_ARGUMENT(400)になる
  • 利用者として認証し、スコープ https://www.googleapis.com/auth/chat.users.readstate を使う(読むだけなら chat.users.readstate.readonly で getThreadReadState)

ユーザーとして呼ぶ形なので、Chatアプリ(ボット)の権限や、管理者の権限で他人の既読を書き換える形は、資料に含まれていません。ガイドには「スレッドの既読の更新は、呼び出した利用者の既読の更新にだけ対応する」と明記されています。対象は me、本人のWorkspaceのメールアドレス、本人のユーザーIDのいずれかで指定します。ガイドの前提条件には、Google Chatを使えるBusinessまたはEnterpriseのGoogle Workspaceアカウントが挙がっています。

呼び出しは次のようになります。スレッドの名前は、メッセージの thread.name(spaces/{space}/threads/{thread})から取れます。

PATCH https://chat.googleapis.com/v1/users/me/spaces/SPACE_ID/threads/THREAD_ID/threadReadState?updateMask=last_read_time
Authorization: Bearer ユーザーのアクセストークン
Content-Type: application/json

{ "lastReadTime": "2026-11-18T01:23:45.678Z" }

ガイドのコード例は lastReadTime に現在時刻を入れています。外部のツールで処理する場合は、処理したスレッドの最新のメッセージの createTime を入れるのが安全です(編集部の提案)。処理の途中で新しい返信が来ても、その返信まで既読にしてしまわずに済みます。

同じ告知で、getThreadReadState の結果と、Google Workspace Events APIで受け取るスレッドの既読の通知(ThreadReadState のイベント)も、未読に戻されたことを lastReadTime に反映するようになったと書かれています。

Node.jsのライブラリはまだ未対応

2026年11月20日時点で、npmの次の2つのパッケージのどちらにも updateThreadReadState は入っていません(npm registryから取得したパッケージの中を検索して確認。getThreadReadState はどちらにもあります)。

  • @googleapis/chat の最新版 51.4.1(11月12日公開)。新しいメソッドの定義は、11月17日にgoogleapis/google-api-nodejs-clientのリポジトリに取り込まれた段階です
  • @google-apps/chat の最新版 0.35.0(10月12日公開)。ガイドのNode.jsのコード例はこのパッケージの updateThreadReadState を使っていますが、公開されている版にはまだありません

それまでは、上のようにHTTPで直接呼ぶか、ライブラリの更新を待ちます。

使いどころ(編集部の提案)

  1. 転記や処理を終えたスレッドだけを既読にする。 担当者が自分のアカウントで連携を許可したツールが、チケットの起票に成功したスレッドの既読の位置を進めます。起票に失敗したものは未読のまま残るので、画面の未読がそのまま「未処理」の目印になります。
  2. 差し戻したいスレッドを未読に戻す。 処理済みにしたあとで追加の対応が要るとわかったスレッドは、lastReadTime を最新のメッセージより前に戻すと、担当者の画面で未読として目立たせられます。
  3. スペースの既読と組み合わせる。 一番上の流れのメッセージは updateSpaceReadState、返信のあるスレッドは updateThreadReadState と分けて扱います。スペースだけを既読にしても返信の未読は消えません。
  4. 既読の状態を先に読む。 getThreadReadState の lastReadTime と、スレッドの最新のメッセージの createTime を比べ、人が読み終えたものに手を付けないようにします。
  5. スコープを最小限にする。 読むだけで足りる集計には chat.users.readstate.readonly を使います。

Chat APIでメッセージを探す・ピン留めする機能はメッセージの検索とピン留めの記事で、ボットの回答に出典を付ける機能は引用の記事で扱いました。

確かめていないこと

  • 実際の呼び出し。 Google Workspaceの検証用のアカウントでの呼び出しと、画面の未読の表示の変化は確かめていません。updateMask を lastReadTime と last_read_time のどちらで書いても通るかも、呼び出しでは確かめていません。
  • 管理者の設定の影響。 組織の管理者がChatやAPIの利用を制限している場合の扱いは、今回の資料には書かれていません。

2026年11月18日に、Google Chat APIのDiscovery文書(chat.googleapis.com、revision 20261115)と、googleapis/google-api-nodejs-clientの変更(コミット f4452ba、2026年11月17日)を確認し、npmの @googleapis/chat 51.4.1の型定義を調べました。11月20日に、Chat APIのリリースノート(11月16日の項)、ガイド「Update a user’s thread read state」とリファレンス(いずれも最終更新 2026-11-16)、Discovery文書(revision 20261117)、npmの @googleapis/chat 51.4.1と @google-apps/chat 0.35.0を確認しました(資料調査)。APIの呼び出しは行っていません。

Google ChatとほかのツールをつなぐしくみやGoogle Workspaceの運用は、グリームハブのIT・Google Workspace 無料相談で承っています。お問い合わせからご相談ください。

参考資料

この記事を共有XFacebook
鈴木 翔

技術の可能性に魅了され、学生時代からプログラミングとデジタルアートの分野に深い関心を持つ

この記事のテーマを、自社の次の一歩へ

自社に合う、Workspaceの進め方を。

移行するデータ、共有ルール、管理体制を整理し、導入から日々の運用までの進め方を考えます。

  • 移行と初期設定
  • 共有・権限の整理
  • 管理体制
Workspaceの導入・運用を相談する

構想段階からご相談いただけます。この記事の情報を相談フォームに引き継ぎます。

最新記事をメールで受け取る