Memperbarui Tag GTM. Coba sekarang.
Permintaan
Permintaan HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
path |
string |
Jalur relatif API Tag GTM. Contoh: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id} |
Parameter kueri opsional | ||
fingerprint |
string |
Jika diberikan, sidik jari ini harus cocok dengan sidik jari tag di penyimpanan. |
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:
Nilai yang dapat diterima:
|
dapat ditulis |
monitoringMetadata.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
name |
string |
Nama tampilan tag. | dapat ditulis |
parameter[].type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
dapat ditulis |
priority.type |
string |
Jenis parameter. Nilai yang valid adalah:
Nilai yang dapat diterima:
|
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:
|
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.