Method: spaces.spaceEvents.get

Google Chat スペースからイベントを返します。イベント ペイロードには、変更されたリソースの最新バージョンが含まれます。たとえば、新しいメッセージに関するイベントをリクエストした後にメッセージが更新された場合、サーバーはイベント ペイロードで更新された Message リソースを返します。

注: このリクエストの Space イベントデータの Space オブジェクトでは、permissionSettings フィールドは返されません。

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

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

    • 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/{name=spaces/*/spaceEvents/*}

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

パスパラメータ

パラメータ
name

string

必須。スペース イベントのリソース名。

形式: spaces/{space}/spaceEvents/{spaceEvent}

リクエストの本文

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

レスポンスの本文

成功した場合、レスポンスの本文には SpaceEvent のインスタンスが含まれます。

認可スコープ

次の 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

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