Tags: create

Crée une balise GTM. Essayer maintenant

Requête

Requête HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
parent string Chemin d'accès relatif de l'API de l'espace de travail GTM. Exemple : accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

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:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
monitoringMetadata.type string Type de paramètre. Voici les valeurs possibles:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
name string Nom à afficher du tag. accessible en écriture
parameter[].type string Type de paramètre. Voici les valeurs possibles:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
priority.type string Type de paramètre. Voici les valeurs possibles:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits en base 10
  • list: une liste de paramètres doit être spécifiée.
  • map: un mappage des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références de variables (même des références de variables pouvant renvoyer des types autres que des chaînes)
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 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:
  • Ce paramètre doit être de type MAP.
  • Chaque paramètre du mappage est de type TEMPLATE, mais ne peut pas contenir de références de variables.
 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.