Se usó la API de Cloud Translation para traducir esta página.

Tags: create

Crea una etiqueta de GTM. Pruébalo ahora y ve un ejemplo.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro	Valor	Descripción
Parámetros de ruta de acceso
`accountId`	`string`	El ID de la cuenta de GTM.
`containerId`	`string`	El ID del contenedor de GTM.

Autorización

Esta solicitud requiere autorización con el siguiente alcance (obtén más información sobre la autenticación y la autorización).

Permiso
`https://www.googleapis.com/auth/tagmanager.edit.containers`

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso de etiquetas con las siguientes propiedades:

Nombre de la propiedad	Valor	Descripción	Notas
Propiedades obligatorias
`name`	`string`	Nombre visible de la etiqueta.	admite escritura
`parameter[].type`	`string`	Es el tipo de parámetro. Los valores válidos son los siguientes: `boolean`: El valor representa un valor booleano, representado como "verdadero" o "falso". `integer`: El valor representa un número entero de 64 bits con firma, en base 10. `list`: Se debe especificar una lista de parámetros. `map`: Se debe especificar un mapa de parámetros. `template`: El valor representa cualquier texto. Puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean de strings). `trigger_reference`: El valor representa un activador, representado como el ID del activador. Los valores aceptables son los siguientes: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	admite escritura
`priority.type`	`string`	Es el tipo de parámetro. Los valores válidos son los siguientes: `boolean`: El valor representa un valor booleano, representado como "verdadero" o "falso". `integer`: El valor representa un número entero de 64 bits con firma, en base 10. `list`: Se debe especificar una lista de parámetros. `map`: Se debe especificar un mapa de parámetros. `template`: El valor representa cualquier texto. Puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean de strings). `trigger_reference`: El valor representa un activador, representado como el ID del activador. Los valores aceptables son los siguientes: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	admite escritura
`type`	`string`	Tipo de etiqueta de GTM.	admite escritura
Propiedades opcionales
`blockingRuleId[]`	`list`	IDs de reglas de bloqueo. Si alguna de las reglas de la lista se evalúa como verdadera, la etiqueta no se activará.	admite escritura
`blockingTriggerId[]`	`list`	Bloquea los IDs de activador. Si alguno de los activadores de la lista se evalúa como verdadero, la etiqueta no se activará.	admite escritura
`firingRuleId[]`	`list`	Los IDs de las reglas de activación. Se activará una etiqueta cuando alguna de las reglas enumeradas sea verdadera y todos sus `blockingRuleIds` (si los hay) sean falsos.	admite escritura
`firingTriggerId[]`	`list`	Se activan los IDs de los activadores. Una etiqueta se activará cuando alguno de los activadores enumerados sea verdadero y todos sus `blockingTriggerIds` (si los hay) sean falsos.	admite escritura
`liveOnly`	`boolean`	Si se establece como verdadera, esta etiqueta solo se activará en el entorno en vivo (p.ej., no en modo de vista previa ni de depuración).	admite escritura
`notes`	`string`	Notas del usuario sobre cómo aplicar esta etiqueta en el contenedor.	admite escritura
`parameter[]`	`list`	Los parámetros de la etiqueta.	admite escritura
`parameter[].key`	`string`	La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista.	admite escritura
`parameter[].list[]`	`list`	Los parámetros de este parámetro de lista (se ignorarán las claves).	admite escritura
`parameter[].map[]`	`list`	Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas).	admite escritura
`parameter[].value`	`string`	El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado.	admite escritura
`paused`	`boolean`	Es verdadero si la etiqueta está detenida.	admite escritura
`priority`	`nested object`	Prioridad numérica de la etiqueta definida por el usuario. Las etiquetas se activan de forma asíncrona en orden de prioridad. Las etiquetas con valor numérico más alto se activan primero. La prioridad de una etiqueta puede ser un valor positivo o negativo. El valor predeterminado es 0.	admite escritura
`priority.key`	`string`	La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista.	admite escritura
`priority.list[]`	`list`	Los parámetros de este parámetro de lista (se ignorarán las claves).	admite escritura
`priority.map[]`	`list`	Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas).	admite escritura
`priority.value`	`string`	El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado.	admite escritura
`scheduleEndMs`	`long`	Es la marca de tiempo de finalización en milisegundos para programar una etiqueta.	admite escritura
`scheduleStartMs`	`long`	Es la marca de tiempo de inicio en milisegundos para programar una etiqueta.	admite escritura

Respuesta

Si se aplica correctamente, este método muestra un recurso de etiquetas 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 cliente para consultar una lista de lenguajes admitidos).

Java

Usa la biblioteca cliente de Java.

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

/*
 * This request creates a new tag.
 */

// 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");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().containers().
      tags().create("123456", "54321", tag).execute();

} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}


/*
 * The results of the create method are stored in response object.
 * The following code shows how to access the created id and fingerprint.
 */
System.out.println("Tag id = " + response.getTagId());
System.out.println("Tag Fingerprint = " + response.getFingerprint());

Python

Usa la biblioteca cliente de Python.

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

# This request creates a new container tag.
try:
  response = tagmanager.accounts().containers().tags().create(
      accountId='123456',
      containerId='54321',
      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 create method are stored in the response object.
# The following code shows how to access the created id and fingerprint.
print response.get('tagId')
print response.get('fingerprint')

Pruébala

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.