Container Versions

Versi Penampung dari suatu penampung. Versi penampung dapat dianggap sebagai salinan yang tidak dapat diubah (snapshot) dari konfigurasi penampung pada titik waktu tertentu. Membuat versi baru menggunakan metode create akan membuat versi berdasarkan konfigurasi saat ini (yaitu makro, aturan, dan tag penampung). Metode restore akan memulihkan konfigurasi penampung menggunakan versi yang ditentukan. Metode update memungkinkan pembaruan kolom name dan notes versi. Untuk mengambil versi yang dipublikasikan saat ini, gunakan metode get dan tentukan published untuk containerVersionId.

Untuk daftar metode resource ini, lihat bagian akhir halaman ini.

Representasi resource

Mewakili versi penampung Google Tag Manager.

{
  "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
}
Nama properti Nilai Deskripsi Catatan
accountId string ID Akun GTM.
container nested object Penampung tempat versi ini diambil.
containerId string ID Penampung GTM.
containerVersionId string containerVersionId secara unik mengidentifikasi Versi Penampung GTM.
deleted boolean Nilai true menunjukkan versi penampung ini telah dihapus.
fingerprint string Sidik jari versi penampung GTM seperti yang dihitung pada waktu penyimpanan. Nilai ini dihitung ulang setiap kali versi penampung diubah.
folder[] list Folder di penampung tempat versi ini diambil.
macro[] list Makro di penampung tempat versi ini diambil.
macro[].accountId string ID Akun GTM.
macro[].containerId string ID Penampung GTM.
macro[].disablingRuleId[] list Khusus untuk penampung seluler: Daftar ID aturan untuk menonaktifkan makro bersyarat; makro diaktifkan jika salah satu aturan pengaktifan bernilai benar sedangkan semua aturan penonaktifan bernilai salah. Dianggap sebagai kumpulan yang tidak berurutan.
macro[].enablingRuleId[] list Khusus untuk penampung seluler: Daftar ID aturan untuk mengaktifkan makro bersyarat; makro diaktifkan jika salah satu aturan pengaktifan bernilai benar sedangkan semua aturan penonaktifan bernilai salah. Dianggap sebagai kumpulan yang tidak berurutan.
macro[].fingerprint string Sidik jari Makro GTM yang dihitung pada waktu penyimpanan. Nilai ini dihitung ulang setiap kali makro diubah.
macro[].macroId string ID Makro secara unik mengidentifikasi Makro GTM.
macro[].name string Nama tampilan makro.
macro[].notes string Catatan pengguna tentang cara menerapkan makro ini di penampung.
macro[].parameter[] list Parameter makro.
macro[].parameter[].key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
macro[].parameter[].list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
macro[].parameter[].map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
macro[].parameter[].type string Jenis parameter. Nilai yang valid adalah:
  • boolean: Nilai mewakili boolean, yang diwakili sebagai 'true' atau 'false'
  • integer: Nilai mewakili nilai bilangan bulat dengan tanda tangan 64-bit, di basis 10
  • list: Daftar parameter harus ditentukan
  • map: Peta parameter harus ditentukan
  • template: Nilai mewakili teks apa pun; nilai ini dapat mencakup referensi variabel (bahkan referensi variabel yang mungkin menampilkan jenis non-string)
  • trigger_reference: Nilai mewakili pemicu, yang direpresentasikan sebagai ID pemicu


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
dapat ditulis
macro[].parameter[].value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
macro[].parentFolderId string ID folder induk.
macro[].scheduleEndMs long Stempel waktu akhir dalam milidetik untuk menjadwalkan makro.
macro[].scheduleStartMs long Stempel waktu mulai dalam milidetik untuk menjadwalkan makro.
macro[].type string Jenis Makro GTM.
name string Nama tampilan versi penampung. dapat ditulis
notes string Catatan pengguna tentang cara menerapkan versi penampung ini di penampung. dapat ditulis
rule[] list Aturan dalam penampung tempat versi ini diambil.
rule[].accountId string ID Akun GTM.
rule[].condition[] list Daftar kondisi yang membentuk aturan ini (DAN implisit di antara keduanya).
rule[].condition[].parameter[] list Daftar parameter bernama (kunci/nilai), bergantung pada jenis kondisi. Catatan:
  • Untuk operator biner, sertakan parameter bernama arg0 dan arg1 untuk menentukan operand kiri dan kanan.
  • Pada saat ini, operand kiri (arg0) harus menjadi referensi ke variabel.
  • Untuk pencocokan Ekspresi Reguler yang tidak peka huruf besar/kecil, sertakan parameter boolean bernama ignore_case yang disetel ke true. Jika tidak ditentukan atau ditetapkan ke nilai lain, pencocokan akan peka huruf besar/kecil.
  • Untuk menegasikan operator, sertakan parameter boolean bernama parameter boolean negate yang disetel ke true.
dapat ditulis
rule[].condition[].parameter[].key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
rule[].condition[].parameter[].list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
rule[].condition[].parameter[].map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
rule[].condition[].parameter[].type string Jenis parameter. Nilai yang valid adalah:
  • boolean: Nilai mewakili boolean, yang diwakili sebagai 'true' atau 'false'
  • integer: Nilai mewakili nilai bilangan bulat dengan tanda tangan 64-bit, di basis 10
  • list: Daftar parameter harus ditentukan
  • map: Peta parameter harus ditentukan
  • template: Nilai mewakili teks apa pun; nilai ini dapat mencakup referensi variabel (bahkan referensi variabel yang mungkin menampilkan jenis non-string)
  • trigger_reference: Nilai mewakili pemicu, yang direpresentasikan sebagai ID pemicu


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
dapat ditulis
rule[].condition[].parameter[].value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
rule[].condition[].type string Jenis operator untuk kondisi ini.

Nilai yang dapat diterima adalah:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
dapat ditulis
rule[].containerId string ID Penampung GTM.
rule[].fingerprint string Sidik jari Aturan GTM seperti yang dihitung pada waktu penyimpanan. Nilai ini dihitung ulang setiap kali aturan diubah.
rule[].name string Nama tampilan aturan.
rule[].notes string Catatan pengguna tentang cara menerapkan aturan ini di penampung.
rule[].ruleId string ID Aturan secara unik mengidentifikasi Aturan GTM.
tag[] list Tag di penampung tempat versi ini diambil.
trigger[] list Pemicu di penampung tempat versi ini diambil.
variable[] list Variabel dalam penampung tempat versi ini diambil.

Metode

buat
Membuat versi penampung.
hapus
Menghapus versi penampung.
dapatkan
Mendapatkan versi penampung.
list
Mencantumkan semua versi penampung dari penampung GTM.
publish
Memublikasikan versi penampung.
pulihkan
Memulihkan Versi Penampung. Tindakan ini akan menimpa konfigurasi penampung saat ini (termasuk variabel, pemicu, dan tagnya). Operasi ini tidak akan berpengaruh pada versi yang sedang ditayangkan (yaitu versi yang dipublikasikan).
undelete
Membatalkan penghapusan versi penampung.
pembaruan
Memperbarui versi penampung.