개요

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

인증 설정

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

  1. 아직 만들지 않았다면 API에 액세스하는 데 사용되는 사용자 인증 정보를 호스팅하는 Google Cloud 프로젝트를 만듭니다.
  2. Google Cloud Console 사용 설정된 API 페이지로 이동합니다. 이전에 만든 프로젝트를 선택합니다.

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

    1. 검색창이 있는 페이지로 이동합니다. Authorized Buyers Marketplace API를 검색합니다.
    2. 결과 페이지에서 Authorized Buyers Marketplace API를 선택합니다.
    3. 사용 설정을 클릭합니다.
  4. 탐색 메뉴에서 사용자 인증 정보를 선택합니다.
  5. +사용자 인증 정보 만들기를 클릭하고 결과로 표시되는 드롭다운 메뉴에서 서비스 계정을 선택합니다.
  6. 서비스 계정의 이름을 입력합니다. 서비스 계정 ID는 생성 시 자동으로 생성됩니다. 나중에 14단계에서 필요하므로 이 값을 기록해 둡니다. 원하는 경우 설명을 입력합니다. 만들고 계속하기를 클릭합니다.
  7. 필요한 경우 서비스 계정의 권한을 구성하고 계속을 클릭합니다.
  8. 원하는 경우 서비스 계정으로 작업을 수행할 수 있는 사용자 또는 그룹을 구성하고 완료를 클릭합니다.
  9. 새 서비스 계정이 서비스 계정에 나열됩니다. 방금 만든 서비스 계정 ID를 찾아 클릭합니다.
  10. 키 탭을 클릭합니다.
  11. 키 추가 드롭다운 메뉴에서 새 키 만들기를 선택합니다.
  12. 키 유형으로 JSON을 선택하고 만들기를 클릭합니다.
  13. 키를 작업 디렉터리에 다운로드합니다. 키를 안전하게 저장하는 방법을 자세히 알아보려면 서비스 계정 키 관리를 참고하세요. 이 키는 애플리케이션에서 API를 호출하는 데 사용됩니다.
  14. 서비스 계정을 계정과 연결하려면 서비스 계정 ID를 기술계정 관리자와 공유하세요.

API 범위

API 호출에 사용되는 액세스 토큰을 수신하기 위해 OAuth 2.0 흐름을 단계별로 진행할 때 해당 토큰을 사용하여 액세스할 수 있는 API를 지정해야 합니다. Authorized Buyers Marketplace API의 경우 범위는 https://www.googleapis.com/auth/authorized-buyers-marketplace입니다.

API와 실시간 맞춤설정에서 데이터 세그먼트를 식별하는 방법

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

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

실시간 선별에서 광고 기회와 관련된 데이터 세그먼트를 식별할 때는 API에서 사용하는 전체 리소스 name 대신 DATA_SEGMENT_ID 리소스 ID 값을 지정하세요.

다음 단계