Goals: patch

Cần có sự cho phép

Cập nhật mục tiêu hiện tại. Phương thức này hỗ trợ ngữ nghĩa bản vá. Thử ngay hoặc xem ví dụ.

Ngoài các thông số chuẩn, phương thức này hỗ trợ các thông số được liệt kê trong bảng thông số.

Yêu cầu

Yêu cầu HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId

Các 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 mục tiêu.
goalId string Chỉ mục của mục tiêu cần được cập nhật.
profileId string Mã chế độ xem (Hồ sơ) để cập nhật mục tiêu.
webPropertyId string Mã thuộc tính web để cập nhật mục tiêu.

Ủ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ề quy trình 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ên quản lý.mục tiêu, 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ề tài nguyên quản lý.mục tiêu 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.
 * See the Goals Developer Guide for details.
 */

/*
 * This request patches an existing Goal.
 */

// Construct the body of the request.
Goal body = new Goal();
body.setActive(false);
body.setName("My Goal");
body.setType("VISIT_TIME_ON_SITE");

// Construct the time on site details.
VisitTimeOnSiteDetails details = new VisitTimeOnSiteDetails();
details.setComparisonType("GREATER_THAN");
details.setComparisonValue((long) 500.0);

// Set the time on site details.
body.setVisitTimeOnSiteDetails(details);
try {
  analytics.management().goals().patch("123456", "UA-123456-1",
      "7654321", "1", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

1.199

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

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Goal Developer Guide for details.
 */

/**
 * This request patches an existing Goal.
 */


// Construct the time on site details.
$details = new Google_Service_Analytics_GoalVisitTimeOnSiteDetails();
$details->setComparisonType('GREATER_THAN');
$details->setComparisonValue(300.0);

try {
  // Get an existing goal.
  $goal = $analytics->management_goals->get('123456', 'UA-123456-1',
      '756321', '2');
  $goal->setVisitTimeOnSiteDetails($details);

  // Call the patch function.
  $analytics->management_goals->patch('123456', 'UA-123456-1', '756321',
      '5', $goal);
} catch (apiServiceException $e) {
  print 'There was an Analytics API service error '
      . $e->getCode() . ':' . $e->getMessage();

} catch (apiException $e) {
  print 'There was a general API error '
      . $e->getCode() . ':' . $e->getMessage();
}


Python

Dùng thư viện ứng dụng Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the Goal Developer Guide for details.

# This request patches an existing goal.
try:
  analytics.management().goals().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      goalId='2',
      body={
          'active': False,
          'name': 'My Goal',
          'type': 'VISIT_TIME_ON_SITE',
          'visitTimeOnSiteDetails': {
              'comparisonType': 'GREATER_THAN',
              'comparisonValue': 600
              }
      }
  ).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))

JavaScript

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

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Goals Developer Guide for details.
 */

/*
 * This request patches an existing goal.
 */
function patchGoal() {
  var request = gapi.client.analytics.management.goals.patch(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'goalId': '5',
      'resource': {
        'id': '2',
        'active': true,
        'name': 'My Goal',
        'type': 'VISIT_TIME_ON_SITE',
        'visitTimeOnSiteDetails': {
          'comparissonType': 'GREATER_THAN',
          'comparisonValue': 300
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

Hãy dùng thử!

Hãy 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.