Custom Metrics: patch

Cần có uỷ quyền

Cập nhật một chỉ số tuỳ chỉnh hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá. Thử ngay hoặc xem ví dụ.

Yêu cầu

Yêu cầu HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId

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 để cập nhật chỉ số tuỳ chỉnh.
`customMetricId`	`string`	Mã chỉ số tuỳ chỉnh cho chỉ số tuỳ chỉnh cần cập nhật.
`webPropertyId`	`string`	Mã thuộc tính web cho chỉ số tùy 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 việc chỉ số 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 các phần có liên quan của tài nguyênmanagement.customMetric, theo quy tắc về ngữ nghĩa của bản vá.

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.customMetric 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 patches an existing custom metric.
 */

// Construct the body of the request and set its properties.
CustomMetric body = new CustomMetric();
body.setName("Level Completions");
body.setScope("HIT");
body.setType("INTEGER");
body.setActive(true);

try {
  analytics.management().customMetrics()
      .patch("123456", "UA-123456-1", "ga:metric2", 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 patches an existing custom metric.
try:
  analytics.management().customMetrics().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customMetricId='ga:metric2',
      body={
          'name': 'Level Completions',
          'scope': 'HIT',
          'type': 'INTEGER',
          '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.