Met à jour une balise GTM. Essayer maintenant
Requête
Requête HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
path |
string |
Chemin relatif de l'API de la balise GTM. Exemple : accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id} |
Paramètres de requête facultatifs | ||
fingerprint |
string |
Lorsqu'elle est fournie, cette empreinte doit correspondre à l'empreinte du tag dans l'espace de stockage. |
Autorisation
Cette requête nécessite une autorisation ayant le champ d'application suivant:
Définition du champ d'application |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Dans le corps de la requête, fournissez une ressource de tags avec les propriétés suivantes:
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
Propriétés obligatoires | |||
consentSettings.consentType.type |
string |
Type de paramètre. Voici les valeurs possibles:
Valeurs acceptées :
|
accessible en écriture |
monitoringMetadata.type |
string |
Type de paramètre. Voici les valeurs possibles:
Valeurs acceptées :
|
accessible en écriture |
name |
string |
Nom à afficher du tag. | accessible en écriture |
parameter[].type |
string |
Type de paramètre. Voici les valeurs possibles:
Valeurs acceptées :
|
accessible en écriture |
priority.type |
string |
Type de paramètre. Voici les valeurs possibles:
Valeurs acceptées :
|
accessible en écriture |
type |
string |
Type de balise GTM. | accessible en écriture |
Propriétés facultatives | |||
blockingRuleId[] |
list |
Blocage d'ID de règles Si l'une des règles listées renvoie la valeur "true", la balise ne se déclenche pas. | accessible en écriture |
blockingTriggerId[] |
list |
Blocage des ID de déclencheurs Si l'un des déclencheurs listés renvoie la valeur "true", la balise ne se déclenchera pas. | accessible en écriture |
consentSettings |
nested object |
Paramètres de consentement d'une balise. | accessible en écriture |
consentSettings.consentType.key |
string |
Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. | accessible en écriture |
consentSettings.consentType.list[] |
list |
Paramètres de ce paramètre de liste (les clés seront ignorées). | accessible en écriture |
consentSettings.consentType.map[] |
list |
Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). | accessible en écriture |
consentSettings.consentType.value |
string |
Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. | accessible en écriture |
firingRuleId[] |
list |
ID des règles de déclenchement Une balise se déclenche lorsque l'une des règles listées est vraie et que tous ses blockingRuleIds (le cas échéant) sont faux. |
accessible en écriture |
firingTriggerId[] |
list |
ID des déclencheurs d'activation. Une balise se déclenche lorsque l'un des déclencheurs listés est vrai et que tous ses blockingTriggerIds (le cas échéant) sont définis sur "false". |
accessible en écriture |
liveOnly |
boolean |
Si elle est définie sur "True", cette balise ne se déclenchera que dans l'environnement réel (par exemple, pas en mode aperçu ni en mode débogage). | accessible en écriture |
monitoringMetadata |
nested object |
Mappage de paires clé/valeur des métadonnées de balises à inclure dans les données d'événement pour la surveillance des balises. Remarques:
|
accessible en écriture |
monitoringMetadata.key |
string |
Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. | accessible en écriture |
monitoringMetadata.list[] |
list |
Paramètres de ce paramètre de liste (les clés seront ignorées). | accessible en écriture |
monitoringMetadata.map[] |
list |
Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). | accessible en écriture |
monitoringMetadata.value |
string |
Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. | accessible en écriture |
monitoringMetadataTagNameKey |
string |
S'il n'est pas vide, le nom à afficher de la balise est inclus dans le mappage des métadonnées de surveillance avec la clé spécifiée. | accessible en écriture |
notes |
string |
Notes de l'utilisateur sur la manière d'appliquer cette balise dans le conteneur | accessible en écriture |
parameter[] |
list |
Paramètres de la balise. | accessible en écriture |
parameter[].key |
string |
Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. | accessible en écriture |
parameter[].list[] |
list |
Paramètres de ce paramètre de liste (les clés seront ignorées). | accessible en écriture |
parameter[].map[] |
list |
Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). | accessible en écriture |
parameter[].value |
string |
Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. | accessible en écriture |
paused |
boolean |
Indique si la balise est mise en veille, ce qui empêche son déclenchement. | accessible en écriture |
priority |
nested object |
Priorité numérique du tag définie par l'utilisateur. Les balises sont déclenchées de manière asynchrone, par ordre de priorité. Les balises ayant la valeur numérique la plus élevée sont déclenchées en premier. La priorité d'une balise peut être une valeur positive ou négative. La valeur par défaut est 0. | accessible en écriture |
priority.key |
string |
Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. | accessible en écriture |
priority.list[] |
list |
Paramètres de ce paramètre de liste (les clés seront ignorées). | accessible en écriture |
priority.map[] |
list |
Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). | accessible en écriture |
priority.value |
string |
Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. | accessible en écriture |
scheduleEndMs |
long |
Code temporel de fin, en millisecondes, de la programmation d'une balise. | accessible en écriture |
scheduleStartMs |
long |
Code temporel de début, en millisecondes, pour programmer une balise. | accessible en écriture |
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource "Tags" dans le corps de la réponse.
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.