Cette page a été traduite par l'API Cloud Translation.

Tags: update

Met à jour une balise GTM. Essayez maintenant ou consultez un exemple.

Requête

Requête HTTP

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId

Paramètres

Nom du paramètre	Valeur	Description
Paramètres de chemin d'accès
`accountId`	`string`	ID du compte GTM.
`containerId`	`string`	ID du conteneur GTM.
`tagId`	`string`	ID de la balise GTM.
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

Une autorisation est requise pour cette requête. Celle-ci doit inclure le champ d'application suivant (en savoir plus sur le processus d'authentification et d'autorisation).

Définition du champ d'application
`https://www.googleapis.com/auth/tagmanager.edit.containers`

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
`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. Valeurs acceptées : "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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. Valeurs acceptées : "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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
`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
`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`	"True" si la balise est mise en veille.	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
`type`	`string`	Type de balise GTM.	accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource "Tags" dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque cliente Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing tag for the authorized user.
 */

// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("trackingId");
arg0.setValue("UA-123456-1");

Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("type");
arg1.setValue("TRACK_TRANSACTION");

// Construct the tag object.
Tag tag = new Tag();
tag.setName("Sample Universal Analytics");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().
      containers().tags().update("123456", "54321", "1", tag).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Utilise la bibliothèque cliente Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing new container tag.
try:
  response = tagmanager.accounts().containers().tags().update(
      accountId='123456',
      containerId='54321',
      tagId='1',
      body={
          'name': 'Universal Analytics Tag',
          'type': 'ua',
          'liveOnly': False,
          'parameter': [
              {
                  'type': 'template',
                  'key': 'trackingId',
                  'value': 'UA-123456-1'
              },
              {
                  'type': 'template',
                  'key': 'type',
                  'value': 'TRACK_TRANSACTION'
              }
          ]
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.