Method: spaces.members.delete

メンバーシップを削除します。例については、ユーザーまたは Google Chat アプリをスペースから削除するをご覧ください。

ユーザー認証が必要です。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
name

string

必須。削除するメンバーシップのリソース名。Chat アプリでは、人間のユーザーや自分のメンバーシップを削除できます。Chat アプリは他のアプリのメンバーシップを削除できません。

人間のメンバーシップを削除する場合は、chat.memberships スコープと spaces/{space}/members/{member} 形式が必要です。このメールアドレスを {member} のエイリアスとして使用できます。たとえば、spaces/{space}/members/example@gmail.com のようにします。ここで、example@gmail.com は Google Chat ユーザーのメールアドレスです。

アプリのメンバーシップを削除する場合は、chat.memberships.app スコープと spaces/{space}/members/app 形式が必要です。

形式は spaces/{space}/members/{member} または spaces/{space}/members/app です。

クエリ パラメータ

パラメータ
useAdminAccess

boolean

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

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

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

管理者権限を使用する場合、スペースでアプリ メンバーシップを削除することはできません。

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

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

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