승인 필요
기존 필터를 업데이트합니다. 지금 사용해 보거나 예를 참조하세요.
요청
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 |
필터링할 필드입니다. 가능한 값은
|
쓰기 가능 |
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 |
필터링할 필드입니다. 가능한 값은
|
쓰기 가능 |
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
/* * 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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요. 또는 독립형 탐색기를 사용해 보세요.