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:
Akceptowane wartości:
|
z możliwością zapisu |
monitoringMetadata.type |
string |
Typ parametru. Prawidłowe wartości to:
Akceptowane wartości:
|
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:
Akceptowane wartości:
|
z możliwością zapisu |
priority.type |
string |
Typ parametru. Prawidłowe wartości to:
Akceptowane wartości:
|
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:
|
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ź.