Profile Filter Links: update

Cần có uỷ quyền

Cập nhật đường liên kết đến bộ lọc hồ sơ 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/profiles/profileId/profileFilterLinks/linkId

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 chứa đường liên kết của bộ lọc hồ sơ.
linkId string Mã của đường liên kết đến bộ lọc của hồ sơ sẽ được cập nhật.
profileId string Mã hồ sơ chứa đường liên kết bộ lọc
webPropertyId string Mã thuộc tính web chứa đường liên kết bộ lọc của hồ sơ

Ủ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 tài nguyên Đường liên kết đến bộ lọc hồ sơ với các thuộc tính sau:

Tên tài sản Giá trị Nội dung mô tả Ghi chú
Thuộc tính không bắt buộc
rank integer Thứ hạng của liên kết bộ lọc hồ sơ này so với các bộ lọc khác được liên kết với cùng một hồ sơ.

Đối với thao tác chỉ đọc (tức là liệt kê và nhận), thứ hạng luôn bắt đầu từ 1.

Đối với các thao tác ghi (tức là tạo, cập nhật hoặc xoá), bạn có thể chỉ định một giá trị nằm trong khoảng từ 0 đến 255, [0, 255]. Để chèn một đường liên kết vào cuối danh sách, đừng chỉ định thứ hạng hoặc đặt thứ hạng thành một số lớn hơn thứ hạng lớn nhất trong danh sách. Để chèn một đường liên kết vào đầu danh sách, hãy chỉ định một thứ hạng nhỏ hơn hoặc bằng 1. Đường liên kết mới sẽ chuyển tất cả bộ lọc hiện tại có thứ hạng bằng hoặc thấp hơn xuống trong danh sách. Sau khi bạn chèn/cập nhật/xoá đường liên kết, tất cả các đường liên kết của bộ lọc hồ sơ sẽ được đánh số lại bắt đầu từ 1.

 có thể ghi

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên Đường liên kết đến bộ lọc hồ sơ 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 Filters Developer Guide for details.
 */

/*
 * This request updates an existing profile filter link.
 */

// Construct the filter reference.
FilterRef filterRef = new FilterRef();
filterRef.setId("1223334444");


// Construct the body of the request.
ProfileFilterLink body = new ProfileFilterLink();
body.setFilterRef(filterRef);

try {
analytics.management().profileFilterLinks().update("123456",
    "UA-123456-1", "7654321", "11223344", 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.
# See the Filters Developer Guide for details.

# This request updates an existing profile filter link.
try:
  analytics.management().profileFilterLinks().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      linkId='11223344',
      body={
          'filterRef': {
              'id': '1223334444'
              }
      }
  ).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.