Method: spaces.members.delete

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
name

string

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

人間のメンバーシップを削除する場合は、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.app.memberships
  • 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

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