Container Versions

Kapsayıcının Kapsayıcı Sürümleri. Kapsayıcı sürümü, kapsayıcının belirli bir zamandaki yapılandırmasının sabit bir kopyası (anlık görüntü) olarak düşünülebilir. create yöntemini kullanarak yeni bir sürüm oluşturduğunuzda, mevcut yapılandırmaya (yani kapsayıcının makroları, kuralları ve etiketleri) dayalı bir sürüm oluşturulur. restore yöntemi, kapsayıcının yapılandırmasını belirtilen sürümü kullanarak geri yükler. update yöntemi, bir sürümün name ve notes alanlarının güncellenmesini sağlar. Yayınlanan sürümü getirmek için get yöntemini kullanın ve containerVersionId için published değerini belirtin.

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna göz atın.

Kaynak temsilleri

Bir Google Etiket Yöneticisi kapsayıcı sürümünü temsil eder.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}
Mülk adı Değer Açıklama Notlar
accountId string GTM Hesap Kimliği.
container nested object Bu sürümün alındığı kapsayıcı.
containerId string GTM Kapsayıcı Kimliği.
containerVersionId string containerVersionId, GTM Kapsayıcı Sürümünü benzersiz bir şekilde tanımlar.
deleted boolean Doğru değeri, bu kapsayıcı sürümünün silindiğini gösterir.
fingerprint string GTM kapsayıcı sürümünün depolama zamanında hesaplanan parmak izi. Bu değer, kapsayıcı sürümü her değiştirildiğinde yeniden hesaplanır.
folder[] list Bu sürümün alındığı kapsayıcıdaki klasörler.
macro[] list Bu sürümün alındığı kapsayıcıdaki makrolar.
macro[].accountId string GTM Hesap Kimliği.
macro[].containerId string GTM Kapsayıcı Kimliği.
macro[].disablingRuleId[] list Yalnızca mobil kapsayıcılar için: Koşullu makroları devre dışı bırakmak için kural kimliklerinin listesi. Makro, etkinleştiren kurallardan biri doğruysa, devre dışı bırakan tüm kurallar yanlışsa makro etkinleştirilir. Sıralanmamış bir grup olarak ele alındı.
macro[].enablingRuleId[] list Yalnızca mobil kapsayıcılar için: Koşullu makroları etkinleştirmek için kural kimliklerinin listesi. Etkinleştiren kurallardan biri doğru, devre dışı bırakan tüm kurallar yanlış ise makro etkinleştirilir. Sıralanmamış bir grup olarak ele alındı.
macro[].fingerprint string GTM Makrosunun depolama zamanında hesaplanan parmak izi. Makro her değiştirildiğinde bu değer yeniden hesaplanır.
macro[].macroId string Makro Kimliği, Google Etiket Yöneticisi Makrosunu benzersiz bir şekilde tanımlar.
macro[].name string Makronun görünen adı.
macro[].notes string Bu makronun kapsayıcıya nasıl uygulanacağına ilişkin kullanıcı notları.
macro[].parameter[] list Makronun parametreleri.
macro[].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
macro[].parameter[].list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
macro[].parameter[].map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
macro[].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


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
yazılabilir
macro[].parameter[].value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
macro[].parentFolderId string Üst klasör kimliği.
macro[].scheduleEndMs long Bir makroyu programlamak için milisaniye cinsinden bitiş zaman damgası.
macro[].scheduleStartMs long Bir makroyu programlamak için milisaniye cinsinden başlangıç zaman damgası.
macro[].type string Google Etiket Yöneticisi Makro Türü.
name string Kapsayıcı sürümü görünen adı. yazılabilir
notes string Bu kapsayıcı sürümünün kapsayıcıya nasıl uygulanacağıyla ilgili kullanıcı notları. yazılabilir
rule[] list Bu sürümün alındığı kapsayıcıdaki kurallar.
rule[].accountId string GTM Hesap Kimliği.
rule[].condition[] list Bu kuralı oluşturan koşulların listesi (aralarında örtülü VE).
rule[].condition[].parameter[] list Koşulun türüne bağlı olarak adlandırılmış parametrelerin (anahtar/değer) bir listesi. Notlar:
  • İkili operatörler için, sol ve sağ işlenenleri belirtmek üzere sırasıyla arg0 ve arg1 adlı parametreleri ekleyin.
  • Şu anda, sol işlenen (arg0) bir değişkene başvuru olmalıdır.
  • Büyük/küçük harfe duyarlı olmayan Normal İfade eşleşmesi için true olarak ayarlanmış ignore_case adlı bir boole parametresi ekleyin. Belirtilmezse veya başka bir değere ayarlanırsa eşleşme büyük/küçük harfe duyarlı olur.
  • Bir operatörü geçersiz kılmak için true olarak ayarlanmış negate boole parametresi adlı bir boole parametresi ekleyin.
yazılabilir
rule[].condition[].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
rule[].condition[].parameter[].list[] list Bu liste parametresinin parametreleri (anahtarlar yoksayılır). yazılabilir
rule[].condition[].parameter[].map[] list Bu eşleme parametresinin parametreleri (anahtar içermelidir, anahtarlar benzersiz olmalıdır). yazılabilir
rule[].condition[].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


Kabul edilebilir değerler şunlardır:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
yazılabilir
rule[].condition[].parameter[].value string Bir parametrenin değeri (" gibi değişken başvuruları içerebilir"), belirtilen türe uygun şekilde. yazılabilir
rule[].condition[].type string Bu koşul için operatör türü.

Kabul edilebilir değerler şunlardır:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
yazılabilir
rule[].containerId string GTM Kapsayıcı Kimliği.
rule[].fingerprint string GTM Kuralı'nın depolama zamanında hesaplanan parmak izi. Kural her değiştirildiğinde bu değer yeniden hesaplanır.
rule[].name string Kuralın görünen adı.
rule[].notes string Bu kuralın kapsayıcıya nasıl uygulanacağıyla ilgili kullanıcı notları.
rule[].ruleId string Kural kimliği, GTM kuralını benzersiz şekilde tanımlar.
tag[] list Kapsayıcıda bu sürümün alındığı etiketler.
trigger[] list Bu sürümün alındığı kapsayıcıdaki tetikleyiciler.
variable[] list Bu sürümün alındığı kapsayıcıdaki değişkenler.

Yöntemler

oluştur
Kapsayıcı sürümü oluşturur.
sil
Bir kapsayıcı sürümünü siler.
al
Kapsayıcı sürümü alır.
list
GTM kapsayıcısının tüm kapsayıcı sürümlerini listeler.
publish
Kapsayıcı sürümü yayınlar.
geri yükle
Bir Kapsayıcı Sürümünü Geri Yükler. Bu işlem, kapsayıcının mevcut yapılandırmasının (değişkenleri, tetikleyicileri ve etiketleri dahil) üzerine yazar. İşlemin, sunulan sürüm (ör. yayınlanan sürüm) üzerinde herhangi bir etkisi olmaz.
undelete
Bir kapsayıcı sürümünü silme işlemini geri alır.
güncelleme
Kapsayıcı sürümünü günceller.