Filters: update

승인 필요

기존 필터를 업데이트합니다. 지금 사용해 보기 또는 예시를 확인하세요.

요청

HTTP 요청

PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/filters/filterId

매개변수

매개변수 이름 설명
경로 매개변수
accountId string 필터가 속한 계정 ID입니다.
filterId string 업데이트할 필터의 ID입니다.

승인

이 요청을 처리하려면 다음 범위의 승인을 받아야 합니다 (인증 및 승인 자세히 알아보기).

범위
https://www.googleapis.com/auth/analytics.edit

요청 본문

요청 본문에 다음과 같은 속성이 있는 management.filter 리소스를 제공합니다.

속성 이름 설명 Notes
필수 속성
name string 이 필터의 이름입니다. 쓰기 가능
type string 이 필터의 유형입니다. 가능한 값은 INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE, ADVANCED입니다. 쓰기 가능
선택적 속성
advancedDetails.caseSensitive boolean 필터 표현식이 대소문자를 구분하는지 여부를 나타냅니다. 쓰기 가능
advancedDetails.extractA string 필드 A에서 추출할 표현식입니다. 쓰기 가능
advancedDetails.extractB string 필드 B에서 추출할 표현식입니다. 쓰기 가능
advancedDetails.fieldA string 입력란 A 쓰기 가능
advancedDetails.fieldAIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능
advancedDetails.fieldARequired boolean 필드 A가 일치해야 하는지 여부를 나타냅니다. 쓰기 가능
advancedDetails.fieldB string 입력란 B 쓰기 가능
advancedDetails.fieldBIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능
advancedDetails.fieldBRequired boolean 필드 B가 일치해야 하는지 여부를 나타냅니다. 쓰기 가능
advancedDetails.outputConstructor string 출력 값을 구성하는 데 사용되는 표현식입니다. 쓰기 가능
advancedDetails.outputToField string 출력 필드 쓰기 가능
advancedDetails.outputToFieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능
advancedDetails.overrideOutputField boolean 출력 필드의 기존 값(있는 경우)을 출력 표현식으로 재정의해야 하는지 여부를 나타냅니다. 쓰기 가능
excludeDetails.caseSensitive boolean 필터가 대소문자를 구분하는지 확인합니다. 쓰기 가능
excludeDetails.expressionValue string 필터 표현식 값 쓰기 가능
excludeDetails.field string 필터링할 필드입니다. 가능한 값은
    입니다.
  • 콘텐츠 및 트래픽
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • 추천,
    • COST_DATA_URI (캠페인 타겟 URL),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • 캠페인 또는 광고그룹
    • CAMPAIGN_SOURCE
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • 전자상거래
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (매장 또는 주문 위치)
    • ITEM_NAME
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE
    • PRODUCT_ACTION_TYPE,
  • 잠재고객/사용자
    • 브라우저,
    • BROWSER_VERSION,
    • BROWSER_SIZE
    • 플랫폼,
    • PLATFORM_VERSION
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (부울 필드),
    • FLASH_VERSION,
    • GEO_SPEED (연결 속도),
    • VISITOR_TYPE,
    • GEO_Organization (ISP 조직),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • 위치
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • 이벤트
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • 기타
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • 애플리케이션
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • 화면,
    • IS_APP (부울 필드),
    • IS_FATAL_EXCEPTION (부울 필드),
    • EXCEPTION_DESCRIPTION,
  • 휴대기기
    • IS_MOBILE (부울 필드, 지원 중단됨. DEVICE_CATEGORY=mobile 사용),
    • IS_TABLET (부울 필드, 지원 중단됨. DEVICE_CATEGORY=태블릿 사용),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (부울 필드),
    • MOBILE_HAS_NFC_SUPPORT (부울 필드),
    • MOBILE_HAS_CELLULAR_RADIO (부울 필드),
    • MOBILE_HAS_WIFI_SUPPORT (부울 필드),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • 소셜
    • SOCIAL_NETWORK
    • SOCIAL_ACTION
    • SOCIAL_ACTION_TARGET,
