В этом руководстве объясняется, как использовать метод delete
на ресурсе membership
API Google Chat для удаления участника из пространства, также известного как удаление членства. Менеджера пространства нельзя удалить, если он единственный менеджер пространства в пространстве. Прежде чем удалять это членство, назначьте другого пользователя менеджером пространства.
Ресурс Membership
указывает, приглашен ли пользователь или приложение Google Chat в пространство, участвует в нем или отсутствует в нем.
Предварительные условия
Питон
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
- Python 3.6 или выше
- Инструмент управления пакетами pip
- Новейшие клиентские библиотеки Google. Чтобы установить или обновить их, выполните следующую команду в интерфейсе командной строки:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения Chat.
- Создайте учетные данные идентификатора клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде файла JSON (
client_secrets.json
) в локальном каталоге.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
Удаление участника из пространства
Чтобы удалить пользователя, группу Google или приложение Chat из пространства:
- Чтобы удалить пользователя или группу Google, укажите область авторизации
chat.memberships
. Чтобы удалить приложение Chat, укажите область авторизацииchat.memberships.app
(приложения могут удалять только свое собственное членство, но не членство других приложений). Рекомендуется выбирать наиболее ограничительную область, которая по-прежнему позволяет вашему приложению функционировать. - Вызовите метод
delete
ресурсаmembership
. - Передайте
name
членства, которое требуется удалить. Если членство принадлежит единственному менеджеру пространства в пространстве, назначьте другого пользователя менеджером пространства, прежде чем удалять это членство.
Вот как удалить членство:
Питон
- В своем рабочем каталоге создайте файл с
chat_membership_delete.py
. Включите следующий код
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()
В коде замените следующее:
SPACE
: имя пространства, которое можно получить с помощью методаspaces.list
в Chat API или из URL-адреса пространства.MEMBER
: имя участника, которое можно получить с помощью методаspaces.members.list
в Chat API. Чтобы удалить членство в приложении, заменитеMEMBER
наapp
.
В своем рабочем каталоге соберите и запустите пример:
python3 chat_membership_delete.py
В случае успеха тело ответа возвращает членство со 'state': 'NOT_A_MEMBER'
, указывая, что члена больше нет в пространстве.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Связанные темы
- Получите подробную информацию о членстве пользователя или приложения Chat .
- Список участников в пространстве .
- Обновите членство пользователя в чате Google .
- Пригласите или добавьте пользователя или приложение чата в пространство .