Tags: create

Bir GTM Etiketi oluşturur. Şimdi deneyin.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
parent string GTM Workspace'in API göreli yolu. Örnek: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

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

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.

İstek metni

İstek gövdesinde aşağıdaki özelliklere sahip bir Etiket kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
consentSettings.consentType.type string Parametre türü. Geçerli değerler şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole değerini temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Parametre eşlemesi belirtilmelidir
  • template: Değer, herhangi bir metni temsil eder. Bu, değişken referanslarını (dize olmayan türler döndürebilen değişken referanslar bile) içerebilir.
  • trigger_reference: Değer, tetikleyici kimliğini temsil eden bir tetikleyiciyi temsil eder
  • tag_reference: Değer, etiket adı olarak belirtilen bir etiketi temsil eder


Kabul edilen değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
monitoringMetadata.type string Parametre türü. Geçerli değerler şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole değerini temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Parametre eşlemesi belirtilmelidir
  • template: Değer, herhangi bir metni temsil eder. Bu, değişken referanslarını (dize olmayan türler döndürebilen değişken referanslar bile) içerebilir.
  • trigger_reference: Değer, tetikleyici kimliğini temsil eden bir tetikleyiciyi temsil eder
  • tag_reference: Değer, etiket adı olarak belirtilen bir etiketi temsil eder


Kabul edilen değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
name string Etiket görünen adı. yazılabilir
parameter[].type string Parametre türü. Geçerli değerler şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole değerini temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Parametre eşlemesi belirtilmelidir
  • template: Değer, herhangi bir metni temsil eder. Bu, değişken referanslarını (dize olmayan türler döndürebilen değişken referanslar bile) içerebilir.
  • trigger_reference: Değer, tetikleyici kimliğini temsil eden bir tetikleyiciyi temsil eder
  • tag_reference: Değer, etiket adı olarak belirtilen bir etiketi temsil eder


Kabul edilen değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
priority.type string Parametre türü. Geçerli değerler şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole değerini temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Parametre eşlemesi belirtilmelidir
  • template: Değer, herhangi bir metni temsil eder. Bu, değişken referanslarını (dize olmayan türler döndürebilen değişken referanslar bile) içerebilir.
  • trigger_reference: Değer, tetikleyici kimliğini temsil eden bir tetikleyiciyi temsil eder
  • tag_reference: Değer, etiket adı olarak belirtilen bir etiketi temsil eder


Kabul edilen değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
type string GTM Etiket Türü. yazılabilir
İsteğe Bağlı Özellikler
blockingRuleId[] list Engelleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez. yazılabilir
blockingTriggerId[] list Tetikleyici kimlikleri engelleniyor. Listelenen tetikleyicilerden herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez. yazılabilir
consentSettings nested object Bir etiketin izin ayarları. yazılabilir
consentSettings.consentType.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Hem üst düzey parametreler hem de harita değerleri için gereklidir. Liste değerleri için yoksayıldı. yazılabilir
consentSettings.consentType.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
consentSettings.consentType.map[] list Bu harita parametresinin parametreleri (anahtar içermelidir, anahtar benzersiz olmalıdır). yazılabilir
consentSettings.consentType.value string Bir parametrenin değeri (" gibi değişken referansları içerebilir") belirtilen türe uygun olabilir. yazılabilir
firingRuleId[] list Tetikleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğruysa ve blockingRuleIds değerinin (varsa) tümü yanlışsa etiket tetiklenir. yazılabilir
firingTriggerId[] list Tetikleme tetikleyici kimlikleri. Listelenen tetikleyicilerden herhangi biri doğruysa ve blockingTriggerIds değerinin (varsa) tümü yanlışsa etiket tetiklenir. yazılabilir
liveOnly boolean Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda değil). yazılabilir
monitoringMetadata nested object Etiket izleme için etkinlik verilerine dahil edilecek etiket meta verisi anahtar/değer çiftlerinin eşlemesi. Not:
  • Bu parametre MAP türünde olmalıdır.
  • Haritadaki her parametre TEMPLATE türündedir, ancak değişken referansları içeremez.
 yazılabilir
monitoringMetadata.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Hem üst düzey parametreler hem de harita değerleri için gereklidir. Liste değerleri için yoksayıldı. yazılabilir
monitoringMetadata.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
monitoringMetadata.map[] list Bu harita parametresinin parametreleri (anahtar içermelidir, anahtar benzersiz olmalıdır). yazılabilir
monitoringMetadata.value string Bir parametrenin değeri (" gibi değişken referansları içerebilir") belirtilen türe uygun olabilir. yazılabilir
monitoringMetadataTagNameKey string Boş değilse etiket görünen adı, belirtilen anahtar kullanılarak izleme meta veri eşlemesine eklenir. yazılabilir
notes string Kullanıcı, bu etiketin kapsayıcıya nasıl uygulanacağına ilişkin notlar. yazılabilir
parameter[] list Etiketin parametreleri. yazılabilir
parameter[].key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Hem üst düzey parametreler hem de harita değerleri için gereklidir. Liste değerleri için yoksayıldı. yazılabilir
parameter[].list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
parameter[].map[] list Bu harita parametresinin parametreleri (anahtar içermelidir, anahtar benzersiz olmalıdır). yazılabilir
parameter[].value string Bir parametrenin değeri (" gibi değişken referansları içerebilir") belirtilen türe uygun olabilir. yazılabilir
paused boolean Etiketin duraklatılıp duraklatılmadığını gösterir; bu, etiketin tetiklenmesini engeller. yazılabilir
priority nested object Etiketin kullanıcı tanımlı sayısal önceliği. Etiketler, öncelik sırasına göre eşzamansız olarak tetiklenir. Sayısal değeri daha yüksek olan etiketler önce tetiklenir. Bir etiketin önceliği, pozitif veya negatif bir değer olabilir. Varsayılan değer 0'dır. yazılabilir
priority.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Hem üst düzey parametreler hem de harita değerleri için gereklidir. Liste değerleri için yoksayıldı. yazılabilir
priority.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
priority.map[] list Bu harita parametresinin parametreleri (anahtar içermelidir, anahtar benzersiz olmalıdır). yazılabilir
priority.value string Bir parametrenin değeri (" gibi değişken referansları içerebilir") belirtilen türe uygun olabilir. yazılabilir
scheduleEndMs long Etiketi planlamak için milisaniye cinsinden bitiş zaman damgası. yazılabilir
scheduleStartMs long Etiketi planlamak için milisaniye cinsinden başlangıç zaman damgası. yazılabilir

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir Etiketler kaynağı döndürür.

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.