Containers: update

Autorisation requise

Met à jour un conteneur. Essayez maintenant ou consultez un exemple.

Requête

Requête HTTP

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

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.
Paramètres de requête facultatifs
fingerprint	string	Lorsqu'elle est fournie, cette empreinte doit correspondre à l'empreinte du conteneur 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, indiquez une ressource Containers avec les propriétés suivantes:

Nom de propriété	Valeur	Description	Remarques
Propriétés obligatoires
usageContext[]	list	Liste des contextes d'utilisation pour le conteneur. Les valeurs valides incluent: web, android, ios.	accessible en écriture
Propriétés facultatives
domainName[]	list	Liste facultative de noms de domaine associés au conteneur.	accessible en écriture
enabledBuiltInVariable[]	list	Liste des variables intégrées activées. Les valeurs valides incluent: pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId.	accessible en écriture
name	string	Nom à afficher du conteneur	accessible en écriture
notes	string	Notes sur le conteneur.	accessible en écriture
timeZoneCountryId	string	ID du pays du conteneur.	accessible en écriture
timeZoneId	string	ID de fuseau horaire du conteneur	accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource Containers 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 container for the authorized user.
 */

// Construct the container object.
Container container = new Container();
container.setName("Example Container");
container.setNotes("Example Container Notes.");
container.setTimeZoneCountryId("US");
container.setTimeZoneId("America/Los_Angeles");
container.setUsageContext(Arrays.asList("web", "android", "ios"));

try {
  Container response = tagmanager.accounts().
      containers().update("123456", "54321", container).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 container.
try:
  response = tagmanager.accounts().containers().update(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Example Container',
          'timeZoneCountryId': 'US',
          'timeZoneId': 'America/Los_Angeles',
          'usageContext': ['web', 'android']
      }
  ).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.