인증 설정

Display &Video 360 판매자 API 온보딩

Display &Video 360 판매자 API를 온보딩하는 데는 몇 가지 주요 단계가 있습니다. DV360 판매자 API는 허용 목록 기반 Google Cloud API이며 인증 및 승인에 OAuth 2.0을 사용합니다.

허용 목록에 추가하는 절차는 Display &Video 360 판매자 API팀에서 처리합니다.

온보딩 단계:

  1. https://console.cloud.google.com/을 방문하여 Google 계정에 가입합니다.
    • 이 계정은 프로덕션 클라이언트의 액세스 토큰을 관리하는 데 사용됩니다. 개인 Gmail 계정은 사용하지 마세요.
    • 계정은 Google 그룹일 수 없습니다.
    • 기존 Google Cloud 프로젝트를 사용하는 경우: 계정은 프로젝트의 관리자여야 합니다.
  2. Google DV360팀에 계정 세부정보를 문의하여 허용 목록에 추가해 달라고 요청합니다.
  3. 계정이 사용 설정되었다는 확인을 기다립니다.
  4. 선택사항이며 차단되지 않음: https://www.googleapis.com/auth/doubleclickbidmanager 범위에 액세스하기 위해 애플리케이션의 OAuth 인증 검토 요청을 제출합니다.
  5. Google Cloud 콘솔에서 API 및 서비스 > 라이브러리 > 비공개로 이동합니다. 프로젝트에서 DV360 판매자 API 를 사용할 수 있어야 합니다.
  6. DV360 판매자 API 를 사용 설정합니다.
  7. API 및 서비스 > 사용자 인증 정보 > 사용자 인증 정보 만들기 > 서비스 계정 키 로 이동합니다. OAuth 2.0 서비스 계정 문서의 설정 안내를 따릅니다.

    서비스 계정을 설정합니다.

    참고: DV360 Reporting API에 사용되는 것과 같은 기존 서비스 계정을 재사용하려면 알려주세요.

    Google Cloud API 인증 및 승인 (일반적으로 모두 합해서 '인증'이라고 부름)은 일반적으로 서비스 계정을 사용해서 수행됩니다. 서비스 계정을 사용하면 코드가 애플리케이션 사용자 인증 정보를 직접 Cloud API에 보낼 수 있습니다. 사용자 계정과 같은 서비스 계정은 이메일 주소로 표시됩니다. 그러나 서비스 계정은 사용자 계정과 달리 애플리케이션에만 속하며 애플리케이션 계정이 생성된 API에 액세스하는 데만 사용할 수 있습니다. 예를 들어 Google Cloud Platform Console을 사용하여 서비스 계정 사용자 인증 정보를 만드는 방법을 보여 드리겠습니다.

    Google Cloud 콘솔 사용

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

    alt_text

    다음으로, '서비스 계정' 드롭다운에서 '새 서비스 계정'을 선택합니다.

    alt_text

    이 서비스 계정의 '이름'을 입력합니다. 이 이름은 생성된 서비스 계정 ID 주소에서 '@' 왼쪽에 있는 '서비스 계정 ID'의 기본 이름으로 사용되지만 원하는 경우 이 서비스 계정 ID 이름을 변경할 수 있습니다. 이 이름은 임의의 이름으로 지정할 수 있으며, 기억할 수만 있으면 됩니다. '키 유형' 아래에서는 기본값 'JSON'을 그대로 사용하는 것이 좋습니다. '만들기'를 클릭하면 GCP Console에서 JSON 키 (.json 텍스트 파일)를 생성하고, 컴퓨터에 파일을 다운로드하라는 메시지를 표시하고, 서비스 계정 생성됨 대화상자를 표시합니다.

    alt_text

    생성된 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"
}

    이 JSON 파일은 비공개 키를 포함하고 있으며, 이 파일이 유일한 사본이므로 안전하게 보관하세요. Google Cloud Platform API에 사용자 인증 정보를 보내려면 코드에서 이 서비스 계정 키 파일을 참조해야 합니다.

  8. 생성한 서비스 계정 정보 (특히 서비스 계정 이메일 주소)를 사용하여 DV360팀에 문의합니다. 이는 승인을 위한 두 번째 허용 목록 단계입니다.
  9. 서비스 계정이 API를 호출할 수 있도록 승인되면 DV360 판매자 API 문서를 참조할 수 있습니다. 인증 토큰을 수동으로 가져오려면 다운로드한 JSON 서비스 계정 키를 사용하여 oauth2l 도구 저장소의 안내를 참고하세요. 프로그래매틱 방식으로 OAuth 토큰을 가져오는 방법에 관한 자세한 안내는 Google Cloud 인증 문서에서 확인할 수 있습니다.

중요: OAuth 범위는 https://www.googleapis.com/auth/doubleclickbidmanager여야 합니다.

이전
개요
다음
클라이언트 라이브러리