Tags: create

Membuat Tag GTM. Coba sekarang.

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
parent string Jalur relatif API Workspace GTM. Contoh: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

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

Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, sediakan resource Tag dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti yang Diperlukan
consentSettings.consentType.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
  • tag_reference: Nilai mewakili tag, yang direpresentasikan sebagai nama tag


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
dapat ditulis
monitoringMetadata.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
  • tag_reference: Nilai mewakili tag, yang direpresentasikan sebagai nama tag


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
dapat ditulis
name string Nama tampilan tag. 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 variabel (bahkan referensi variabel yang mungkin menampilkan jenis non-string)
  • trigger_reference: Nilai mewakili pemicu, yang direpresentasikan sebagai ID pemicu
  • tag_reference: Nilai mewakili tag, yang direpresentasikan sebagai nama tag


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
dapat ditulis
priority.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
  • tag_reference: Nilai mewakili tag, yang direpresentasikan sebagai nama tag


Nilai yang dapat diterima:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
dapat ditulis
type string Jenis Tag GTM. dapat ditulis
Properti Opsional
blockingRuleId[] list ID aturan pemblokiran. Jika salah satu aturan yang tercantum bernilai benar (true), tag tidak akan diaktifkan. dapat ditulis
blockingTriggerId[] list ID pemicu pemblokiran. Jika salah satu pemicu yang tercantum bernilai benar, tag tidak akan diaktifkan. dapat ditulis
consentSettings nested object Setelan izin tag. dapat ditulis
consentSettings.consentType.key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
consentSettings.consentType.list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
consentSettings.consentType.map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
consentSettings.consentType.value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
firingRuleId[] list ID aturan pengaktifan. Tag akan diaktifkan jika salah satu aturan yang tercantum adalah benar dan semua blockingRuleIds-nya (jika ditentukan) bernilai salah. dapat ditulis
firingTriggerId[] list ID pemicu pengaktifan. Tag akan diaktifkan jika salah satu pemicu yang tercantum adalah benar dan semua blockingTriggerIds-nya (jika ditentukan) salah. dapat ditulis
liveOnly boolean Jika ditetapkan ke benar (true), tag ini hanya akan diaktifkan di lingkungan aktif (mis., bukan dalam mode pratinjau atau debug). dapat ditulis
monitoringMetadata nested object Peta key-value pair metadata tag yang akan disertakan dalam data peristiwa untuk pemantauan tag. Catatan:
  • Parameter ini harus berjenis MAP.
  • Setiap parameter dalam peta adalah jenis TEMPLATE, tetapi tidak boleh berisi referensi variabel.
dapat ditulis
monitoringMetadata.key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
monitoringMetadata.list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
monitoringMetadata.map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
monitoringMetadata.value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
monitoringMetadataTagNameKey string Jika tidak kosong, nama tampilan tag akan disertakan dalam peta metadata pemantauan menggunakan kunci yang ditentukan. dapat ditulis
notes string Catatan pengguna tentang cara menerapkan tag ini di penampung. dapat ditulis
parameter[] list Parameter tag. 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[].value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
paused boolean Menunjukkan apakah tag dijeda atau tidak, sehingga tag tidak akan diaktifkan. dapat ditulis
priority nested object Prioritas numerik tag buatan pengguna. Tag diaktifkan secara asinkron sesuai urutan prioritas. Tag dengan nilai numerik yang lebih tinggi akan diaktifkan terlebih dahulu. Prioritas tag dapat berupa nilai positif atau negatif. Nilai defaultnya adalah 0. dapat ditulis
priority.key string Kunci bernama yang mengidentifikasi parameter secara unik. Diperlukan untuk parameter tingkat teratas, serta nilai peta. Diabaikan untuk nilai daftar. dapat ditulis
priority.list[] list Parameter parameter daftar ini (kunci akan diabaikan). dapat ditulis
priority.map[] list Parameter parameter peta ini (harus memiliki kunci; kunci harus unik). dapat ditulis
priority.value string Nilai parameter (dapat berisi referensi variabel seperti "") yang sesuai dengan jenis yang ditentukan. dapat ditulis
scheduleEndMs long Stempel waktu akhir dalam milidetik untuk menjadwalkan tag. dapat ditulis
scheduleStartMs long Stempel waktu mulai dalam milidetik untuk menjadwalkan tag. dapat ditulis

Respons

Jika berhasil, metode ini akan menampilkan resource Tag dalam isi respons.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons.