Supprimer une balise avec l'API Google Tag Manager
Supprime une balise d'un workspace. Le site continue de la déclencher jusqu'à la publication d'une version sans elle.
- Identifiant
- google_tag_manager_delete_tag
L'appel
POST https://connect.reportei.com/api/tools/google_tag_manager_delete_tag/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"accountId": "<accountId>",
"containerId": "<containerId>",
"workspaceId": "<workspaceId>",
"tagId": "<tagId>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| accountId | string | Oui | Account id from List accounts. |
| containerId | string | Oui | Container id from List containers: the number in containerId, not the GTM- code of publicId. |
| workspaceId | string | Oui | Workspace id from List workspaces. |
| tagId | string | Oui | Tag id from List tags. |
Connexions possibles
Votre client connecte son compte Google Tag Manager une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/google_tag_manager, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/google_tag_manager_delete_tag. Il devient la définition de tool de votre agent sans conversion.
Autres tools Google Tag Manager
- Lister les comptesGETListe les comptes Tag Manager auxquels l'utilisateur a accès, avec accountId et name. Envoyez nextPageToken comme pageToken pour lire la page suivante.
- Lister les conteneursGETListe les conteneurs d'un compte, avec containerId, name, publicId (le code GTM- installé sur le site) et usageContext, comme web. Envoyez nextPageToken comme pageToken pour lire la page suivante.
- Lister les workspacesGETListe les workspaces d'un conteneur, avec workspaceId et name. Les balises et déclencheurs se modifient dans un workspace, en général Default Workspace, et n'atteignent le site que par Create version et Publish version.
- Lister les balisesGETListe les balises d'un workspace, avec tagId, name, type, parameter, firingTriggerId et paused. Envoyez nextPageToken comme pageToken pour lire la page suivante.
- Obtenir une baliseGETRenvoie une balise avec tous ses champs, y compris fingerprint. Update tag remplace toute la balise, partez donc de cette réponse.
- Créer une balisePOSTCrée une balise dans un workspace. Elle n'atteint le site qu'après Create version et Publish version. Sans firingTriggerId la balise ne se déclenche jamais.
- Mettre à jour une balisePUTRemplace toute une balise : envoyez tous les champs à conserver, tels que Get tag les renvoie, avec les modifications, car un champ omis est effacé. Passez paused à true pour arrêter une balise sans la supprimer. Le changement n'atteint le site qu'après Create version et Publish version.
- Lister les déclencheursGETListe les déclencheurs d'un workspace, avec triggerId, name, type et conditions. Un triggerId se place dans firingTriggerId ou blockingTriggerId d'une balise. Envoyez nextPageToken comme pageToken pour lire la page suivante.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
