Variables: create

Erstellt eine Google Tag Manager-Variable. Jetzt testen

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/tagmanager/v2/+parent/variables

Parameter

Parametername Wert Beschreibung
Pfadparameter
parent string Der relative API-Pfad von GTM Workspace. Beispiel: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie im Anfragetext eine Variables-Ressource mit den folgenden Attributen an:

Property-Name Wert Beschreibung Hinweise
Erforderliche Eigenschaften
formatValue.convertFalseToValue.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.
  • tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Bearbeitbar
formatValue.convertNullToValue.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.
  • tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Bearbeitbar
formatValue.convertTrueToValue.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.
  • tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Bearbeitbar
formatValue.convertUndefinedToValue.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.
  • tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Bearbeitbar
name string Anzeigename der Variable. Bearbeitbar
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.
  • tag_reference: Der Wert steht für ein Tag, das als Tag-Name dargestellt wird.


Zulässige Werte sind:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Bearbeitbar
type string GTM-Variablentyp. Bearbeitbar
Optionale Attribute
disablingTriggerId[] list Nur für mobile Container: Eine Liste mit Trigger-IDs zum Deaktivieren bedingter Variablen. Die Variable ist aktiviert, wenn einer der aktivierenden Trigger wahr ist, während alle deaktivierenden Trigger falsch sind. Wird als ungeordnetes Set behandelt. Bearbeitbar
enablingTriggerId[] list Nur für mobile Container: Eine Liste mit Trigger-IDs zum Aktivieren bedingter Variablen. Die Variable ist aktiviert, wenn einer der aktivierenden Trigger wahr ist, während alle deaktivierenden Trigger falsch sind. Wird als ungeordnetes Set behandelt. Bearbeitbar
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
formatValue.convertFalseToValue.map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
formatValue.convertFalseToValue.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
formatValue.convertNullToValue.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
formatValue.convertNullToValue.list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
formatValue.convertNullToValue.map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
formatValue.convertNullToValue.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
formatValue.convertTrueToValue.map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
formatValue.convertTrueToValue.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
formatValue.convertUndefinedToValue.map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
formatValue.convertUndefinedToValue.value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
notes string Nutzerhinweise zur Anwendung dieser Variable im Container. Bearbeitbar
parameter[] list Die Parameter der Variablen. Bearbeitbar
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
parameter[].list[] list Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). Bearbeitbar
parameter[].map[] list Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). Bearbeitbar
parameter[].value string Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. Bearbeitbar
scheduleEndMs long Der Endzeitstempel in Millisekunden zum Planen einer Variablen. Bearbeitbar
scheduleStartMs long Der Startzeitstempel in Millisekunden zum Planen einer Variable. Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Variables-Ressource im Antworttext zurückgegeben.

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.