Custom Dimensions: patch

Memerlukan otorisasi

Memperbarui dimensi kustom yang ada. Metode ini mendukung semantik patch. Coba sekarang atau lihat contohnya.

Permintaan

Permintaan HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
accountId string ID akun untuk dimensi kustom yang akan diperbarui.
customDimensionId string ID dimensi kustom untuk dimensi kustom yang akan diperbarui.
webPropertyId string ID properti web untuk dimensi kustom yang akan diperbarui.
Parameter kueri opsional

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/analytics.edit

Isi permintaan

Dalam isi permintaan, sediakan bagian resource management.customDimension yang relevan, sesuai dengan aturan semantik patch.

Respons

Jika berhasil, metode ini akan menampilkan resource management.customDimension 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 Analytics service object.
 */

/*
 * This request patches an existing custom dimension.
 */

// Construct the body of the request and set its properties.
CustomDimension body = new CustomDimension();
body.setName("Campaign Group");
body.setScope("SESSION");
body.setActive(true);

try {
  analytics.management().customDimensions()
      .patch("123456", "UA-123456-1", "ga:dimension2", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

Python

Menggunakan library klien Python.

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

# This request patches an existing custom dimension.
try:
  analytics.management().customDimensions().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customDimensionId='ga:dimension2',
      body={
          'name': 'Campaign Group',
          'scope': 'SESSION',
          'active': True
      }
  ).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))

Cobalah!

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