Macros

Makro penampung. Makro mewakili nilai yang dievaluasi saat runtime. Anda dapat mereferensikan makro saat mengonfigurasi aturan dan tag. Untuk mengetahui detail properti yang dapat ditetapkan untuk makro Google Tag Manager, lihat Referensi Kamus Makro. Untuk informasi tentang cara pengguna menyiapkan dan menggunakan makro, lihat artikel Makro di Pusat Bantuan Google Tag Manager.

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

Representasi resource

Mewakili makro Google Tag Manager.

{
  "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
}
Nama properti Nilai Deskripsi Catatan
accountId string ID Akun GTM.
containerId string ID Penampung GTM.
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. dapat ditulis
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. dapat ditulis
fingerprint string Sidik jari Makro GTM yang dihitung pada waktu penyimpanan. Nilai ini dihitung ulang setiap kali makro diubah.
macroId string ID Makro secara unik mengidentifikasi Makro GTM.
name string Nama tampilan makro. dapat ditulis
notes string Catatan pengguna tentang cara menerapkan makro ini di penampung. dapat ditulis
parameter[] list Parameter makro. dapat ditulis
parameter[].key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
parameter[].list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
parameter[].map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
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 makro (bahkan referensi makro yang mungkin menampilkan jenis non-string)


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
dapat ditulis
parameter[].value string Nilai parameter (dapat berisi referensi makro seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
parentFolderId string ID folder induk.
scheduleEndMs long Stempel waktu akhir dalam milidetik untuk menjadwalkan makro. dapat ditulis
scheduleStartMs long Stempel waktu mulai dalam milidetik untuk menjadwalkan makro. dapat ditulis
type string Jenis Makro GTM. dapat ditulis

Metode

Gunakan metode di bawah untuk membuat, mengubah, menghapus, atau mengambil makro.

buat
Membuat makro GTM.
hapus
Menghapus makro GTM.
dapatkan
Mendapatkan makro GTM.
list
Mencantumkan semua makro GTM dari sebuah penampung.
pembaruan
Memperbarui makro GTM.