Container Versions

Wersje kontenera. Wersję kontenera można traktować jako niezmienną kopię (migawki) konfiguracji kontenera w określonym momencie. Utworzenie nowej wersji przy użyciu metody create spowoduje utworzenie wersji opartej na bieżącej konfiguracji (tj. na podstawie makr, reguł i tagów kontenera). Metoda restore przywróci konfigurację kontenera z użyciem określonej wersji. Metoda update umożliwia aktualizowanie pól name i notes wersji. Aby pobrać aktualnie opublikowaną wersję, użyj metody get i określ published dla parametru containerVersionId.

Listę metod dla 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 pochodzi ta wersja.
containerId string Identyfikator kontenera Menedżera tagów Google.
containerVersionId string containerVersionId jednoznacznie identyfikuje wersję kontenera Menedżera tagów Google.
deleted boolean Wartość true wskazuje, że ta wersja kontenera została usunięta.
fingerprint string Odcisk cyfrowy wersji kontenera Menedżera tagów Google wygenerowany w momencie przechowywania. Ta wartość jest obliczana ponownie po każdej zmianie wersji kontenera.
folder[] list Foldery w kontenerze, z którego pochodzi ta wersja.
macro[] list Makra w kontenerze, z którego pochodzi ta wersja.
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łączania jest spełniony, a wszystkie reguły wyłączania mają wartość Fałsz. Traktowany jako zestaw nieuporządkowany.
macro[].enablingRuleId[] list Tylko w przypadku kontenerów mobilnych: lista identyfikatorów reguł umożliwiających włączanie makr warunkowych; makro jest włączone, jeśli jedna z reguł włączania jest spełniony, a wszystkie reguły wyłączania mają wartość Fałsz. Traktowany jako zestaw nieuporządkowany.
macro[].fingerprint string Odcisk cyfrowy makra Menedżera tagów Google wygenerowany w czasie przechowywania. Ta wartość jest obliczana ponownie po każdej modyfikacji makra.
macro[].macroId string Identyfikator makra jednoznacznie identyfikuje makro Menedżera tagów Google.
macro[].name string Wyświetlana nazwa makra.
macro[].notes string Użytkownik pokazuje, jak zastosować to makro w kontenerze.
macro[].parameter[] list Parametry makra.
macro[].parameter[].key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane w przypadku parametrów najwyższego poziomu oraz wartości mapowania. 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: ta wartość to wartość logiczna, reprezentowana przez wartość „true” (prawda). lub „false”
  • integer: wartość reprezentuje 64-bitową wartość całkowitą ze znakiem w podstawie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość przedstawia dowolny tekst; może to obejmować 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łę przedstawianą jako 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, np. „”), w zależności od określonego typu. z możliwością zapisu
macro[].parentFolderId string Identyfikator folderu nadrzędnego.
macro[].scheduleEndMs long Sygnatura czasowa zakończenia (w milisekundach) do zaplanowania działania makra.
macro[].scheduleStartMs long Sygnatura czasowa rozpoczęcia (w milisekundach) umożliwiająca zaplanowanie 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 Użytkownik zaznacza, jak zastosować tę wersję kontenera w kontenerze. z możliwością zapisu
rule[] list Reguły w kontenerze, z którego pochodzi ta wersja.
rule[].accountId string Identyfikator konta Menedżera tagów Google.
rule[].condition[] list Lista warunków tworzących regułę (pośrednio ORAZ między nimi).
rule[].condition[].parameter[] list Lista parametrów nazwanych (klucz/wartość) w zależności od typu warunku. Uwagi:
  • W przypadku operatorów binarnych dołącz parametry o nazwach arg0 i arg1, aby określić odpowiednio lewy i prawy operand.
  • W tej chwili lewy operand (arg0) musi być odwołaniem do zmiennej.
  • W przypadku dopasowywania wyrażenia regularnego bez rozróżniania wielkości liter dodaj parametr logiczny o nazwie ignore_case, który ma wartość true. Jeśli wartość nie zostanie określona lub ustawiona, podczas dopasowywania będzie rozróżniana wielkość liter.
  • Aby wykluczyć operator, dodaj parametr logiczny o nazwie negate i ustawiony na true.
z możliwością zapisu
rule[].condition[].parameter[].key string Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane w przypadku parametrów najwyższego poziomu oraz wartości mapowania. 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: ta wartość to wartość logiczna, reprezentowana przez wartość „true” (prawda). lub „false”
  • integer: wartość reprezentuje 64-bitową wartość całkowitą ze znakiem w podstawie 10
  • list: należy określić listę parametrów
  • map: należy określić mapę parametrów
  • template: wartość przedstawia dowolny tekst; może to obejmować 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łę przedstawianą jako 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, np. „”), w zależności od określonego typu. z możliwością zapisu
rule[].condition[].type string Typ operatora dla tego warunku.

Akceptowane wartości to:
  • 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 wygenerowany w momencie przechowywania. Ta wartość jest obliczana ponownie po każdej modyfikacji reguły.
rule[].name string Wyświetlana nazwa reguły.
rule[].notes string Użytkownik pokazuje, jak zastosować tę regułę 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 Aktywatory w kontenerze, z którego pochodzi ta wersja.
variable[] list Zmienne w kontenerze, z którego pochodzi ta wersja.

Metody

utwórz
Tworzy wersję kontenera.
usuń
Usuwa wersję kontenera.
pobierz
Pobiera wersję kontenera.
list
Wyświetla listę wszystkich wersji kontenera Menedżera tagów Google.
opublikuj
Publikuje wersję kontenera.
przywróć
Przywraca wersję kontenera. Spowoduje to zastąpienie bieżącego stanu kontenera konfiguracji (w tym zmiennych, reguł i tagów). Operacja nie będzie mieć żadnego wpływu na udostępnianą wersję (tj. wersji opublikowanej).
przywróć
Przywraca wersję kontenera.
zaktualizuj
Aktualizuje wersję kontenera.