Ce guide explique comment utiliser la méthode delete
sur la ressource membership
.
de l'API Google Chat pour exclure un membre d'un espace, ce que l'on appelle la suppression d'un
. Impossible de supprimer un gestionnaire d'espace s'il est le seul gestionnaire de l'espace
dans un espace. Désignez un autre utilisateur comme gestionnaire de l'espace avant de le supprimer
les adhésions.
La
Ressource Membership
indique si un utilisateur humain ou une application Google Chat est invité,
est inclus ou absent d'un espace.
Prérequis
Python
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Installez la Python Bibliothèque cliente des API Google.
- <ph type="x-smartling-placeholder"></ph>
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Exclure un membre d'un espace
Pour supprimer un utilisateur, un groupe Google ou une application Chat d'une espace:
- Pour supprimer un utilisateur ou un groupe Google, spécifiez l'autorisation
chat.memberships
le champ d'application. Pour supprimer une application Chat, spécifiez lechat.memberships.app
habilitation d'autorisation (les applications ne peuvent supprimer que les leurs adhésion ; et non celles d'autres applications). Nous vous recommandons de choisir un champ d'application restrictif permettant toujours à votre application de fonctionner. - Appelez la méthode
delete
. le Ressourcemembership
. - Transmettez l'
name
de l'abonnement à supprimer. Si l'abonnement appartient au groupe gestionnaire d'espace uniquement, désignez un autre utilisateur comme gestionnaire avant suppression de cet abonnement.
Pour supprimer un abonnement:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_membership_delete.py
. Ajoutez le code suivant dans
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()
Dans le code, remplacez les éléments suivants:
SPACE
: nom d'espace, que vous pouvez obtenir à partir de la méthodespaces.list
. dans l'API Chat ou via l'URL d'un espace.MEMBER
: nom d'appartenance, que vous pouvez obtenir à l'aide de la méthodespaces.members.list
dans l'API Chat. Pour supprimer l'abonnement d'une application, remplacezMEMBER
avecapp
.
Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_membership_delete.py
Si la requête aboutit, le corps de la réponse renvoie l'appartenance avec
'state': 'NOT_A_MEMBER'
, qui indique que le membre ne fait plus partie de l'espace.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Articles associés
- Obtenez des informations sur l'abonnement d'un utilisateur ou dans l'application Chat.
- Lister les membres d'un espace
- Modifier l'appartenance d'un utilisateur à un espace Google Chat
- Inviter ou ajouter un utilisateur ou une application Chat à un espace