Container Versions

Die Containerversionen eines Containers. Eine Containerversion kann als unveränderliche Kopie (Snapshot) der Konfiguration eines Containers zu einem bestimmten Zeitpunkt betrachtet werden. Wenn Sie mit der Methode create eine neue Version erstellen, wird eine Version basierend auf der aktuellen Konfiguration (d.h. den Makros, Regeln und Tags des Containers) erstellt. Mit der Methode restore wird die Konfiguration des Containers mit der angegebenen Version wiederhergestellt. Mit der Methode update können die Felder name und notes einer Version aktualisiert werden. Verwenden Sie zum Abrufen der aktuell veröffentlichten Version die Methode get und geben Sie published für containerVersionId an.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Stellt eine Google Tag Manager-Containerversion dar.

{
  "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
}
Property-Name Wert Beschreibung Hinweise
accountId string Google Tag Manager-Konto-ID.
container nested object Der Container, aus dem diese Version entnommen wurde.
containerId string GTM-Container-ID
containerVersionId string Mit containerVersionId wird die GTM-Containerversion eindeutig identifiziert.
deleted boolean Der Wert „true“ gibt an, dass diese Containerversion gelöscht wurde.
fingerprint string Der Fingerabdruck der GTM-Containerversion, der zum Speicherzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung der Containerversion neu berechnet.
folder[] list Die Ordner im Container, aus denen diese Version stammt.
macro[] list Die Makros im Container, aus dem diese Version stammt.
macro[].accountId string Google Tag Manager-Konto-ID.
macro[].containerId string GTM-Container-ID
macro[].disablingRuleId[] list Nur für mobile Container: Eine Liste mit Regel-IDs zum Deaktivieren bedingter Makros. Das Makro ist aktiviert, wenn eine der Aktivierungsregeln wahr ist, während alle Deaktivierungsregeln falsch sind. Wird als ungeordnetes Set behandelt.
macro[].enablingRuleId[] list Nur für mobile Container: Eine Liste mit Regel-IDs zum Aktivieren bedingter Makros. Das Makro ist aktiviert, wenn eine der Aktivierungsregeln wahr und alle Deaktivierungsregeln falsch sind. Wird als ungeordnetes Set behandelt.
macro[].fingerprint string Der Fingerabdruck des GTM-Makros, wie er zum Speicherzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung des Makros neu berechnet.
macro[].macroId string Die Makro-ID kennzeichnet das GTM-Makro eindeutig.
macro[].name string Anzeigename des Makros.
macro[].notes string Nutzerhinweise zur Anwendung dieses Makros im Container.
macro[].parameter[] list Die Parameter des Makros.
macro[].parameter[].key string Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert. Bearbeitbar
macro[].parameter[].list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
macro[].parameter[].map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
macro[].parameter[].type string Der Parametertyp. Gültige Werte sind:
  • boolean: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird.
  • integer: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar.
  • list: Es muss eine Liste mit Parametern angegeben werden
  • map: Es muss eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind).
  • trigger_reference: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
Bearbeitbar
macro[].parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
macro[].parentFolderId string ID des übergeordneten Ordners.
macro[].scheduleEndMs long Der Endzeitstempel in Millisekunden zum Planen eines Makros.
macro[].scheduleStartMs long Der Startzeitstempel in Millisekunden zum Planen eines Makros.
macro[].type string GTM-Makrotyp.
name string Anzeigename der Containerversion. Bearbeitbar
notes string Nutzerhinweise zur Anwendung dieser Containerversion auf den Container. Bearbeitbar
rule[] list Die Regeln im Container, aus dem diese Version stammt.
rule[].accountId string Google Tag Manager-Konto-ID.
rule[].condition[] list Die Liste der Bedingungen, aus denen diese Regel besteht (implizites UND dazwischen).
rule[].condition[].parameter[] list Eine Liste benannter Parameter (Schlüssel/Wert), je nach Art der Bedingung. Hinweise:
  • Geben Sie für binäre Operatoren die Parameter arg0 und arg1 an, um den linken bzw. rechten Operanden anzugeben.
  • Derzeit muss der linke Operand (arg0) ein Verweis auf eine Variable sein.
  • Für den Abgleich von regulären Ausdrücken ohne Berücksichtigung der Groß- und Kleinschreibung fügen Sie einen booleschen Parameter namens ignore_case hinzu, der auf true gesetzt ist. Wenn kein Wert angegeben oder auf einen anderen Wert festgelegt ist, wird beim Abgleich zwischen Groß- und Kleinschreibung unterschieden.
  • Um einen Operator zu negieren, fügen Sie einen booleschen Parameter namens negate hinzu, der auf true gesetzt ist.
Bearbeitbar
rule[].condition[].parameter[].key string Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert. Bearbeitbar
rule[].condition[].parameter[].list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
rule[].condition[].parameter[].map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
rule[].condition[].parameter[].type string Der Parametertyp. Gültige Werte sind:
  • boolean: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird.
  • integer: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar.
  • list: Es muss eine Liste mit Parametern angegeben werden
  • map: Es muss eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind).
  • trigger_reference: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
Bearbeitbar
rule[].condition[].parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
rule[].condition[].type string Der Operatortyp für diese Bedingung.

Zulässige Werte sind:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
Bearbeitbar
rule[].containerId string GTM-Container-ID
rule[].fingerprint string Der Fingerabdruck der GTM-Regel, der zum Speicherzeitpunkt berechnet wird. Dieser Wert wird bei jeder Änderung der Regel neu berechnet.
rule[].name string Anzeigename der Regel.
rule[].notes string Nutzerhinweise zur Anwendung dieser Regel auf den Container.
rule[].ruleId string Die Regel-ID identifiziert die GTM-Regel eindeutig.
tag[] list Die Tags im Container, aus dem diese Version stammt.
trigger[] list Die Trigger im Container, aus dem diese Version stammt.
variable[] list Die Variablen im Container, aus dem diese Version stammt.

Methoden

Erstellen
Erstellt eine Containerversion.
delete
Löscht eine Containerversion.
get
Ruft eine Containerversion ab.
list
Listet alle Containerversionen eines GTM-Containers auf.
publish
Veröffentlicht eine Containerversion.
Wiederherstellen
Stellt eine Containerversion wieder her. Dadurch wird die aktuelle Konfiguration des Containers (einschließlich seiner Variablen, Trigger und Tags) überschrieben. Der Vorgang hat keine Auswirkungen auf die bereitgestellte Version (d.h. die veröffentlichte Version).
undelete
Stellt eine Containerversion wieder her.
Aktualisieren
Aktualisiert eine Containerversion.