Tags: create

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ına göz atın.

İstek içeriği

İ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 aşağıda belirtilmiştir:
  • boolean: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false"
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Bir parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir
  • trigger_reference: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder.
  • tag_reference: Değer, etiket adı olarak gösterilen bir etiketi temsil eder.
ziyaret edin.

Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
monitoringMetadata.type string Parametre türü. Geçerli değerler aşağıda belirtilmiştir:
  • boolean: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false"
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Bir parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir
  • trigger_reference: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder.
  • tag_reference: Değer, etiket adı olarak gösterilen bir etiketi temsil eder.
ziyaret edin.

Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
name string Etiketin görünen adı. yazılabilir
parameter[].type string Parametre türü. Geçerli değerler aşağıda belirtilmiştir:
  • boolean: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false"
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Bir parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir
  • trigger_reference: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder.
  • tag_reference: Değer, etiket adı olarak gösterilen bir etiketi temsil eder.
ziyaret edin.

Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 yazılabilir
priority.type string Parametre türü. Geçerli değerler aşağıda belirtilmiştir:
  • boolean: Değer, "true" olarak gösterilen bir boole'yi temsil eder veya "false"
  • integer: Değer, 10 tabanında 64 bit imzalı tam sayı değerini temsil eder
  • list: Bir parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; bu değişken referanslar (dize olmayan türleri döndürebilecek değişken referanslar bile) içerebilir
  • trigger_reference: Değer, tetikleyici kimliği olarak gösterilen bir tetikleyiciyi temsil eder.
  • tag_reference: Değer, etiket adı olarak gösterilen bir etiketi temsil eder.
ziyaret edin.

Kabul edilebilir 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 Etiketin izin ayarları. yazılabilir
consentSettings.consentType.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. yazılabilir
consentSettings.consentType.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
consentSettings.consentType.map[] list Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). yazılabilir
consentSettings.consentType.value string Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). yazılabilir
firingRuleId[] list Tetikleme kuralı kimlikleri. Bir etiket, listelenen kurallardan herhangi biri doğru ve tüm blockingRuleIds (belirtilmişse) yanlış olduğunda tetiklenir. yazılabilir
firingTriggerId[] list Etkinleştirme tetikleyicisi kimlikleri. Bir etiket, listelenen tetikleyicilerden herhangi biri doğru ve tüm blockingTriggerIds tetikleyicileri (belirtilmişse) yanlış olduğunda tetiklenir. yazılabilir
liveOnly boolean Politika, Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda etkinleşmez). yazılabilir
monitoringMetadata nested object Etiket izleme için etkinlik verilerine dahil edilecek etiket meta verilerinin anahtar/değer çiftlerinin haritası. Notlar:
  • Bu parametrenin türü MAP olmalıdır.
  • Haritadaki her parametre TEMPLATE türünde, ancak değişken referansları içeremez.
 yazılabilir
monitoringMetadata.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. yazılabilir
monitoringMetadata.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
monitoringMetadata.map[] list Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). yazılabilir
monitoringMetadata.value string Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). yazılabilir
monitoringMetadataTagNameKey string Boş değilse etiketin görünen adı, belirtilen anahtar kullanılarak izleme meta veri eşlemesine dahil edilir. yazılabilir
notes string Kullanıcı, bu etiketin kapsayıcıya nasıl uygulanacağına ilişkin notları alır. yazılabilir
parameter[] list Etiketin parametreleri. yazılabilir
parameter[].key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. yazılabilir
parameter[].list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
parameter[].map[] list Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). yazılabilir
parameter[].value string Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). yazılabilir
paused boolean Etiketin duraklatılıp etkinleşmediğini belirtir. yazılabilir
priority nested object Etiketin kullanıcı tarafından tanımlanan 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. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. yazılabilir
priority.list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
priority.map[] list Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). yazılabilir
priority.value string Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). yazılabilir
scheduleEndMs long Etiketin programlanması için milisaniye cinsinden bitiş zaman damgası. yazılabilir
scheduleStartMs long Bir etiketi programlamak 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!

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