DV360 Exchange Reporting API 온보딩 및 OAuth 설정

DV360 Exchange Reporting API는 서드 파티 익스체인지 (3PE) 파트너에게 Display & Video 360의 실적 보고서에 대한 프로그래매틱 액세스를 제공합니다.

DV360 Exchange Reporting API는 OAuth를 사용하는 허용 목록 기반 Google Cloud API로 노출됩니다. 허용 목록 프로세스는 DV360 Exchange Reporting API팀에서 처리합니다.

절차

DV360 Exchange Reporting API 온보딩 단계는 다음과 같습니다.

  1. Google Cloud 콘솔에서 Google 계정을 가입합니다.

    이 계정은 프로덕션 클라이언트의 액세스 토큰을 관리하는 데 사용되므로 개인 Gmail 계정을 사용하지 마세요.

  2. 계정 정보를 사용하여 Google DV360에 연락하여 허용 목록에 추가하세요.

  3. 허용 목록에 추가되었다는 알림을 받은 후 OAuth 인증 검토를 요청하여 앱이 doubleclickbidmanager 범위에 액세스할 수 있도록 합니다.

  4. Google Cloud 콘솔에 로그인합니다.

    API 및 서비스 > 라이브러리 > 비공개로 이동합니다. DV360 Exchange Reporting API가 사용 가능한 API 중 하나로 표시됩니다. DV360 Exchange Reporting API를 사용 설정합니다.

  5. 사용자 인증 정보 > 사용자 인증 정보 만들기 > 서비스 계정 키로 이동합니다. 서비스 계정 만들기 안내를 따르세요.

서비스 계정

서비스 계정을 사용하면 코드가 애플리케이션 사용자 인증 정보를 API로 직접 전송할 수 있습니다. 사용자 계정과 같은 서비스 계정은 이메일 주소로 표시됩니다. 그러나 서비스 계정은 사용자 계정과 달리 애플리케이션에만 속하며 애플리케이션 계정이 생성된 API에 액세스하는 데만 사용할 수 있습니다.

Google Cloud 콘솔을 사용하여 서비스 계정 사용자 인증 정보를 만드는 단계는 다음과 같습니다.

  1. API 관리자 > 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기→서비스 계정 키를 선택합니다.

  2. 서비스 계정 드롭다운에서 새 서비스 계정을 선택합니다.

    이 서비스 계정의 이름을 입력합니다. 이 이름은 생성된 서비스 계정 ID 주소에서 @ 왼쪽에 있는 서비스 계정 ID의 기본 이름으로 사용됩니다.

    키 유형에서 이 값을 JSON로 유지하는 것이 좋습니다. 만들기를 클릭하여 JSON 키를 .json 텍스트 파일로 생성합니다. 메시지가 표시되면 파일을 컴퓨터에 다운로드하고 서비스 계정 생성됨 대화상자가 표시됩니다.

    다음은 샘플 JSON 키입니다.

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. JSON 파일은 비공개 키를 포함하고 있으며, 이 파일이 유일한 사본이므로 안전하게 보관하세요. 코드가 API를 호출할 때 이 파일의 사용자 인증 정보가 필요합니다.

  4. 생성한 서비스 계정 정보(특히 서비스 계정의 이메일 주소)를 사용하여 DV360에 문의합니다. 이는 API 액세스 허용 목록 프로세스의 일부입니다.

액세스 토큰

서비스 계정이 API를 호출할 수 있도록 승인되면 API 가이드의 예시를 진행할 수 있습니다. 액세스 토큰을 수동으로 가져오려면 oauth2l과 같은 도구를 사용하거나 클라이언트 라이브러리 중 하나를 사용하여 프로그래매틱 방식으로 인증하세요.