Удаление пользователя или приложения Google Chat из группы

В этом руководстве объясняется, как использовать метод delete на ресурсе membership API Google Chat, чтобы удалить пользователя или приложение Chat из пространства, также известного как удаление членства. Менеджера пространства нельзя удалить, если он единственный менеджер пространства в пространстве. Прежде чем удалять это членство, назначьте другого пользователя менеджером пространства.

Ресурс Membership указывает, приглашен ли пользователь или приложение Google Chat в пространство, участвует в нем или отсутствует в нем.

Предварительные условия

Питон

  • Python 3.6 или выше
  • Инструмент управления пакетами pip

  • Новейшие клиентские библиотеки Google для Python. Чтобы установить или обновить их, выполните следующую команду в интерфейсе командной строки:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Проект Google Cloud с включенным и настроенным API Google Chat. Инструкции см. в разделе Создание приложения Google Chat .

  • Авторизация настроена для приложения Чат. Для удаления членства требуется аутентификация пользователя с областью авторизации chat.memberships или chat.memberships.app от пользователя, у которого есть разрешение на удаление указанного членства.

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

Чтобы удалить пользователя или приложение Chat из пространства:

  • Чтобы удалить пользователя, укажите область chat.memberships . Чтобы удалить приложение Chat, укажите область авторизации chat.memberships.app (приложения могут удалять только свое собственное членство, но не членство других приложений). Рекомендуется выбирать наиболее ограничительную область, которая по-прежнему позволяет вашему приложению функционировать.
  • Вызовите метод delete ресурса membership .
  • Передайте name членства, которое требуется удалить. Если членство принадлежит единственному менеджеру пространства в пространстве, назначьте другого пользователя менеджером пространства, прежде чем удалять это членство.

Вот как удалить членство:

Питон

  1. В своем рабочем каталоге создайте файл с chat_membership_delete.py .

  2. Включите следующий код chat_membership_delete.py :

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.memberships.app"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then deletes the specified membership.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().delete(

        # The membership to delete.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBER with a membership name.
        # Obtain the membership name from the memberships resource of
        # Chat API. To delete a Chat app's membership, replace MEMBER
        # with app; an alias for the app calling the API.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a membership, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. В коде замените следующее:

    • SPACE : имя пространства, которое можно получить с помощью метода spaces.list в Chat API или из URL-адреса пространства.

    • MEMBER : имя участника, которое можно получить с помощью метода spaces.members.list в Chat API. Чтобы удалить членство в приложении, замените MEMBER на app .

  4. В своем рабочем каталоге соберите и запустите пример:

    python3 chat_membership_delete.py

В случае успеха тело ответа возвращает членство со 'state': 'NOT_A_MEMBER' , указывая, что члена больше нет в пространстве.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}