Memerlukan otorisasi
Membuat tag GTM. Coba sekarang atau lihat contohnya.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
accountId |
string |
ID Akun GTM. |
containerId |
string |
ID Penampung GTM. |
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Isi permintaan
Dalam isi permintaan, sediakan resource Tag dengan properti berikut:
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
Properti yang Diperlukan | |||
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 |
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 |
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 |
True jika tag dijeda. | 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.
Contoh
Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).
Java
Menggunakan library klien Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new tag. */ // Construct the parameters. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("trackingId"); arg0.setValue("UA-123456-1"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("type"); arg1.setValue("TRACK_TRANSACTION"); // Construct the tag object. Tag tag = new Tag(); tag.setName("Sample Universal Analytics Tag"); tag.setType("ua"); tag.setLiveOnly(false); tag.setParameter(Arrays.asList(arg0, arg1)); try { Tag response = tagmanager.accounts().containers(). tags().create("123456", "54321", tag).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the create method are stored in response object. * The following code shows how to access the created id and fingerprint. */ System.out.println("Tag id = " + response.getTagId()); System.out.println("Tag Fingerprint = " + response.getFingerprint());
Python
Menggunakan library klien Python.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container tag. try: response = tagmanager.accounts().containers().tags().create( accountId='123456', containerId='54321', body={ 'name': 'Universal Analytics Tag', 'type': 'ua', 'liveOnly': False, 'parameter': [ { 'type': 'template', 'key': 'trackingId', 'value': 'UA-123456-1' }, { 'type': 'template', 'key': 'type', 'value': 'TRACK_TRANSACTION' } ] } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the create method are stored in the response object. # The following code shows how to access the created id and fingerprint. print response.get('tagId') print response.get('fingerprint')
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons.