Tags: create

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

Prośba

Żą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/{identyfikator_konta}/containers/{identyfikator_kontenera}/workspaces/{identyfikator_obszaru roboczego}

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 tagów 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: 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
monitoringMetadata.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 tagu. 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
priority.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 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 Identyfikatory reguł blokujących. Jeśli któraś z tych reguł ma wartość Prawda, tag się nie uruchomi. z możliwością zapisu
consentSettings nested object Ustawienia uzyskiwania zgody dla tagu. z możliwością zapisu
consentSettings.consentType.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
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 takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
firingRuleId[] list Uruchamianie identyfikatorów reguł. Tag jest uruchamiany, gdy którakolwiek z wymienionych reguł jest prawdziwa, a wszystkie reguły blockingRuleIds (jeśli zostały określone) mają wartość fałsz. z możliwością zapisu
firingTriggerId[] list Identyfikatory aktywatorów. Tag jest uruchamiany, gdy którakolwiek z tych reguł ma wartość prawda, a wszystkie jego reguły (blockingTriggerIds) mają wartość Fałsz. z możliwością zapisu
liveOnly boolean Jeśli zasada ma wartość Prawda, ten tag będzie się uruchamiać tylko w środowisku aktywnym (np. nie w trybie podglądu ani debugowania). z możliwością zapisu
monitoringMetadata nested object Mapa par klucz-wartość metadanych tagu, które mają być dołączane w danych zdarzenia na potrzeby monitorowania tagów. Uwagi:
  • Musi to być typ MAP.
  • Każdy parametr na 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 dla parametrów najwyższego poziomu oraz wartości mapy. 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 takich jak „”) odpowiednio do 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 z wykorzystaniem podanego klucza. z możliwością zapisu
notes string Użytkownik zauważa, 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 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
paused boolean Wskazuje, czy tag jest wstrzymany, co uniemożliwia jego uruchomienie. z możliwością zapisu
priority nested object Zdefiniowany przez użytkownika liczbowy priorytet tagu. Tagi są uruchamiane asynchronicznie w kolejności zgodnej z priorytetem. Tagi o większej wartości liczbowej uruchamiają się jako pierwsze. Priorytet tagu może być dodatni lub ujemny. Wartością domyślną jest 0. z możliwością zapisu
priority.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
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 takich jak „”) odpowiednio do określonego typu. z możliwością zapisu
scheduleEndMs long Sygnatura czasowa zakończenia (w milisekundach) pozwalająca zaplanować tag. z możliwością zapisu
scheduleStartMs long Sygnatura czasowa początku uruchomienia tagu (w milisekundach). z możliwością zapisu

Odpowiedź

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

Wypróbuj

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