Method: spaces.spaceEvents.list

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

リクエストされたデータの読み取りに適した認可スコープで、次のタイプの認証をサポートします。

  • デベロッパー プレビューの管理者による承認によるアプリ認証。次のいずれかの認証スコープを使用します。

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

  • 次のいずれかの認可スコープを使用したユーザー認証:

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

イベントを一覧表示するには、認証された呼び出し元がスペースのメンバーである必要があります。

例については、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

省略可。前回の list space events 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、スペース イベントのリストに指定する他のすべてのパラメータは、ページトークンを受け取った呼び出しと一致している必要があります。他のパラメータに異なる値を渡すと、予期しない結果が生じる可能性があります。
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)

結果は時系列順（最も古いイベントが最初）で返されます。注: permissionSettings フィールドは、リスト リクエストの Space オブジェクトでは返されません。
nextPageToken

string

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

認可スコープ

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

  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • 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

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