Method: spaces.spaceEvents.list

Google Chat スペースのイベントを一覧表示します。各イベントのpayloadには、Chat リソースの最新バージョンが含まれます。たとえば、スペースの新しいメンバーに関するイベントを一覧表示すると、サーバーは最新のメンバーの詳細を含む Membership リソースを返します。リクエストした期間中に新しいメンバーが削除された場合、イベント ペイロードには空の Membership リソースが含まれます。

ユーザー認証が必要です。予定を一覧表示するには、認証済みのユーザーがスペースのメンバーである必要があります。

例については、Google Chat スペースのイベントを一覧表示するをご覧ください。

HTTP リクエスト

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。イベントが発生した Google Chat スペースのリソース名。

フォーマット: spaces/{space}

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返されるスペース イベントの最大数。サービスはこの値よりも少ない数を返す場合があります。

負の値を指定すると INVALID_ARGUMENT エラーが返されます。
pageToken

string

前のリストスペース イベント呼び出しから受け取ったページトークン。これを指定して、後続のページを取得します。

ページ分割の際には、スペース イベントを一覧表示するために指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果が生じる可能性があります。
filter

string

必須。クエリフィルタ。

has : 演算子を使用して、少なくとも 1 つのイベントタイプ（eventType）を指定する必要があります。複数のイベントタイプでフィルタするには、OR 演算子を使用します。フィルタでバッチ イベントタイプを省略します。このリクエストにより、関連するバッチイベントが自動的に返されます。たとえば、新しいリアクション（google.workspace.chat.reaction.v1.created）でフィルタすると、サーバーは新しいバッチのリアクション イベント（google.workspace.chat.reaction.v1.batchCreated）も返します。サポートされているイベントタイプの一覧については、SpaceEvents リファレンス ドキュメントをご覧ください。

必要に応じて、開始時間（startTime）と終了時間（endTime）でフィルタすることもできます。

  • startTime: スペース イベントの一覧表示を開始する排他的なタイムスタンプ。28 日前までに発生したイベントを一覧表示できます。指定しない場合、過去 28 日間のスペース イベントが一覧表示されます。
  • endTime: スペース イベントが一覧表示される時点を含むタイムスタンプ。指定しない場合、リクエスト時までのイベントが一覧表示されます。

開始時間または終了時間を指定するには、等価 = 演算子（RFC-3339 の形式）を使用します。startTime と endTime の両方でフィルタするには、AND 演算子を使用します。

たとえば、次のクエリは有効です。

startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"

startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")

次のクエリは無効です。

startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"

eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"

無効なクエリは INVALID_ARGUMENT エラーでサーバーによって拒否されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

スペースのイベントを一覧表示するレスポンス メッセージです。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
フィールド
spaceEvents[]

object (SpaceEvent)

結果は時系列（古いイベントから）で返されます。
nextPageToken

string

追加のイベントを取得するために使用される継続トークン。このフィールドを省略すると、後続のページはなくなります。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

詳しくは、承認ガイドをご覧ください。