Tags: create

Tworzy tag Menedżera tagów Google. Wypróbuj

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
parent string Ścieżka względna interfejsu API Workspace Menedżera tagów Google. Przykład: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

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

Nazwa usługi Wartość Opis Uwagi
Właściwości wymagane
consentSettings.consentType.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.
  • tag_reference: ta wartość reprezentuje tag reprezentowany jako nazwa tagu.
.

Akceptowane wartości:
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
z możliwością zapisu
monitoringMetadata.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.
  • tag_reference: ta wartość reprezentuje tag reprezentowany jako nazwa tagu.
.

Akceptowane wartości:
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
z możliwością zapisu
name string Wyświetlana nazwa tagu. z możliwością zapisu
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.
  • tag_reference: ta wartość reprezentuje tag reprezentowany jako nazwa tagu.
.

Akceptowane wartości:
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
z możliwością zapisu
priority.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.
  • tag_reference: ta wartość reprezentuje tag reprezentowany jako nazwa tagu.
.

Akceptowane wartości:
  • boolean
  • integer
  • list
  • map
  • tagReference
  • template
  • triggerReference
  • typeUnspecified
z możliwością zapisu
type string Typ tagu Menedżera tagów Google. z możliwością zapisu
Właściwości opcjonalne
blockingRuleId[] list Identyfikatory reguł blokowania. Jeśli któraś z wymienionych reguł ma wartość prawda, tag się nie uruchomi. z możliwością zapisu
blockingTriggerId[] list Blokowanie identyfikatorów aktywatorów. Jeśli któraś z wymienionych reguł zwróci wartość prawda, tag się nie uruchomi. z możliwością zapisu
consentSettings nested object Ustawienia dotyczące uzyskiwania zgody w przypadku tagu. z możliwością zapisu
consentSettings.consentType.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
consentSettings.consentType.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
consentSettings.consentType.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
consentSettings.consentType.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
firingRuleId[] list Identyfikatory uruchamiania reguł. Tag jest uruchamiany, gdy jest spełniony dowolny z wymienionych warunków, a wszystkie blockingRuleIds (jeśli zostały określone) są fałszywe. z możliwością zapisu
firingTriggerId[] list Identyfikatory uruchamiania reguł. Tag uruchomi się, gdy którakolwiek z wymienionych reguł będzie prawdziwa, a wszystkie blockingTriggerIds (jeśli jakiekolwiek określisz) będą fałszywe. z możliwością zapisu
liveOnly boolean Jeśli ma wartość true (prawda), ten tag będzie się uruchamiać tylko w aktywnym środowisku (np. nie w trybie podglądu ani debugowania). z możliwością zapisu
monitoringMetadata nested object Mapa par klucz-wartość metadanych tagów, które mają być uwzględnione w danych zdarzenia na potrzeby monitorowania tagów. Uwagi:
  • Parametr musi być typu MAP.
  • Każdy parametr w mapie jest typu TEMPLATE, ale nie może zawierać odwołań do zmiennych.
z możliwością zapisu
monitoringMetadata.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
monitoringMetadata.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
monitoringMetadata.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
monitoringMetadata.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
monitoringMetadataTagNameKey string Jeśli pole nie jest puste, wyświetlana nazwa tagu zostanie uwzględniona w mapie metadanych monitorowania za pomocą podanego klucza. z możliwością zapisu
notes string Użytkownik pokazuje, jak zastosować ten tag w kontenerze. z możliwością zapisu
parameter[] list Parametry tagu. z możliwością zapisu
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
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, np. „”), w zależności od określonego typu. z możliwością zapisu
paused boolean Wskazuje, czy tag jest wstrzymany, co uniemożliwia jego uruchomienie. z możliwością zapisu
priority nested object Określony przez użytkownika numeryczny priorytet tagu. Tagi są uruchamiane asynchronicznie w kolejności według priorytetu. Tagi o wyższych wartościach liczbowych są uruchamiane jako pierwsze. Priorytet tagu może być wartością dodatnią lub ujemną. Wartością domyślną jest 0. z możliwością zapisu
priority.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
priority.list[] list Parametry tego parametru listy (klucze będą ignorowane). z możliwością zapisu
priority.map[] list Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne). z możliwością zapisu
priority.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
scheduleEndMs long Sygnatura czasowa zakończenia w milisekundach służąca do zaplanowania tagu. z możliwością zapisu
scheduleStartMs long Sygnatura czasowa rozpoczęcia (w milisekundach) umożliwiająca zaplanowanie tagu. z możliwością zapisu

Odpowiedź

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

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.