Container Versions

Le versioni contenitore di un container. 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 macro, regole e 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, utilizza il metodo get e specifica published per containerVersionId.

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Rappresenta una versione del 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 recuperata questa versione.
containerId string ID contenitore GTM.
containerVersionId string L'elemento 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 la versione del container viene modificata.
folder[] list Le cartelle del contenitore da cui è stata recuperata questa versione.
macro[] list Le macro presenti nel contenitore da cui è stata recuperata 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 abilitata se una delle regole di attivazione è true mentre tutte le regole di disattivazione sono false. Considerato come un insieme non ordinato.
macro[].enablingRuleId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID regola per l'attivazione delle macro condizionali; la macro viene abilitata se una delle regole di attivazione è true mentre tutte le regole di disattivazione sono false. Considerato 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 della 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 con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
macro[].parameter[].list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
macro[].parameter[].map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessibile in scrittura
macro[].parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
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. accessibile in scrittura
notes string Note dell'utente su come applicare questa versione del contenitore nel contenitore. accessibile in scrittura
rule[] list Le regole nel container da cui è stata recuperata questa versione.
rule[].accountId string ID account GTM.
rule[].condition[] list L'elenco delle condizioni che compongono questa regola (con operatore AND implicito).
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 delle espressioni regolari senza distinzione tra maiuscole e minuscole, includi un parametro booleano denominato ignore_case impostato su true. Se non viene specificato o viene impostato su qualsiasi altro valore, la corrispondenza sarà sensibile alle maiuscole.
  • Per negare un operatore, includi un parametro booleano denominato negate impostato su true.
accessibile in scrittura
rule[].condition[].parameter[].key string La chiave con nome che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello, così come per i valori della mappa. Ignorato per i valori dell'elenco. accessibile in scrittura
rule[].condition[].parameter[].list[] list Parametri di questo elenco (le chiavi verranno ignorate). accessibile in scrittura
rule[].condition[].parameter[].map[] list I parametri di questo parametro della mappa (devono avere chiavi; le chiavi devono essere univoche). accessibile in scrittura
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 a 64 bit con segno, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa di parametri
  • template: il valore rappresenta qualsiasi testo; questo può includere riferimenti a variabili (anche riferimenti a variabili che potrebbero restituire tipi non stringa)
  • trigger_reference: il valore rappresenta un attivatore, rappresentato come ID attivatore
di Gemini Advanced.

I valori accettati sono:
    .
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessibile in scrittura
rule[].condition[].parameter[].value string Il valore di un parametro (può contenere riferimenti a variabili come "") in modo appropriato al tipo specificato. accessibile in scrittura
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"
accessibile in scrittura
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 del contenitore da cui è stata recuperata questa versione.
trigger[] list Gli attivatori nel contenitore da cui è stata recuperata questa versione.
variable[] list Le variabili nel contenitore da cui è stata recuperata questa versione.

Metodi

creazione
Crea una versione del contenitore.
elimina
Elimina una versione del contenitore.
trova
Recupera la versione del contenitore.
list
Elenca tutte le versioni di un contenitore GTM.
pubblica
Pubblica una versione del contenitore.
ripristino
Ripristina una versione del contenitore. Questa operazione sovrascriverà configurazione (incluse variabili, attivatori e tag). L'operazione non avrà alcun effetto sulla versione pubblicata (ad es. pubblicata).
annullare eliminazione
Annulla l'eliminazione di una versione del contenitore.
aggiorna
Aggiorna una versione del contenitore.