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 должно быть создателем пространства.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
name

string

Обязательно. Имя ресурса, к которому относится удаляемое членство. Приложения чата могут удалять членства пользователей или свои собственные. Приложения чата не могут удалять членства других приложений.

При удалении членства пользователя требуется область 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 пользователя.

Вызывающий пользователь должен быть администратором Google Workspace с привилегией управления чатами и беседами в пространствах .

Требуется область действия OAuth 2.0 chat.admin.memberships .

Удаление членства в приложении в пространстве не поддерживается с использованием прав администратора.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр 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

Более подробную информацию смотрите в Руководстве по авторизации .