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

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で直接呼ぶか、ライブラリの更新を待ちます。
使いどころ(編集部の提案)
- 転記や処理を終えたスレッドだけを既読にする。 担当者が自分のアカウントで連携を許可したツールが、チケットの起票に成功したスレッドの既読の位置を進めます。起票に失敗したものは未読のまま残るので、画面の未読がそのまま「未処理」の目印になります。
- 差し戻したいスレッドを未読に戻す。 処理済みにしたあとで追加の対応が要るとわかったスレッドは、
lastReadTimeを最新のメッセージより前に戻すと、担当者の画面で未読として目立たせられます。 - スペースの既読と組み合わせる。 一番上の流れのメッセージは
updateSpaceReadState、返信のあるスレッドはupdateThreadReadStateと分けて扱います。スペースだけを既読にしても返信の未読は消えません。 - 既読の状態を先に読む。
getThreadReadStateのlastReadTimeと、スレッドの最新のメッセージのcreateTimeを比べ、人が読み終えたものに手を付けないようにします。 - スコープを最小限にする。 読むだけで足りる集計には
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/chat51.4.1の型定義を調べました。11月20日に、Chat APIのリリースノート(11月16日の項)、ガイド「Update a user’s thread read state」とリファレンス(いずれも最終更新 2026-11-16)、Discovery文書(revision 20261117)、npmの@googleapis/chat51.4.1と@google-apps/chat0.35.0を確認しました(資料調査)。APIの呼び出しは行っていません。
Google ChatとほかのツールをつなぐしくみやGoogle Workspaceの運用は、グリームハブのIT・Google Workspace 無料相談で承っています。お問い合わせからご相談ください。
参考資料
- Google for Developers — Google Chat API release notes
- Google for Developers — Update a user’s thread read state
- Google for Developers — Method: users.spaces.threads.updateThreadReadState
- Google Chat API Discovery文書(v1)
- GitHub — googleapis/google-api-nodejs-client「feat(chat): update the API」(f4452ba)
- npm — @googleapis/chat
- npm — @google-apps/chat








