Tags: update

Bir GTM Etiketi'ni günceller. Şimdi deneyin.

İstek

HTTP isteği

PUT https://www.googleapis.com/tagmanager/v2/path

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
path string GTM Etiketi'nin API göreli yolu. Örnek: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}
İsteğe bağlı sorgu parametreleri
fingerprint string Bu parmak izi sağlandığında, depolama alanındaki etiketin parmak iziyle eşleşmelidir.

Yetkilendirme

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

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

Daha fazla bilgi 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 Etiketler kaynağı sağlayın:

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


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 şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir.
  • trigger_reference: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


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 şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir.
  • trigger_reference: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


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 şunlardır:
  • boolean: Değer, "true" veya "false" olarak temsil edilen bir boole'yi temsil eder
  • integer: Değer, 10 tabanında 64 bit imzalı bir tam sayı değerini temsil eder
  • list: Parametre listesi belirtilmelidir
  • map: Bir parametre eşlemesi belirtilmelidir
  • template: Değer herhangi bir metni temsil eder; değişken referanslar (dize olmayan türler döndürebilen değişken referansları bile) içerebilir.
  • trigger_reference: Değer, bir tetikleyiciyi temsil eder ve tetikleyici kimliği olarak temsil edilir
  • tag_reference: Değer, etiket adı olarak temsil edilen bir etiketi temsil eder


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 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. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
consentSettings.consentType.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
firingRuleId[] list Tetikleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru ve tüm blockingRuleIds (belirtilmişse) yanlış olduğunda etiket etkinleşir. yazılabilir
firingTriggerId[] list Tetikleyen tetikleyici kimlikleri. Listelenen tetikleyicilerden herhangi biri doğru ve blockingTriggerIds değerinin tamamı (belirtildiyse) yanlış olduğunda 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 tetiklenmez). yazılabilir
monitoringMetadata nested object Etiket izleme için etkinlik verilerine dahil edilecek etiket meta verilerinin anahtar/değer çiftlerinin eşlemesi. Notlar:
  • Bu parametrenin türü MAP olmalıdır.
  • Haritadaki her parametrenin türü TEMPLATE olsa da değişken referansları içeremez.
 yazılabilir
monitoringMetadata.key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
monitoringMetadata.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
monitoringMetadataTagNameKey string Boş değilse etiketin görünen adı, belirtilen anahtar kullanılarak izleme meta veri haritasına eklenir. yazılabilir
notes string Bu etiketin kapsayıcıya nasıl uygulanacağıyla ilgili kullanıcı notları. yazılabilir
parameter[] list Etiketin parametreleri. yazılabilir
parameter[].key string Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
parameter[].value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
paused boolean Etiketin duraklatılıp duraklatılmadığını belirtir. Bu durum, etiketin etkinleşmesini 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. Daha yüksek sayısal değere sahip 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. Harita değerleri ve üst düzey parametreler 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 (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
priority.value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
scheduleEndMs long Bir etiketin planlanacağı bitiş zaman damgası (milisaniye cinsinden). yazılabilir
scheduleStartMs long Bir etiketin planlanacağı başlangıç zaman damgası (milisaniye cinsinden). yazılabilir

Yanıt

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

Deneyin.

Aşağıdaki API Gezgini'ni kullanarak canlı verilerde bu yöntemi çağırın ve yanıtı görün.