Variables: update

Aktualizuje zmienną Menedżera tagów Google. Wypróbuj teraz

Prośba

Żądanie HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
path string Ścieżka względna interfejsu API zmiennej GTM. Przykład: accounts/{identyfikator_konta}/containers/{identyfikator_kontenera}/workspaces/{identyfikator_obszaru roboczego}/zmienne/{identyfikator_zmiennej}
Opcjonalne parametry zapytania
fingerprint string Jeśli odcisk cyfrowy jest podany, musi być zgodny z odciskiem cyfrowym zmiennej w pamięci.

Upoważnienie

To żądanie wymaga autoryzacji w tym zakresie:

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

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

W treści żądania podaj zasób zmiennych z tymi właściwościami:

nazwa usługi, Wartość Opis Uwagi
Właściwości wymagane
formatValue.convertFalseToValue.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.
  • tag_reference: wartość reprezentuje tag, reprezentujący go


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 z możliwością zapisu
formatValue.convertNullToValue.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.
  • tag_reference: wartość reprezentuje tag, reprezentujący go


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 z możliwością zapisu
formatValue.convertTrueToValue.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.
  • tag_reference: wartość reprezentuje tag, reprezentujący go


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 z możliwością zapisu
formatValue.convertUndefinedToValue.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.
  • tag_reference: wartość reprezentuje tag, reprezentujący go


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 z możliwością zapisu
name string Wyświetlana nazwa zmiennej. z możliwością zapisu
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.
  • tag_reference: wartość reprezentuje tag, reprezentujący go


Akceptowane wartości:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 z możliwością zapisu
type string Typ zmiennej Menedżera tagów Google. z możliwością zapisu
Właściwości opcjonalne
disablingTriggerId[] list Tylko kontenery mobilne: lista identyfikatorów reguł służących do wyłączania zmiennych warunkowych. Zmienna jest włączona, jeśli któraś z reguł uruchamiających jest prawda, a wszystkie reguły wyłączające mają wartość fałsz. Zbiór traktowany jako nieuporządkowany. z możliwością zapisu
enablingTriggerId[] list Tylko kontenery mobilne: lista identyfikatorów reguł do włączania zmiennych warunkowych. Zmienna jest włączona, jeśli któraś z reguł uruchamiających jest prawda, a wszystkie reguły wyłączające mają wartość fałsz. Zbiór traktowany jako nieuporządkowany. z możliwością zapisu
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
formatValue.convertFalseToValue.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
formatValue.convertFalseToValue.value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
formatValue.convertNullToValue.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
formatValue.convertNullToValue.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
formatValue.convertNullToValue.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
formatValue.convertNullToValue.value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
formatValue.convertTrueToValue.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
formatValue.convertTrueToValue.value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
formatValue.convertUndefinedToValue.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
formatValue.convertUndefinedToValue.value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
notes string Użytkownik informuje użytkownika, jak zastosować tę zmienną w kontenerze. z możliwością zapisu
parameter[] list Parametry zmiennej. z możliwością zapisu
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
parameter[].list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
parameter[].map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
parameter[].value string Wartość parametru (może zawierać odwołania do zmiennych takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
scheduleEndMs long Sygnatura czasowa zakończenia (w milisekundach) odpowiadająca zaplanowaniu zmiennej. z możliwością zapisu
scheduleStartMs long Sygnatura czasowa rozpoczęcia (w milisekundach) planowania zmiennej. z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób zmiennych.

Wypróbuj

Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.