API 액세스 설정

SDK 또는 REST를 사용하여 데이터 관리 도구 API에 대한 액세스를 설정하는 방법은 다음과 같습니다.

따를 설정 프로세스 유형을 선택합니다.

기본 요건

Data API를 사용하려면 다음이 필요합니다.

  1. Google Cloud 프로젝트
  2. Google Cloud 프로젝트에 대한 serviceusage.services.enable 권한이 있거나 해당 권한이 포함된 역할이 있는 Google 계정 예를 들어 roles/owner와 roles/serviceusage.serviceUsageAdmin 모두 serviceusage.services.enable 권한을 포함합니다. 권한을 확인하려면 현재 액세스 권한 보기를 참고하세요.
  3. Google Cloud 명령줄 인터페이스가 설치되어 있어야 합니다.

API 사용 설정

아직 사용 설정하지 않은 경우 데이터 관리 도구 API 사용 설정을 클릭하여 데이터 관리 도구 API를 사용 설정하거나 안내에 따라 이 단계를 수동으로 실행합니다.

Data Manager API 사용 설정하기

데이터 관리 도구 API를 찾을 수 없거나 데이터 관리 도구 API 사용 설정이 실패하는 경우 Google 계정이 기본 요건을 충족하는지 확인하세요.

인증 설정

API 키 외에도 Google의 인증 방법을 사용할 수 있습니다. 사용 사례에 적합한 인증 방법을 선택하는 방법을 검토하여 사용 사례에 적합한 접근 방식을 결정하는 것이 좋습니다.

일반적인 인증 방법에는 사용자 계정과 서비스 계정이 있습니다.

  • 사용자 계정: Google API 및 서비스와 직접 상호작용하는 사용자를 나타냅니다.
  • 서비스 계정: 사용자가 사람이 아닌 앱을 나타냅니다. 이를 통해 앱에서 인증 및 승인을 관리할 수 있습니다. 예를 들어 앱이 Google Cloud 리소스에 액세스해야 하는 경우입니다.

통합에서 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용하여 환경에서 사용자 인증 정보를 자동으로 찾을 수 있으므로 인증을 위해 클라이언트 코드를 변경할 필요가 없습니다.

사용자 계정 또는 서비스 계정 가장을 선택하여 ADC를 설정합니다.

사용자 계정 사용자 인증 정보로 인증하는 단계는 다음과 같습니다.

  1. 프로젝트의 Google 인증 플랫폼 설정을 구성합니다.

    1. Google Cloud 콘솔에서 브랜딩 페이지를 엽니다.

    2. 프로젝트를 선택합니다.

    3. 양식을 작성하고 만들기를 클릭합니다.

  2. 데이터 관리 도구 API 범위는 민감한 범위이므로 다음 단계가 필요합니다.

    1. 프로젝트의 데이터 액세스 설정으로 이동합니다.

    2. 범위 추가 또는 삭제를 클릭합니다.

    3. 범위 목록에서 Data Manager API 옆의 체크박스를 선택하고 업데이트를 클릭합니다.

    4. 저장을 클릭합니다.

    5. Google Cloud 콘솔에서 잠재고객으로 이동하여 게시 상태 및 사용자 유형을 업데이트합니다. 앱 잠재고객 관리에서 이러한 설정에 대해 자세히 알아보세요.

  3. OAuth2 클라이언트 만들기를 클릭하여 프로젝트에서 OAuth2 클라이언트를 만들거나 안내에 따라 데스크톱 OAuth2 클라이언트를 만듭니다. 데이터 관리 도구 API에 사용할 데스크톱 OAuth2 클라이언트가 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

    OAuth2 클라이언트 만들기를 클릭하는 경우 OAuth 클라이언트 구성 메시지가 표시되면 데스크톱 앱을 선택하여 나머지 단계에서 클라이언트를 사용할 수 있습니다.

    OAuth2 클라이언트 만들기

    마지막 단계에서 클라이언트 구성 다운로드를 클릭하고 선택한 다운로드 위치를 기록해 둡니다.

  4. 다음 명령어를 실행하여 로컬 ADC 파일을 생성합니다. 이 명령어는 API와 함께 사용하는 Google 계정에 로그인하라는 메시지가 표시되는 웹 흐름을 실행합니다.

    PATH_TO_CLIENT_JSON을 다운로드한 JSON 파일 이름으로 바꿉니다.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    데이터 관리 도구 API와 Google Ads API에 동일한 사용자 인증 정보를 사용하려면 --scopes 목록에 Google Ads API 범위를 포함하세요.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    데이터 관리 도구 API와 Display & Video 360 API에 동일한 사용자 인증 정보를 사용하려면 --scopes 목록에 Display & Video 360 API 범위를 포함하세요.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. 다음 명령어를 사용하여 사용자 인증 정보가 올바르게 설정되었는지 확인합니다. 성공하면 명령어가 콘솔에 액세스 토큰을 출력합니다.

    gcloud auth application-default print-access-token

앱의 인증 및 사용자 인증 정보에 대해 자세히 알아보려면 Google 인증 방법 및 애플리케이션 기본 사용자 인증 정보의 작동 방식을 참고하세요.

계정 액세스 설정

사용자 계정과 연결된 이메일에 Destination 액세스 권한을 부여합니다.

  • Google Ads 계정을 사용하는 경우 안내에 따라 사용자의 이메일을 Google Ads 계정 또는 상위 Google Ads 관리자 계정에 추가합니다.
  • Display & Video 360 계정을 사용하는 경우 안내에 따라 사용자 이메일을 계정에 추가합니다.
  • Google 애널리틱스 속성을 사용하는 경우 안내에 따라 사용자의 이메일을 계정에 추가합니다.

다음 단계

클라이언트 라이브러리를 설치하고 코드 샘플을 실행하여 첫 번째 Data Manager API 요청을 시도합니다.

다음
클라이언트 라이브러리 설치