Удаление участника из пространства

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

Если вы администратор Google Workspace, вы можете удалять пользователей, группы Google или приложения чата из любого места в вашей организации Google Workspace.

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

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

Питон

• Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .

• Настройте свою среду:
  • Создайте проект Google Cloud .
  • Настройте экран согласия OAuth .
  • Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения Chat.
  • Установите клиентскую библиотеку Python Google API .
  • Создайте учетные данные идентификатора клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде файла JSON с именем client_secrets.json в локальном каталоге.
• Выберите область авторизации , которая поддерживает аутентификацию пользователей.

Удаление участника из пространства

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

• Чтобы удалить пользователя или группу Google, укажите область авторизации 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"
}

Удаление пользователей или групп Google из пространства в качестве администратора Google Workspace.

Если вы администратор Google Workspace, вы можете вызвать метод delete() , чтобы удалить пользователей, группы Google или приложения чата из любого места в вашей организации Google Workspace.

Чтобы вызвать этот метод от имени администратора Google Workspace, выполните следующие действия:

• Вызовите метод, используя аутентификацию пользователя, и укажите область авторизации , которая поддерживает вызов метода с правами администратора .
• В своем запросе укажите для параметра запроса useAdminAccess значение true .

Дополнительную информацию и примеры см. в разделе «Управление пространствами Google Chat от имени администратора Google Workspace» .

Связанные темы

• Получите подробную информацию о членстве пользователя или приложения Chat .
• Список участников в пространстве .
• Обновите членство пользователя в чате Google .
• Пригласите или добавьте пользователя или приложение чата в пространство .