Requiere autorización
Actualiza un recurso Tag de GTM. Pruébalo ahora o consulta un ejemplo.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId
Parámetros
Nombre de parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta | ||
accountId |
string |
ID de recurso Account de GTM. |
containerId |
string |
ID de recurso Container de GTM. |
tagId |
string |
ID de recurso Tag de GTM. |
Parámetros de consulta opcionales | ||
fingerprint |
string |
Cuando se proporciona, esta huella digital debe coincidir con la del recurso Tag almacenado. |
Autorización
Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.
Ámbito |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso Tag con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
name |
string |
Nombre visible del recurso Tag. | editable |
parameter[].type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
priority.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
Propiedades opcionales | |||
blockingRuleId[] |
list |
IDs de regla de bloqueo. Si alguna de las reglas de la lista tiene el valor "true", la etiqueta no se activará. | editable |
blockingTriggerId[] |
list |
IDs de activador de bloqueo. Si alguno de los activadores de la lista tiene el valor "true", la etiqueta no se activará. | editable |
firingRuleId[] |
list |
IDs de regla de activación. Se activará una etiqueta cuando cualquiera de las reglas de la lista tenga el valor "true" y todos los ID de regla de bloqueo (blockingRuleIds ) correspondientes, si se ha especificado alguno, tengan el valor "false". |
editable |
firingTriggerId[] |
list |
IDs de activación de accionamiento. Se activará una etiqueta cuando cualquiera de los activadores de la lista tenga el valor "true" y todos los ID de activación de bloqueo (blockingTriggerIds ) correspondientes, si se ha especificado alguno, tengan el valor "false". |
editable |
liveOnly |
boolean |
Si se configura en "true", esta etiqueta solo se activará en el entorno real (por ejemplo, no en el modo de vista previa o de depuración). | editable |
notes |
string |
Notas de usuario sobre cómo aplicar este recurso Tag en el recurso Container. | editable |
parameter[] |
list |
Parámetros de la etiqueta. | editable |
parameter[].key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
parameter[].list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
parameter[].map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
parameter[].value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
paused |
boolean |
El valor es "true" si la etiqueta está en pausa. | editable |
priority |
nested object |
Prioridad numérica de la etiqueta, definida por el usuario. Las etiquetas se activan de forma asíncrona por orden de prioridad. Las que tienen un valor numérico más alto se activan primero. La prioridad de una etiqueta puede expresarse con un valor positivo o negativo. El valor predeterminado es 0. | editable |
priority.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
priority.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
priority.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
priority.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
scheduleEndMs |
long |
Marca de tiempo final en milisegundos para programar una etiqueta. | editable |
scheduleStartMs |
long |
Marca de tiempo inicial en milisegundos para programar una etiqueta. | editable |
type |
string |
Tipo de etiqueta de GTM. | editable |
Respuesta
Si se realiza correctamente, este método devuelve un recurso Tag en el cuerpo de la respuesta.
Ejemplos
Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).
Java
Utiliza la biblioteca de 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
Utiliza la biblioteca de 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')
Pruébalo
Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.