계정 관리

Google Analytics Management API를 사용하면 계정, 속성, 보기에 프로그래매틱 방식으로 액세스할 수 있습니다. 이 문서에서는 다양한 API 리소스를 사용하여 Google 애널리틱스 계정 설정을 구성하는 방법을 설명합니다.

소개

Google 애널리틱스 계정 설정 구성과 관련하여 Management API가 해결하는 일반적인 사용 사례는 두 가지입니다. 첫 번째는 계정, 속성, 보기의 전체 계층 구조 트리에 대한 계정 요약을 신속하게 가져올 필요가 있다는 점입니다. 두 번째는 특정한 구성을 변경하는 것입니다.

계정 요약

계정 요약 엔드포인트를 사용하면 빠른 단일 요청을 통해 승인된 사용자의 Google 애널리틱스 계정, 속성, 보기에 대한 간단한 정보를 간편하게 나열할 수 있습니다.

계정 요약은 계정 계층 구조의 색인을 만드는 데 사용할 수 있습니다. 일반적으로 Google 애널리틱스와 통합되는 애플리케이션에서는 사용자가 계정, 속성 및 보기를 선택할 수 있는 인터페이스를 제공합니다. API에 한 번만 요청하면 모든 관련 정보를 검색하여 이러한 선택기를 빌드할 수 있습니다. 쿼리 탐색기GitHub의 코드 샘플에서 예시를 확인하세요.

세부정보 및 코드 예시는 계정 요약 리소스 참조목록 메서드 참조를 확인하세요.

계정 구성

계정, 속성보기 리소스의 list 메서드를 사용하는 계정 요약과 달리 API는 각 리소스의 전체 세부정보를 반환합니다.

계정

모든 하위 수준의 API 요청에는 계정 ID가 필요하므로 최상위 항목 계정이 중요합니다. 관리 API는 계정에 대해 나열 작업만 허용합니다. API 응답에서 주목할 부분은 모든 하위 웹 속성에 대한 API 요청을 제공하는 childlink 속성입니다.

속성

웹 속성이라고도 하며, 두 번째 수준의 항목은 모든 데이터 수집이 이 수준에서 발생하므로 중요합니다. 예를 들어 웹사이트 또는 모바일 애플리케이션에 추적 코드를 추가할 때는 UA-XXXXX-Y와 같은 ID를 포함해야 합니다. 이 ID를 속성 ID 또는 추적 ID라고 하며 Google 애널리틱스 계정 데이터가 저장되는 항목을 구분합니다. API를 사용하여 속성을 만들거나 업데이트할 수 있습니다. 자세한 내용과 코드 예는 속성 리소스를 참고하세요.

계정 계층 구조의 세 번째 수준인 보기 (프로필)는 보고가 이루어지는 수준이므로 보기가 중요합니다. Core Reporting API보기 (프로필) ID를 핵심 매개변수로 사용하여 데이터를 검색할 보기를 지정합니다. 보고서 수준일 뿐만 아니라 목표, 실험, 샘플링되지 않은 보고서, 필터 링크 등 다른 많은 리소스가 연결되거나 이 리소스의 하위 요소입니다. API를 사용하여 보기를 만들거나 업데이트할 수 있습니다. 세부정보 및 코드 예는 보기 (프로필) 리소스를 참고하세요.

다음 단계

이 가이드를 읽고 나면 Management API를 이용해 다양한 계정 구성 요소를 순회하고 조작하는 방법을 잘 이해할 수 있을 것입니다. 다음 가이드에서는 API를 사용하여 사용자 관리를 실행하는 방법을 설명합니다.