Filters: update

Cần có uỷ quyền

Cập nhật bộ lọc 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/filters/filterId

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 bộ lọc.
filterId string Mã của bộ lọc sẽ được cập nhật.

Ủ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.filter 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 bắt buộc
name string Tên của bộ lọc này. có thể ghi
type string Loại bộ lọc này. Các giá trị có thể là INCLUDE, EXCLUDE, hiển thị, HOA Chương trình, TÌM KIẾM_AND_THAY và NÂNG CAO. có thể ghi
Thuộc tính không bắt buộc
advancedDetails.caseSensitive boolean Cho biết các biểu thức lọc có phân biệt chữ hoa chữ thường hay không. có thể ghi
advancedDetails.extractA string Biểu thức cần trích xuất từ trường A. có thể ghi
advancedDetails.extractB string Biểu thức cần trích xuất từ trường B. có thể ghi
advancedDetails.fieldA string Trường A. có thể ghi
advancedDetails.fieldAIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. có thể ghi
advancedDetails.fieldARequired boolean Cho biết liệu trường A có bắt buộc phải khớp không. có thể ghi
advancedDetails.fieldB string Trường B. có thể ghi
advancedDetails.fieldBIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. có thể ghi
advancedDetails.fieldBRequired boolean Cho biết liệu trường B có bắt buộc phải khớp không. có thể ghi
advancedDetails.outputConstructor string Biểu thức dùng để tạo giá trị đầu ra. có thể ghi
advancedDetails.outputToField string Trường đầu ra. có thể ghi
advancedDetails.outputToFieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. có thể ghi
advancedDetails.overrideOutputField boolean Cho biết liệu giá trị hiện tại của trường đầu ra (nếu có) có bị biểu thức đầu ra ghi đè hay không. có thể ghi
excludeDetails.caseSensitive boolean Xác định xem bộ lọc có phân biệt chữ hoa chữ thường hay không. có thể ghi
excludeDetails.expressionValue string Giá trị biểu thức bộ lọc có thể ghi
excludeDetails.field string Trường cần lọc. Các giá trị có thể sử dụng:
  • Nội dung và lưu lượng truy cập
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • GIỚI THIỆU,
    • Cost_DATA_URI (URL mục tiêu của chiến dịch),
    • HIT_TYPE,
    • Internal_SEARCH_TERMS,
    • NỘI bộ_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Chiến dịch hoặc Nhóm quảng cáo
    • chiến dịch_SOURCE,
    • CHIẾN DỊCH_TRUNG BÌNH,
    • CHIẾN DỊCH QUẢNG CÁO_NAME hệ thống,
    • CAMPAIGN_AD_GROUP
    • chiến dịch_START
    • CHIẾN DỊCH_NỘI DUNG
    • CHIẾN DỊCH MÃ,
    • chiến dịch_REFERRAL_PATH,
  • Thương mại điện tử
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFLIATION (Lưu trữ hoặc vị trí đặt hàng),
    • ITEM_NAME thân mến!
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • SẢN PHẨM_ACTION_TYPE!
  • Đối tượng/Người dùng
    • TRÌNH DUYỆT
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • NỀN TẢNG,
    • PLATFORM_VERSION,
    • NGÔN NGỮ,
    • SCREEN_Resolve,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Trường Boolean),
    • FLASH_VERSION,
    • GEO_LEVEL (Tốc độ kết nối),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION (Tổ chức ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Vị trí
    • GEO_COUNTRY,
    • ĐỊA_KHU VỰC,
    • THÀNH_ PHỐ ĐỊA LÝ,
  • Sự kiện
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
    • khác
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Ứng dụng
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME thân mến!
    • APP_VERSION,
    • MÀN HÌNH,
    • IS_APP (Trường Boolean),
    • IS_FATAL_EXCEPTION (Trường Boolean),
    • EXCEPTION_DESCRIPTION,
  • Thiết bị di động
    • IS_MOBILE (Trường Boolean, Không dùng nữa. Sử dụng DEVICE_CATEGORY=thiết bị di động),
    • IS_TABLET (Trường Boolean, Không dùng nữa. Sử dụng DEVICE_CATEGORY=máy tính bảng),
    • THIẾT BỊ_CATEGORY,
    • MOBILE_HAS_QWERTY_KEY hiểu (Trường Boolean),
    • MOBILE_HAS_NFC_Support (Trường Boolean),
    • MOBILE_HAS_cellULAR_ĐÃ (Trường Boolean),
    • MOBILE_HAS_WIFI_Support (Trường Boolean),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Xã hội
    • MẠNG XÃ HỘI,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
 có thể ghi
excludeDetails.fieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Chỉ đặt nếu trường là CUSTOM_DIMENSION. có thể ghi
excludeDetails.matchType string Kiểu khớp cho bộ lọc này. Giá trị có thể là BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS hoặc MATCHES. Các bộ lọc GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI hoặc PAGE_HOSTNAME có thể sử dụng bất kỳ kiểu khớp nào; tất cả các bộ lọc khác phải sử dụng MATCHES. có thể ghi
includeDetails.caseSensitive boolean Xác định xem bộ lọc có phân biệt chữ hoa chữ thường hay không. có thể ghi
includeDetails.expressionValue string Giá trị biểu thức bộ lọc có thể ghi
includeDetails.field string Trường cần lọc. Các giá trị có thể sử dụng:
  • Nội dung và lưu lượng truy cập
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • GIỚI THIỆU,
    • Cost_DATA_URI (URL mục tiêu của chiến dịch),
    • HIT_TYPE,
    • Internal_SEARCH_TERMS,
    • NỘI bộ_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Chiến dịch hoặc Nhóm quảng cáo
    • chiến dịch_SOURCE,
    • CHIẾN DỊCH_TRUNG BÌNH,
    • CHIẾN DỊCH QUẢNG CÁO_NAME hệ thống,
    • CAMPAIGN_AD_GROUP
    • chiến dịch_START
    • CHIẾN DỊCH_NỘI DUNG
    • CHIẾN DỊCH MÃ,
    • chiến dịch_REFERRAL_PATH,
  • Thương mại điện tử
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFLIATION (Lưu trữ hoặc vị trí đặt hàng),
    • ITEM_NAME thân mến!
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • SẢN PHẨM_ACTION_TYPE!
  • Đối tượng/Người dùng
    • TRÌNH DUYỆT
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • NỀN TẢNG,
    • PLATFORM_VERSION,
    • NGÔN NGỮ,
    • SCREEN_Resolve,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Trường Boolean),
    • FLASH_VERSION,
    • GEO_LEVEL (Tốc độ kết nối),
    • VISITOR_TYPE,
    • GEO_ORGANIZATION (Tổ chức ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Vị trí
    • GEO_COUNTRY,
    • ĐỊA_KHU VỰC,
    • THÀNH_ PHỐ ĐỊA LÝ,
  • Sự kiện
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
    • khác
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Ứng dụng
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME thân mến!
    • APP_VERSION,
    • MÀN HÌNH,
    • IS_APP (Trường Boolean),
    • IS_FATAL_EXCEPTION (Trường Boolean),
    • EXCEPTION_DESCRIPTION,
  • Thiết bị di động
    • IS_MOBILE (Trường Boolean, Không dùng nữa. Sử dụng DEVICE_CATEGORY=thiết bị di động),
    • IS_TABLET (Trường Boolean, Không dùng nữa. Sử dụng DEVICE_CATEGORY=máy tính bảng),
    • THIẾT BỊ_CATEGORY,
    • MOBILE_HAS_QWERTY_KEY hiểu (Trường Boolean),
    • MOBILE_HAS_NFC_Support (Trường Boolean),
    • MOBILE_HAS_cellULAR_ĐÃ (Trường Boolean),
    • MOBILE_HAS_WIFI_Support (Trường Boolean),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Xã hội
    • MẠNG XÃ HỘI,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
 có thể ghi
includeDetails.fieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Chỉ đặt nếu trường là CUSTOM_DIMENSION. có thể ghi
includeDetails.matchType string Kiểu khớp cho bộ lọc này. Giá trị có thể là BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS hoặc MATCHES. Các bộ lọc GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI hoặc PAGE_HOSTNAME có thể sử dụng bất kỳ kiểu khớp nào; tất cả các bộ lọc khác phải sử dụng MATCHES. có thể ghi
lowercaseDetails.field string Trường sẽ sử dụng trong bộ lọc. có thể ghi
lowercaseDetails.fieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. có thể ghi
searchAndReplaceDetails.caseSensitive boolean Xác định xem bộ lọc có phân biệt chữ hoa chữ thường hay không. có thể ghi
searchAndReplaceDetails.field string Trường sẽ sử dụng trong bộ lọc. có thể ghi
searchAndReplaceDetails.fieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. có thể ghi
searchAndReplaceDetails.replaceString string Cụm từ để thay thế cụm từ tìm kiếm. có thể ghi
searchAndReplaceDetails.searchString string Cụm từ tìm kiếm. có thể ghi
uppercaseDetails.field string Trường sẽ sử dụng trong bộ lọc. có thể ghi
uppercaseDetails.fieldIndex integer Chỉ mục của thứ nguyên tùy chỉnh. Bắt buộc nếu trường là CUSTOM_DIMENSION. 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ênmanagement.filter 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 example updates an existing filter.
 */

// Construct the filter Expression object.
AnalyticsManagementFiltersFilterExpression details = new
    AnalyticsManagementFiltersFilterExpression();
details.setField("GEO_DOMAIN");
details.setMatchType("EQUAL");
details.setExpressionValue("example.com");
details.setCaseSensitive(false);

// Construct the body of the request.
Filter body = new Filter();
body.setName("My Domain Filter");
body.setType("EXCLUDE");
body.setExcludeDetails(details);

try {
  analytics.management().filters().update("123456", "1223334444", 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 Filters Developer Guide for details.
 */

/**
 * This request updates an existing filter.
 */
try {

  // Construct the filter expression object.
  $details = new Google_Service_Analytics_FilterExpression();
  $details->setField('GEO_DOMAIN');
  $details->setMatchType('EQUAL');
  $details->setExpressionValue('example.com');
  $details->setCaseSensitive(false);

  // Construct the filter and set the details.
  $filter = new Google_Service_Analytics_Filter();
  $filter->setName('My Domain Filter');
  $filter->setType('EXCLUDE');
  $filter->setId('7654321');
  $filter->setExcludeDetails($details);
  $analytics->management_filters->update('123456', '7654321', $filter);
} 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

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 filter.
try:
  analytics.management().filters().update(
      accountId='123456',
      filterId='1223334444',
      body={
          'name': 'My Domain Filter',
          'type': 'EXCLUDE',
          'excludeDetails': {
              'field': 'GEO_DOMAIN',
              'matchType': 'EQUAL',
              'expressionValue': 'example.com',
              'caseSensitive': False
              }
      }
  ).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 Filters Developer Guide for details.
 */

/*
 * This request updates an existing filter.
 */
function updateFilter() {
  var request = gapi.client.analytics.management.filters.update(
    {
      'accountId': '123456',
      'filterId': '1223334444',
      'resource': {
        'id': '1223334444',
        'name': 'My Domain Filter',
        'type': 'EXCLUDE',
        'excludeDetails': {
          'field': 'GEO_DOMAIN',
          'matchType': 'EQUAL',
          'expressionValue': 'example.com',
          'caseSensitive': false
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

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.