Container Versions

Die Containerversionen eines Containers. Eine Containerversion ist eine unveränderliche Kopie (Snapshot) der Konfiguration eines Containers zu einem bestimmten Zeitpunkt. Wenn Sie mit der Methode create eine neue Version erstellen, wird eine Version erstellt, die auf der aktuellen Konfiguration basiert, d.h. auf den Makros, Regeln und Tags des Containers. Mit der Methode restore wird die Konfiguration des Containers mithilfe 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 GTM-Konto-ID.
container nested object Der Container, aus dem diese Version übernommen 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, wie er zum Zeitpunkt des Speichers berechnet wurde. Dieser Wert wird bei jeder Änderung der Containerversion neu berechnet.
folder[] list Die Ordner im Container, aus dem diese Version stammt.
macro[] list Die Makros im Container, aus dem diese Version stammt.
macro[].accountId string GTM-Konto-ID.
macro[].containerId string GTM-Container-ID.
macro[].disablingRuleId[] list Nur für mobile Container: 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 ungeordneter Satz behandelt.
macro[].enablingRuleId[] list Nur für mobile Container: eine Liste von Regel-IDs zum Aktivieren bedingter Makros Das Makro ist aktiviert, wenn eine der Aktivierungsregeln wahr ist, während alle Deaktivierungsregeln falsch sind. Wird als ungeordneter Satz behandelt.
macro[].fingerprint string Der Fingerabdruck des GTM-Makros, wie er zum Zeitpunkt der Speicherung berechnet wurde. 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 Nutzernotizen 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, der als Trigger-ID dargestellt wird.


Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • template
  • triggerReference
Bearbeitbar
macro[].parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen Typ. Bearbeitbar
macro[].parentFolderId string ID des übergeordneten Ordners.
macro[].scheduleEndMs long Der Endzeitstempel in Millisekunden, um ein Makro zu planen.
macro[].scheduleStartMs long Der Startzeitstempel in Millisekunden für die Planung eines Makros.
macro[].type string GTM-Makrotyp.
name string Anzeigename der Containerversion. Bearbeitbar
notes string Nutzerhinweise zur Anwendung dieser Containerversion im Container. Bearbeitbar
rule[] list Die Regeln im Container, aus dem diese Version übernommen wurde.
rule[].accountId string GTM-Konto-ID.
rule[].condition[] list Die Liste der Bedingungen, aus denen diese Regel besteht (implizites UND zwischen ihnen).
rule[].condition[].parameter[] list Eine Liste benannter Parameter (Schlüssel/Wert), je nach Typ der Bedingung. Hinweise:
  • Fügen Sie für binäre Operatoren die Parameter arg0 und arg1 ein, um den linken bzw. rechten Operanden anzugeben.
  • Derzeit muss der linke Operand (arg0) ein Verweis auf eine Variable sein.
  • Wenn bei einem regulären Ausdruck die Groß-/Kleinschreibung nicht berücksichtigt wird, fügen Sie den booleschen Parameter ignore_case hinzu, der auf true gesetzt ist. Wenn sie nicht angegeben oder auf einen anderen Wert festgelegt ist, wird beim Abgleich die Groß-/Kleinschreibung beachtet.
  • 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 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 Kartenparameters (müssen Schlüssel haben, 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 „true“ dargestellt wird oder „false“
  • integer: Der Wert stellt eine 64-Bit-Ganzzahl mit Vorzeichen zur Basis 10 dar.
  • list: Es sollte eine Liste von Parametern angegeben werden.
  • map: Es sollte eine Zuordnung von Parametern angegeben werden.
  • template: Der Wert steht für einen beliebigen Text. Dies kann Variablenverweise umfassen (auch Variablenverweise, die Nicht-String-Typen zurückgeben)
  • trigger_reference: Der Wert steht für einen Trigger, der als Trigger-ID dargestellt wird.


Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • boolean
  • integer
  • list
  • map
  • template
  • triggerReference
Bearbeitbar
rule[].condition[].parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten), je nach dem angegebenen Typ. Bearbeitbar
rule[].condition[].type string Der Typ des Operators für diese Bedingung.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • 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 Zeitpunkt der Speicherung berechnet wurde. Dieser Wert wird bei jeder Änderung der Regel neu berechnet.
rule[].name string Anzeigename der Regel.
rule[].notes string Nutzernotizen zur Anwendung dieser Regel im Container.
rule[].ruleId string Die Regel-ID kennzeichnet 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 übernommen wurde.
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.
veröffentlichen
Veröffentlicht eine Containerversion.
Wiederherstellen
Stellt eine Containerversion wieder her. Dadurch wird die aktuelle Konfiguration (einschließlich ihrer Variablen, Trigger und Tags) zu überprüfen. Der Vorgang hat keinerlei Auswirkungen auf die bereitgestellte Version (d.h. veröffentlichte Version).
Wiederherstellen
Stellt eine Containerversion wieder her.
Update
Aktualisiert eine Containerversion.