Profile Filter Links: update

승인 필요

기존 프로필 필터 링크를 업데이트합니다. 지금 사용해 보거나 예를 참조하세요.

요청

HTTP 요청

PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId

매개변수

매개변수 이름 값 설명
경로 매개변수
accountId string 프로필 필터 링크가 속한 계정 ID입니다.
linkId string 업데이트할 프로필 필터 링크의 ID입니다.
profileId string 필터 링크가 속한 프로필 ID
webPropertyId string 프로필 필터 링크가 속한 웹 속성 ID

승인

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

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

요청 본문

요청 본문에서는 다음과 같은 속성을 사용하여 프로필 필터 링크 리소스를 제공합니다.

속성 이름 값 설명 Notes
선택 속성
rank integer 동일한 프로필에 연결된 다른 필터와 비교한 이 프로필 필터 링크의 순위입니다.

읽기 전용 (예: list 및 get) 작업의 경우 순위는 항상 1부터 시작합니다.

쓰기(즉, 만들기, 업데이트 또는 삭제) 작업의 경우 0~255([0, 255])의 값을 지정할 수 있습니다. 목록 끝에 링크를 삽입하려면 순위를 지정하지 않거나 순위를 목록에서 가장 큰 순위보다 큰 숫자로 설정하세요. 목록의 시작 부분에 대한 링크를 삽입하려면 1보다 작거나 같은 순위를 지정하세요. 새 링크를 클릭하면 목록의 순위가 같거나 낮은 모든 기존 필터가 이동됩니다. 링크가 삽입/업데이트/삭제되면 모든 프로필 필터 링크의 번호가 1부터 다시 지정됩니다.

 쓰기 가능

대응

요청에 성공할 경우 이 메서드는 응답 본문에 프로필 필터 링크 리소스를 반환합니다.

예

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

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

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))

사용해 보기

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