Variables: update

Aggiorna una variabile GTM. Prova subito.

Richiesta

Richiesta HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
path string Percorso relativo dell'API della variabile GTM. Esempio: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}
Parametri di query facoltativi
fingerprint string Se fornita, questa impronta deve corrispondere alla fingerprint della variabile nello spazio di archiviazione.

Autorizzazione

Questa richiesta richiede un'autorizzazione con il seguente ambito:

Ambito
https://www.googleapis.com/auth/tagmanager.edit.containers

Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsa Variabili con le seguenti proprietà:

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
formatValue.convertFalseToValue.type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
formatValue.convertNullToValue.type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
formatValue.convertTrueToValue.type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
formatValue.convertUndefinedToValue.type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
name string Nome visualizzato della variabile. scrivibile
parameter[].type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo, inclusi riferimenti variabili (anche quelli a variabili che potrebbero restituire tipi diversi da una stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
  • tag_reference: il valore rappresenta un tag, rappresentato come il nome del tag


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
scrivibile
type string Tipo di variabile GTM. scrivibile
Proprietà facoltative
disablingTriggerId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID attivatore per la disattivazione delle variabili condizionali. La variabile viene attivata se uno degli attivatori di attivazione è true, mentre tutti gli attivatori di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
enablingTriggerId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID attivatori per l'attivazione delle variabili condizionali. La variabile viene attivata se uno degli attivatori di attivazione è true, mentre tutti gli attivatori di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
formatValue.convertFalseToValue.key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
formatValue.convertFalseToValue.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
formatValue.convertFalseToValue.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
formatValue.convertFalseToValue.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
formatValue.convertNullToValue.key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
formatValue.convertNullToValue.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
formatValue.convertNullToValue.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
formatValue.convertNullToValue.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
formatValue.convertTrueToValue.key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
formatValue.convertTrueToValue.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
formatValue.convertTrueToValue.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
formatValue.convertTrueToValue.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
formatValue.convertUndefinedToValue.key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
formatValue.convertUndefinedToValue.list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
formatValue.convertUndefinedToValue.map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
formatValue.convertUndefinedToValue.value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
notes string Note dell'utente su come applicare questa variabile nel contenitore. scrivibile
parameter[] list I parametri della variabile. scrivibile
parameter[].key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato. scrivibile
scheduleEndMs long Il timestamp finale in millisecondi per pianificare una variabile. scrivibile
scheduleStartMs long Il timestamp di inizio in millisecondi per pianificare una variabile. scrivibile

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Variabili nel corpo della risposta.

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.