Halaman ini diterjemahkan oleh Cloud Translation API.

Variables: update

Memerlukan otorisasi

Memperbarui variabel GTM. Coba sekarang atau lihat contohnya.

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/variables/variableId

Parameter

Nama parameter	Nilai	Deskripsi
Parameter jalur
`accountId`	`string`	ID Akun GTM.
`containerId`	`string`	ID Penampung GTM.
`variableId`	`string`	ID Variabel GTM.
Parameter kueri opsional
`fingerprint`	`string`	Jika diberikan, sidik jari ini harus cocok dengan sidik jari variabel dalam 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, masukkan Resource variabel dengan properti berikut:

Nama properti	Nilai	Deskripsi	Catatan
Properti yang Diperlukan
`name`	`string`	Nama tampilan variabel.	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
`type`	`string`	Jenis Variabel GTM.	dapat ditulis
Properti Opsional
`disablingTriggerId[]`	`list`	Khusus untuk penampung seluler: Daftar ID pemicu untuk menonaktifkan variabel bersyarat; variabel diaktifkan jika salah satu pemicu pengaktifan bernilai benar sedangkan semua pemicu penonaktifan bernilai salah. Dianggap sebagai kumpulan yang tidak berurutan.	dapat ditulis
`enablingTriggerId[]`	`list`	Khusus untuk penampung seluler: Daftar ID pemicu untuk mengaktifkan variabel bersyarat; variabel diaktifkan jika salah satu pemicu pengaktifan bernilai benar sedangkan semua pemicu penonaktifan bernilai salah. Dianggap sebagai kumpulan yang tidak berurutan.	dapat ditulis
`notes`	`string`	Catatan pengguna tentang cara menerapkan variabel ini di penampung.	dapat ditulis
`parameter[]`	`list`	Parameter variabel.	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
`scheduleEndMs`	`long`	Stempel waktu akhir dalam milidetik untuk menjadwalkan variabel.	dapat ditulis
`scheduleStartMs`	`long`	Stempel waktu mulai dalam milidetik untuk menjadwalkan variabel.	dapat ditulis

Respons

Jika berhasil, metode ini akan menampilkan Resource variabel 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 variable for the authorized user.
 */

// Create the variable object.
Variable variable = new Variable();
variable.setName("RandomNumber");
variable.setType("r"); // The random number type.

try {
  Variable response = tagmanager.accounts().containers().
      variables().update("12345", "54321", "2", variable).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 variable.
try:
  response = tagmanager.accounts().containers().variables().update(
      accountId='123456',
      containerId='54321',
      variableId='4',
      body={
          'name': 'updated_random_number',
          'type': 'r'
      }
  ).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.