Method: spaces.members.delete

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

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

  • 管理者による承認と承認スコープを使用したアプリ認証:

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

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

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app（スペースから通話アプリを削除するため）
    • https://www.googleapis.com/auth/chat.import（インポート モードのスペースのみ）
    • ユーザー認証では、管理者アカウントが認証され、useAdminAccess が true で、次の認可スコープが使用されている場合に、管理者権限が付与されます。
      • https://www.googleapis.com/auth/chat.admin.memberships

アプリ認証は、次のユースケースではサポートされていません。

  • スペースから Google グループを削除する。
  • スペースから Chat 用アプリを削除する。

スペースの管理者のメンバーシップを削除するには、リクエストを行うユーザーがスペースの管理者である必要があります。アプリ認証を使用している場合、Chat 用アプリはスペースの作成者である必要があります。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
name

string

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

ユーザー メンバーシップを削除する場合は、ユーザー認証の chat.memberships スコープ、またはアプリ認証の chat.memberships.app スコープと 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

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