Custom Dimensions: update

Cần có uỷ quyền

Cập nhật một phương diện tuỳ chỉnh hiện có. Thử ngay hoặc xem ví dụ.

Yêu cầu

Yêu cầu HTTP

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

Tham số

Tên thông số	Giá trị	Nội dung mô tả
Tham số đường dẫn
`accountId`	`string`	Mã tài khoản để phương diện tuỳ chỉnh đó cập nhật.
`customDimensionId`	`string`	Mã phương diện tuỳ chỉnh cho phương diện tuỳ chỉnh cần cập nhật.
`webPropertyId`	`string`	Mã thuộc tính web cho phương diện tuỳ chỉnh cần cập nhật.
Tham số truy vấn không bắt buộc
`ignoreCustomDataSourceLinks`	`boolean`	Buộc cập nhật và bỏ qua mọi cảnh báo liên quan đến phương diện tuỳ chỉnh đang được liên kết với một nguồn dữ liệu / tập dữ liệu tuỳ chỉnh. (Mặc định: `false`)

Ủy quyền

Yêu cầu này cần được uỷ quyền với phạm vi sau (đọc thêm về việc xác thực và uỷ quyền).

Phạm vi
`https://www.googleapis.com/auth/analytics.edit`

Nội dung yêu cầu

Trong nội dung yêu cầu, hãy cung cấp một tài nguyênmanagement.customDimension.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyênmanagement.customDimension trong nội dung phản hồi.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Sử dụng thư viện ứng dụng Java.

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

/*
 * This request updates 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()
      .update("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

Sử dụng thư viện ứng dụng Python.

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

# This request updates an existing custom dimension.
try:
  analytics.management().customDimensions().update(
      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))

Hãy dùng thử!

Sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi. Ngoài ra, hãy dùng thử Trình khám phá độc lập.