Container Versions

Le versioni del contenitore. Una versione del container può essere considerata come una copia immutabile (snapshot) della configurazione di un container in un determinato momento. Se crei una nuova versione con il metodo create, verrà creata una versione basata sulla configurazione corrente (ovvero le macro, le regole e i tag del contenitore). Il metodo restore ripristinerà la configurazione del contenitore utilizzando la versione specificata. Il metodo update consente di aggiornare i campi name e notes di una versione. Per recuperare la versione attualmente pubblicata, usa il metodo get e specifica published per containerVersionId.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

Rappresenta la versione di un contenitore di Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}

Nome proprietà	Valore	Descrizione	Note
accountId	string	ID account GTM.
container	nested object	Il contenitore da cui è stata acquisita questa versione.
containerId	string	ID contenitore GTM.
containerVersionId	string	containerVersionId identifica in modo univoco la versione del contenitore GTM.
deleted	boolean	Il valore true indica che questa versione del contenitore è stata eliminata.
fingerprint	string	L'impronta della versione del contenitore GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che viene modificata la versione del contenitore.
folder[]	list	Le cartelle del contenitore da cui è stata acquisita questa versione.
macro[]	list	Le macro del contenitore da cui è stata acquisita questa versione.
macro[].accountId	string	ID account GTM.
macro[].containerId	string	ID contenitore GTM.
macro[].disablingRuleId[]	list	Solo per i contenitori per dispositivi mobili: un elenco di ID regola per la disattivazione delle macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato.
macro[].enablingRuleId[]	list	Solo per i contenitori per dispositivi mobili: un elenco di ID regola per l'attivazione di macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato.
macro[].fingerprint	string	L'impronta della macro GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che la macro viene modificata.
macro[].macroId	string	L'ID macro identifica in modo univoco la macro GTM.
macro[].name	string	Nome visualizzato della macro.
macro[].notes	string	Note dell'utente su come applicare questa macro nel contenitore.
macro[].parameter[]	list	I parametri della macro.
macro[].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
macro[].parameter[].list[]	list	Parametri di questo parametro elenco (le chiavi verranno ignorate).	scrivibile
macro[].parameter[].map[]	list	I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche).	scrivibile
macro[].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 I valori accettati sono: "boolean" "integer" "list" "map" "template" "triggerReference"	scrivibile
macro[].parameter[].value	string	Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato.	scrivibile
macro[].parentFolderId	string	ID cartella principale.
macro[].scheduleEndMs	long	Il timestamp di fine in millisecondi per pianificare una macro.
macro[].scheduleStartMs	long	Il timestamp di inizio in millisecondi per pianificare una macro.
macro[].type	string	Tipo di macro GTM.
name	string	Nome visualizzato della versione del contenitore.	scrivibile
notes	string	Note dell'utente su come applicare questa versione del contenitore nel contenitore.	scrivibile
rule[]	list	Le regole nel contenitore da cui è stata acquisita questa versione.
rule[].accountId	string	ID account GTM.
rule[].condition[]	list	L'elenco di condizioni che costituiscono questa regola (implicita AND tra le condizioni).
rule[].condition[].parameter[]	list	Un elenco di parametri denominati (chiave/valore), a seconda del tipo di condizione. Note: Per gli operatori binari, includi i parametri denominati arg0 e arg1 per specificare rispettivamente gli operandi sinistro e destro. Al momento, l'operando sinistro (arg0) deve essere un riferimento a una variabile. Per la corrispondenza con espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o impostato su un altro valore, la corrispondenza sarà sensibile alle maiuscole. Per escludere un operatore, includi un parametro booleano denominato negate parametro booleano impostato su true.	scrivibile
rule[].condition[].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
rule[].condition[].parameter[].list[]	list	Parametri di questo parametro elenco (le chiavi verranno ignorate).	scrivibile
rule[].condition[].parameter[].map[]	list	I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche).	scrivibile
rule[].condition[].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 I valori accettati sono: "boolean" "integer" "list" "map" "template" "triggerReference"	scrivibile
rule[].condition[].parameter[].value	string	Il valore di un parametro (può contenere riferimenti a variabili come "") a seconda del tipo specificato.	scrivibile
rule[].condition[].type	string	Il tipo di operatore per questa condizione. I valori accettati sono: "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	scrivibile
rule[].containerId	string	ID contenitore GTM.
rule[].fingerprint	string	L'impronta della regola GTM calcolata al momento dell'archiviazione. Questo valore viene ricalcolato ogni volta che la regola viene modificata.
rule[].name	string	Nome visualizzato della regola.
rule[].notes	string	Note dell'utente su come applicare questa regola nel contenitore.
rule[].ruleId	string	L'ID regola identifica in modo univoco la regola GTM.
tag[]	list	I tag nel contenitore da cui è stata acquisita questa versione.
trigger[]	list	Gli attivatori nel contenitore da cui è stata acquisita questa versione.
variable[]	list	Le variabili del contenitore da cui è stata recuperata questa versione.

Metodi

creazione

Crea una versione del contenitore.

elimina

Elimina una versione del contenitore.

ricevi

Recupera una versione del contenitore.

list

Elenca tutte le versioni di un contenitore GTM.

publish

Pubblica una versione del contenitore.

ripristinare

Ripristina una versione del contenitore. La configurazione attuale del contenitore (inclusi variabili, attivatori e tag) verrà sovrascritta. L'operazione non avrà alcun effetto sulla versione pubblicata (ovvero la versione pubblicata).

undelete

Annulla l'eliminazione di una versione del contenitore.

aggiornamento

Aggiorna la versione di un contenitore.