쓰기 가능
excludeDetails.fieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우에만 설정합니다. 쓰기 가능
excludeDetails.matchType string 이 필터에 대한 검색 유형입니다. 가능한 값은 BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, MATCHES입니다. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI 또는 PAGE_HOSTNAME 필터에서는 모든 검색 유형을 사용할 수 있습니다. 다른 모든 필터는 MATCHES을 사용해야 합니다. 쓰기 가능
includeDetails.caseSensitive boolean 필터가 대소문자를 구분하는지 확인합니다. 쓰기 가능
includeDetails.expressionValue string 필터 표현식 값 쓰기 가능
includeDetails.field string 필터링할 필드입니다. 가능한 값은
    입니다.
  • 콘텐츠 및 트래픽
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • 추천,
    • COST_DATA_URI (캠페인 타겟 URL),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • 캠페인 또는 광고그룹
    • CAMPAIGN_SOURCE
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • 전자상거래
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (매장 또는 주문 위치)
    • ITEM_NAME
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE
    • PRODUCT_ACTION_TYPE,
  • 잠재고객/사용자
    • 브라우저,
    • BROWSER_VERSION,
    • BROWSER_SIZE
    • 플랫폼,
    • PLATFORM_VERSION
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (부울 필드),
    • FLASH_VERSION,
    • GEO_SPEED (연결 속도),
    • VISITOR_TYPE,
    • GEO_Organization (ISP 조직),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • 위치
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • 이벤트
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • 기타
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • 애플리케이션
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • 화면,
    • IS_APP (부울 필드),
    • IS_FATAL_EXCEPTION (부울 필드),
    • EXCEPTION_DESCRIPTION,
  • 휴대기기
    • IS_MOBILE (부울 필드, 지원 중단됨. DEVICE_CATEGORY=mobile 사용),
    • IS_TABLET (부울 필드, 지원 중단됨. DEVICE_CATEGORY=태블릿 사용),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (부울 필드),
    • MOBILE_HAS_NFC_SUPPORT (부울 필드),
    • MOBILE_HAS_CELLULAR_RADIO (부울 필드),
    • MOBILE_HAS_WIFI_SUPPORT (부울 필드),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • 소셜
    • SOCIAL_NETWORK
    • SOCIAL_ACTION
    • SOCIAL_ACTION_TARGET,
쓰기 가능
includeDetails.fieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우에만 설정합니다. 쓰기 가능
includeDetails.matchType string 이 필터에 대한 검색 유형입니다. 가능한 값은 BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, MATCHES입니다. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI 또는 PAGE_HOSTNAME 필터에서는 모든 검색 유형을 사용할 수 있습니다. 다른 모든 필터는 MATCHES을 사용해야 합니다. 쓰기 가능
lowercaseDetails.field string 필터에 사용할 필드입니다. 쓰기 가능
lowercaseDetails.fieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능
searchAndReplaceDetails.caseSensitive boolean 필터가 대소문자를 구분하는지 확인합니다. 쓰기 가능
searchAndReplaceDetails.field string 필터에 사용할 필드입니다. 쓰기 가능
searchAndReplaceDetails.fieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능
searchAndReplaceDetails.replaceString string 검색어를 대체할 용어입니다. 쓰기 가능
searchAndReplaceDetails.searchString string 검색할 용어입니다. 쓰기 가능
uppercaseDetails.field string 필터에 사용할 필드입니다. 쓰기 가능
uppercaseDetails.fieldIndex integer 맞춤 측정기준의 색인입니다. 필드가 CUSTOM_DIMENSION인 경우 필수입니다. 쓰기 가능

응답

요청에 성공할 경우 이 메서드는 응답 본문에 management.filter 리소스를 반환합니다.

참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.

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());
}

2,399필리핀

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

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

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. });
}

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요. 또는 독립형 탐색기를 사용해 보세요.