Halaman ini diterjemahkan oleh Cloud Translation API.

Tags: update

Memerlukan otorisasi

Memperbarui tag GTM. Coba sekarang atau lihat contohnya.

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId

Parameter

Nama parameter	Nilai	Deskripsi
Parameter jalur
`accountId`	`string`	ID Akun GTM.
`containerId`	`string`	ID Penampung GTM.
`tagId`	`string`	ID Tag GTM.
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 (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: `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
`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 Nilai yang dapat diterima: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	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
`type`	`string`	Jenis Tag GTM.	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 updates an existing tag for the authorized user.
 */

// 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.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().
      containers().tags().update("123456", "54321", "1", tag).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Menggunakan library klien Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing new container tag.
try:
  response = tagmanager.accounts().containers().tags().update(
      accountId='123456',
      containerId='54321',
      tagId='1',
      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 update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Cobalah!

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