Requiere autorización
Crea una variable de GTM. Pruébalo ahora y ve un ejemplo.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/variables
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 variables con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
name |
string |
Nombre visible de la variable. | 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 |
type |
string |
Tipo de variable de GTM. | admite escritura |
Propiedades opcionales | |||
disablingTriggerId[] |
list |
Solo para contenedores para dispositivos móviles: Es una lista de IDs de activadores para inhabilitar variables condicionales. La variable se habilita si uno de los activadores de habilitación es verdadero, mientras que todos los activadores de inhabilitación son falsos. Se trata como un conjunto sin ordenar. | admite escritura |
enablingTriggerId[] |
list |
Solo para contenedores móviles: Es una lista de IDs de activadores para habilitar variables condicionales. La variable se habilita si uno de los activadores de habilitación es verdadero, mientras que todos los activadores de inhabilitación son falsos. Se trata como un conjunto sin ordenar. | admite escritura |
notes |
string |
Notas del usuario sobre cómo aplicar esta variable en el contenedor. | admite escritura |
parameter[] |
list |
Los parámetros de la variable. | 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 |
scheduleEndMs |
long |
Es la marca de tiempo de finalización en milisegundos para programar una variable. | admite escritura |
scheduleStartMs |
long |
Es la marca de tiempo de inicio en milisegundos para programar una variable. | admite escritura |
Respuesta
Si se ejecuta de forma correcta, este método muestra un Recurso de variables 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 variable for the authorized user. */ // Create the variable object. Variable variable = new Variable(); variable.setName("randomNumber"); variable.setType("r"); // The random number type. try { Variable response = tagmanager.accounts().containers(). variables().create("123456", "54321", variable).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 the response object. * The following code shows how to access the created Id and Fingerprint. */ System.out.println("Variable Id = " + response.getVariableId()); System.out.println("Variable 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 variable. try: response = tagmanager.accounts().containers().variables().create( accountId='23732470', containerId='801231', body={ 'name': 'random_number', 'type': 'r' } ).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 response object. # The following code shows how to access the created id and fingerprint. print 'Variable Id = %s' % response.get('variableId') print 'Variable Fingerprint = %s' % 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.