Cette page explique comment supprimer un abonnement Google Workspace à l'aide de la méthode subscriptions.delete()
.
Lorsque vous supprimez un abonnement, votre application ne reçoit plus d'événements. Si un abonnement expire, l'API Google Workspace Events le supprime automatiquement.
Prérequis
Apps Script
- Un abonnement Google Workspace Pour en créer un, consultez la section Créer un abonnement.
Nécessite l'authentification de l'utilisateur avec un ou plusieurs champs d'application compatibles avec tous les types d'événements de l'abonnement.
- Un projet Apps Script:
- Utilisez votre projet Google Cloud au lieu de celui créé automatiquement par Apps Script.
- Pour tous les champs d'application que vous avez ajoutés pour configurer l'écran de consentement OAuth, vous devez également les ajouter au fichier
appsscript.json
de votre projet Apps Script. Exemple : - Activez le service avancé
Google Workspace Events
.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Python
- Python 3.6 ou version ultérieure
- Outil de gestion des paquets pip
- Dernières bibliothèques clientes Google pour Python. Pour les installer ou les mettre à jour, exécutez la commande suivante dans votre interface de ligne de commande:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Un abonnement Google Workspace Pour en créer un, consultez la section Créer un abonnement.
Authentification requise:
- Pour l'authentification des utilisateurs, une portée compatible avec au moins l'un des types d'événements de l'abonnement est requise. Pour identifier une portée, consultez Portées par type d'événement.
- Pour l'authentification des applications, l'étendue
chat.bot
est requise (applications Google Chat uniquement).
Supprimer un abonnement autorisé par un utilisateur
L'exemple de code suivant supprime une ressource Subscription
à l'aide de l'authentification utilisateur.
Pour supprimer un abonnement:
Apps Script
Dans votre projet Apps Script, créez un fichier de script nommé
deleteSubscription
et ajoutez le code suivant:function deleteSubscription() { // The name of the subscription to delete. const name = 'subscriptions/SUBSCRIPTION_ID'; // Call the Workspace Events API using the advanced service. const response = WorkspaceEvents.Subscriptions.remove(name); console.log(response); }
Remplacez les éléments suivants :
Pour supprimer l'abonnement, exécutez la fonction
deleteSubscription
dans votre projet Apps Script.
Python
Dans votre répertoire de travail, créez un fichier nommé
delete_subscription.py
et ajoutez le code suivant:"""Delete subscription.""" from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Specify required scopes. SCOPES = ['SCOPE'] # Authenticate with Google Workspace and get user authentication. flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES) CREDENTIALS = flow.run_local_server() # Call the Workspace Events API using the service endpoint. service = build( 'workspaceevents', 'v1', credentials=CREDENTIALS, ) NAME = 'subscriptions/SUBSCRIPTION_ID' response = service.subscriptions().delete(name=NAME).execute() print(response)
Remplacez les éléments suivants :
SCOPE
: champ d'application OAuth compatible avec au moins un type d'événement de l'abonnement. Par exemple, si votre abonnement reçoit des événements d'un espace Chat mis à jour,https://www.googleapis.com/auth/chat.spaces.readonly
.SUBSCRIPTION_ID
: ID de l'abonnement. Pour obtenir l'ID, vous pouvez utiliser l'une des méthodes suivantes :
Dans votre répertoire de travail, assurez-vous d'avoir stocké vos identifiants d'ID client OAuth et d'avoir nommé le fichier
client_secrets.json
. L'exemple de code utilise ce fichier JSON pour s'authentifier auprès de Google Workspace et obtenir les identifiants utilisateur. Pour obtenir des instructions, consultez Créer des identifiants ID client OAuth.Pour supprimer l'abonnement, exécutez la commande suivante dans votre terminal:
python3 delete_subscription.py
Subscription
.