Method: spaces.members.get

メンバーシップに関する詳細を返します。例については、ユーザーまたは Google Chat アプリのメンバーシップの詳細を取得するをご覧ください。

次のタイプの認証をサポートしています。

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

    • https://www.googleapis.com/auth/chat.bot
    • https://www.googleapis.com/auth/chat.app.memberships（管理者の承認が必要）

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

    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.memberships
    • ユーザー認証では、管理者アカウントが認証され、useAdminAccess が true で、次のいずれかの認可スコープが使用されている場合に、管理者権限が付与されます。
      • https://www.googleapis.com/auth/chat.admin.memberships.readonly
      • https://www.googleapis.com/auth/chat.admin.memberships

HTTP リクエスト

GET https://chat.googleapis.com/v1/{name=spaces/*/members/*}

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

パスパラメータ

パラメータ
name

string

必須。取得するメンバーシップのリソース名。

ユーザー認証を使用してアプリ独自のメンバーシップを取得するには、必要に応じて spaces/{space}/members/app を使用できます。

形式: spaces/{space}/members/{member} または spaces/{space}/members/app

ユーザーのメールアドレスを {member} のエイリアスとして使用できます。たとえば、spaces/{space}/members/example@gmail.com（example@gmail.com は Google Chat ユーザーのメールアドレス）。

クエリ パラメータ

パラメータ
useAdminAccess

boolean

省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。

呼び出しユーザーは、Chat とスペースの会話を管理する権限を持つ Google Workspace 管理者である必要があります。

chat.admin.memberships または chat.admin.memberships.readonly OAuth 2.0 スコープが必要です。

管理者アクセスを使用している場合、スペース内のアプリ メンバーシップの取得はサポートされていません。

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

  • https://www.googleapis.com/auth/chat.admin.memberships
  • https://www.googleapis.com/auth/chat.admin.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.memberships
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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