Container Versions

Wersje kontenera. Wersja kontenera to niezmienna kopia (zrzut) konfiguracji kontenera w danym momencie. Utworzenie nowej wersji za pomocą metody create spowoduje utworzenie wersji na podstawie bieżącej konfiguracji (czyli makr, reguł i tagów kontenera). Metoda restore przywróci konfigurację kontenera przy użyciu podanej wersji. Metoda update umożliwia aktualizowanie pól name i notes wersji. Aby pobrać obecnie opublikowaną wersję, użyj metody get i w polu containerVersionId podaj published.

Listę metod dostępnych w przypadku tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Reprezentuje wersję kontenera Menedżera tagów Google.

{
  "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
}
nazwa usługi, Wartość Opis Uwagi
accountId string Identyfikator konta Menedżera tagów Google.
container nested object Kontener, z którego pobrano tę wersję.
containerId string Identyfikator kontenera Menedżera tagów Google.
containerVersionId string containerVersionId jednoznacznie identyfikuje wersję kontenera Menedżera tagów Google.
deleted boolean Wartość prawda oznacza, że ta wersja kontenera została usunięta.
fingerprint string Odcisk cyfrowy wersji kontenera Menedżera tagów Google obliczony w czasie przechowywania. Ta wartość jest obliczana ponownie po każdej zmianie wersji kontenera.
folder[] list Foldery w kontenerze, z których pobrano tę wersję.
macro[] list Makra w kontenerze, z których pobrano tę wersję.
macro[].accountId string Identyfikator konta Menedżera tagów Google.
macro[].containerId string Identyfikator kontenera Menedżera tagów Google.
macro[].disablingRuleId[] list Tylko kontenery mobilne: lista identyfikatorów reguł służących do wyłączania makr warunkowych. Makro jest włączone, jeśli jedna z reguł włączających jest prawda, a wszystkie reguły wyłączone mają wartość fałsz. Zbiór traktowany jako nieuporządkowany.
macro[].enablingRuleId[] list Tylko kontenery mobilne: lista identyfikatorów reguł do włączania makr warunkowych. Makro jest włączone, jeśli jedna z reguł włączających jest prawda, a wszystkie reguły wyłączające – fałsz. Zbiór traktowany jako nieuporządkowany.
macro[].fingerprint string Odcisk cyfrowy makra Menedżera tagów Google obliczony w czasie przechowywania danych. Ta wartość jest obliczana ponownie po zmodyfikowaniu makra.
macro[].macroId string Identyfikator makra jednoznacznie identyfikuje makro Menedżera tagów Google.
macro[].name string Wyświetlana nazwa makra.
macro[].notes string Uwagi użytkownika na temat zastosowania tego makra w kontenerze.
macro[].parameter[] list Parametry makra.
macro[].parameter[].key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list. z możliwością zapisu
macro[].parameter[].list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
macro[].parameter[].map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
macro[].parameter[].type string Typ parametru. Prawidłowe wartości to:
  • boolean: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz).
  • integer: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość reprezentuje dowolny tekst; może to być odwołania do zmiennych (nawet odwołania do zmiennych, które mogą zwracać typy inne niż ciągi znaków).
  • trigger_reference: wartość reprezentuje regułę, reprezentującą ją identyfikator reguły.


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
z możliwością zapisu
macro[].parameter[].value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
macro[].parentFolderId string Identyfikator folderu nadrzędnego.
macro[].scheduleEndMs long Sygnatura czasowa zakończenia (w milisekundach), która umożliwia zaplanowanie makra.
macro[].scheduleStartMs long Sygnatura czasowa rozpoczęcia (w milisekundach) planowania makra.
macro[].type string Typ makra Menedżera tagów Google.
name string Wyświetlana nazwa wersji kontenera. z możliwością zapisu
notes string Uwagi użytkownika na temat tego, jak zastosować tę wersję kontenera w kontenerze. z możliwością zapisu
rule[] list Reguły w kontenerze, z których pobrano tę wersję.
rule[].accountId string Identyfikator konta Menedżera tagów Google.
rule[].condition[] list Lista warunków, które składają się na tę regułę (między nimi ORAZ).
rule[].condition[].parameter[] list Lista nazwanych parametrów (klucz/wartość) w zależności od typu warunku. Uwagi:
  • W przypadku operatorów binarnych uwzględnij parametry o nazwach arg0 i arg1, aby określić odpowiednio lewy i prawy operand.
  • Obecnie lewy operand (arg0) musi być odniesieniem do zmiennej.
  • Aby nie rozróżniać wielkości liter w wyrażeniach regularnych, dodaj parametr logiczny o nazwie ignore_case ustawiony na true. Jeśli nie określisz żadnej wartości ani nie wybierzesz żadnej innej wartości, podczas dopasowywania rozróżniana będzie wielkość liter.
  • Aby wykluczyć operator, dodaj parametr logiczny o nazwie negate parametr logiczny „true”.
z możliwością zapisu
rule[].condition[].parameter[].key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list. z możliwością zapisu
rule[].condition[].parameter[].list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
rule[].condition[].parameter[].map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
rule[].condition[].parameter[].type string Typ parametru. Prawidłowe wartości to:
  • boolean: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz).
  • integer: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość reprezentuje dowolny tekst; może to być odwołania do zmiennych (nawet odwołania do zmiennych, które mogą zwracać typy inne niż ciągi znaków).
  • trigger_reference: wartość reprezentuje regułę, reprezentującą ją identyfikator reguły.


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
z możliwością zapisu
rule[].condition[].parameter[].value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
rule[].condition[].type string Typ operatora tego warunku.

Akceptowane wartości:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
z możliwością zapisu
rule[].containerId string Identyfikator kontenera Menedżera tagów Google.
rule[].fingerprint string Odcisk cyfrowy reguły Menedżera tagów Google obliczony w czasie przechowywania. Ta wartość jest obliczana ponownie po każdej zmianie reguły.
rule[].name string Wyświetlana nazwa reguły.
rule[].notes string Uwagi użytkownika na temat stosowania tej reguły w kontenerze.
rule[].ruleId string Identyfikator reguły jednoznacznie identyfikuje regułę Menedżera tagów Google.
tag[] list Tagi w kontenerze, z którego pochodzi ta wersja.
trigger[] list Reguły w kontenerze, z których pobrano tę wersję.
variable[] list Zmienne w kontenerze, z których pobrano tę wersję.

Metody

create (utwórz)
Tworzy wersję kontenera.
usuń
Usuwa wersję kontenera.
pobierz
Pobiera wersję kontenera.
list
Zawiera listę wszystkich wersji kontenera Menedżera tagów Google.
publish
Publikuje wersję kontenera.
przywróć
Przywraca wersję kontenera. Spowoduje to zastąpienie bieżącej konfiguracji kontenera (w tym jego zmiennych, reguł i tagów). Operacja nie będzie miała żadnego wpływu na udostępnianą wersję (czyli na wersję opublikowaną).
undelete
Przywraca usunięcie wersji kontenera.
aktualizacja
Aktualizuje wersję kontenera.