Crea una etiqueta de GTM. Pruébalo ahora.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/tags
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
parent |
string |
Ruta relativa de la API de GTM de Workspace. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}. |
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
Permiso |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Para obtener más información, consulta la página de autenticación y autorización.
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 | |||
consentSettings.consentType.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
monitoringMetadata.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
admite escritura |
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:
Los valores aceptables son los siguientes:
|
admite escritura |
priority.type |
string |
Es el tipo de parámetro. Los valores válidos son los siguientes:
Los valores aceptables son los siguientes:
|
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 |
consentSettings |
nested object |
La configuración de consentimiento de una etiqueta. | admite escritura |
consentSettings.consentType.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 |
consentSettings.consentType.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
consentSettings.consentType.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
consentSettings.consentType.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | 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 |
monitoringMetadata |
nested object |
Un mapa de pares clave-valor de metadatos de etiqueta que se incluirán en los datos de eventos para la supervisión de etiquetas. Notas:
|
admite escritura |
monitoringMetadata.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 |
monitoringMetadata.list[] |
list |
Los parámetros de este parámetro de lista (se ignorarán las claves). | admite escritura |
monitoringMetadata.map[] |
list |
Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). | admite escritura |
monitoringMetadata.value |
string |
El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. | admite escritura |
monitoringMetadataTagNameKey |
string |
Si este campo no está vacío, el nombre visible de la etiqueta se incluirá en el mapa de metadatos de supervisión con la clave especificada. | 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 |
Indica si la etiqueta está detenida, lo que impide que se active. | 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.
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.