개요

Curation Partners API를 노출하는 curators.dataSegments 리소스를 사용하여 데이터 세그먼트를 만들고 관리할 수 있습니다. 통합에 사용할 수 있는 생성된 클라이언트 라이브러리가 있는 REST API입니다.

인증 설정

Google API는 인증 및 승인에 OAuth 2.0 프로토콜을 사용합니다. Curation Partners API에 액세스할 서비스 계정을 설정하는 방법은 다음과 같습니다.

  1. 아직 하지 않은 경우 API에 액세스하는 데 사용되는 사용자 인증 정보를 호스팅하는 Google Cloud 프로젝트 를 만듭니다.

  2. Google Cloud 콘솔 사용 설정된 API 페이지로 이동합니다. 이전에 만든 프로젝트를 선택합니다.

  3. 사용 설정된 API 및 서비스 목록을 검토합니다. Curation Partners API에 액세스하려면 사용 설정해야 합니다. Curation Partners API가 사용 설정되어 있지 않으면 +API 및 서비스 사용 설정 을 클릭하고 다음 안내를 따르세요.

    1. 검색창을 사용하여 Curation Partners API 를 검색합니다.
    2. 결과 페이지에서 Curation Partners API 를 선택합니다.
    3. 사용 설정 을 클릭합니다.

    Google Cloud 콘솔 검색창으로 Curation Partners API를 찾을 수 없는 알려진 문제가 있습니다. 대신 Google Cloud CLI 를 사용하여 API를 사용 설정할 수 있습니다. gcloud CLI를 설치한 후 다음 명령어를 사용하여 Curation Partners API를 사용 설정할 수 있습니다.

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. 탐색 메뉴에서 사용자 인증 정보 를 선택합니다.

  5. +사용자 인증 정보 만들기를 클릭하고 결과 드롭다운 메뉴에서 서비스 계정을 선택합니다.

  6. 서비스 계정의 이름 을 입력합니다. 서비스 계정 ID 는 생성 시 자동으로 생성됩니다. 이 값은 나중에 14단계에서 필요하므로 기록해 두세요. 원하는 경우 설명을 입력합니다. 만들기 및 계속 을 클릭합니다.

  7. 원하는 경우 서비스 계정의 권한을 구성하고 계속 을 클릭합니다.

  8. 원하는 경우 서비스 계정으로 작업을 수행할 수 있는 사용자 또는 그룹을 구성하고 완료 를 클릭합니다.

  9. 새 서비스 계정이 서비스 계정 아래에 표시됩니다. 방금 만든 서비스 계정 ID를 찾아 클릭합니다.

  10. 키 탭을 클릭합니다.

  11. 키 추가 드롭다운 메뉴에서 새 키 만들기 를 선택합니다.

  12. **키 유형** 으로 **JSON** 을 선택하고 **만들기** 를 클릭합니다.

  13. 키를 작업 디렉터리에 다운로드합니다. 키를 안전하게 보관하는 방법에 대한 자세한 내용은 서비스 계정 키 관리를 참조하세요. 키는 애플리케이션에서 API 호출을 수행하는 데 사용됩니다.

  14. 서비스 계정을 계정에 연결하려면 서비스 계정 ID를 기술계정 관리자와 공유하세요.

API 범위

API 호출에 사용되는 액세스 토큰을 수신하기 위해 OAuth 2.0 흐름을 진행할 때 해당 토큰을 사용하여 액세스할 수 있는 API를 지정해야 합니다. Curation Partners API의 경우 범위는 https://www.googleapis.com/auth/curation-partners입니다.

API와 실시간 큐레이션에서 데이터 세그먼트를 식별하는 방법

Curation Partners API에서 데이터 세그먼트는 다음과 같은 API별 리소스 이름 으로 식별됩니다.

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

실시간 큐레이션에서 광고 기회와 관련된 데이터 세그먼트를 식별할 때는 name 필드의 API에서 제공하는 전체 리소스 이름이 아닌 DATA_SEGMENT_ID 리소스 ID의 값을 지정합니다.

다음 단계