파트너 관리 계정 프로비저닝 – API 개발자 가이드

소개

createAccountTree은(는) Provisioning API의 일부로, 새 Google 애널리틱스 계정을 대규모로 만드는 데 사용할 수 있습니다. createAccountTicket와 달리 createAccountTree에서는 계정 생성을 완료하기 위해 최종 사용자의 상호작용이 필요하지 않으며, 프로세스가 완전히 자동화되어 있습니다. 이 기능은 고객을 대신하여 관리하는 애널리틱스 계정을 프로비저닝해야 하고 고객에게 해당 데이터의 맞춤 보기를 제공해야 할 때 유용합니다.

이 API는 사용자의 웹사이트 또는 웹 속성을 관리하는 파트너를 위해 예약되어 있습니다. 사용자가 자신의 웹사이트 또는 웹 속성을 관리하는 경우 사용자 제어 애널리틱스 계정을 만들어야 합니다.

시작하기 전에

모든 Google 애널리틱스 API는 유사한 방식으로 액세스됩니다. 프로비저닝 API를 시작하기 전에 다음 작업을 수행해야 합니다.

  • API에서 작동하는 프로그래밍 언어별 클라이언트 라이브러리의 전체 목록은 클라이언트 라이브러리 페이지를 참조하세요.
  • API 인터페이스 및 클라이언트 라이브러리 없이 데이터에 액세스하는 방법에 대해 알아보려면 참조 가이드를 읽어보세요.

각 클라이언트 라이브러리는 Provisioning API에 액세스하기 위한 단일 애널리틱스 서비스 객체를 제공합니다. 서비스 객체를 만들려면 일반적으로 다음 단계를 따라야 합니다.

  1. Google API 콘솔에 애플리케이션을 등록합니다.
  2. 새 Google 애널리틱스 계정을 만들 수 있도록 승인합니다.
  3. 애널리틱스 서비스 객체를 만듭니다.

이 단계를 완료하지 않았다면 중단하고 Hello Google Analytics API 튜토리얼을 읽어 보세요. 이 튜토리얼에서는 Google 애널리틱스 API 애플리케이션을 빌드하는 초기 단계를 안내합니다. 이 과정을 완료하면 Google 애널리틱스 API에 액세스하여 실제 작업을 수행하는 방법을 이해할 수 있습니다.

템플릿 계정

이 API의 사용 승인을 받으려면 이 API의 템플릿 계정 역할을 하는 새 Google 애널리틱스 계정을 제공해야 합니다. 새 계정을 만들면 템플릿 계정에서 서비스 약관 동의자, 조직 및 다양한 데이터 공유 설정을 비롯한 다양한 설정이 상속됩니다. 상속된 모든 데이터의 목록을 비롯하여 템플릿 계정에 대한 자세한 내용은 createAccountTree 참조를 확인하세요.

계정 프로비저닝

새 Google 애널리틱스 계정을 프로비저닝하려면 createAccountTree API 엔드포인트에 요청합니다. 다음과 같은 프로비저닝 세부정보가 필요합니다.

  • Account 필드
    • 계정의 accountName입니다.
  • 웹 속성 필드
    • 속성의 webpropertyName입니다.
    • websiteUrl - 이 애널리틱스 계정의 사용자 속성과 연결된 URL이어야 합니다.
  • View 필드
    • 뷰의 profileName
    • 뷰의 timezone

세부정보가 확인되면 API 엔드포인트에 인증된 호출을 수행합니다.

POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
    "accountName": "Analytics Account",
    "webpropertyName": "Default Property",
    "profileName": "Default View",
    "timezone": "America/Los_Angeles",
    "websiteUrl": "www.example-pet-store.com",
}

성공하면 API는 새로 만든 계정, 웹 속성, 보기의 세부정보로 응답합니다.

{
    "account": {
        "id": "999999999",
        "name": "Analytics Account",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "webproperty": {
        "id": "UA-999999999-1",
        "name": "Default Property",
        "websiteUrl": "www.example-pet-store.com",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "profile": {
        "id": "999999999",
        "name": "Default View",
        "timezone": "America/Los_Angeles",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    ...
}

계정 소유권 및 관리

생성된 Google 애널리틱스 계정은 OAuth를 통해 응답을 승인한 사용자 계정에서 소유하게 됩니다. 따라서 조직에서는 개별 사용자 계정이 아닌 서비스 계정을 사용하여 애널리틱스 계정을 관리하는 것이 좋습니다.

계정을 만든 후 Management API를 사용하여 구성할 수 있습니다. 새로 만든 계정의 일반적인 작업은 다음과 같습니다.

계정 관계 설명

모든 Google API와 마찬가지로 Google Cloud 프로젝트는 요청 승인을 위한 시작점으로 필요합니다. OAuth 2.0 문서에 설명된 대로 이 계정에서 API 요청에 대한 사용자 인증 정보를 관리합니다. 하지만 생성된 Google 애널리틱스 계정은 Cloud 프로젝트 또는 관리 계정과 어떤 식으로든 직접 연결되지 않으며, 요청을 승인한 사용자 또는 서비스 계정과만 연결됩니다. 애널리틱스 계정에 대한 계정 액세스를 구성해야 하는 경우 Management API를 사용할 수 있습니다.