클라우드 관리 액세스 수준

이 기능을 사용하면 Google Cloud 조직에서 API 액세스 수준을 관리할 수 있으므로 다음과 같은 이점이 있습니다.

  • 더 이상 개발자 토큰을 보호할 필요가 없음: API 액세스는 Google Cloud 조직을 통해 관리되므로 더 이상 개발자 토큰을 보호하거나 유출하는 것에 대해 걱정할 필요가 없습니다. API 호출에서 개발자 토큰 전송을 건너뛰어도 액세스 토큰은 전송해야 합니다.

  • 여러 앱에 대해 별도의 Google API 콘솔 프로젝트 유지: Google Cloud 조직에 연결된 모든 프로젝트는 조직의 API 액세스 수준을 상속합니다. 이렇게 하면 세부적인 프로젝트 관리, 여러 앱의 별도 프로젝트, 팀원용 여러 Google API Console 프로젝트와 같은 목적으로 이 조직 아래에 여러 Google API Console 프로젝트를 만들 수 있습니다.

  • 더 세분화된 할당량 모니터링 및 관리: 개별 프로젝트의 API 사용량을 모니터링하거나 API 사용량 한도를 설정할 수 있습니다.

기본 요건

  • 승인된 개발자 토큰

    이 옵션을 사용하려면 이미 승인된 개발자 토큰이 있어야 합니다. Google Ads 관리자 계정의 API Center에서 기존 개발자 토큰을 찾을 수 있습니다. 로그인한 다음 관리 > API 센터로 이동합니다. API Center에서 API 액세스 > 개발자 토큰으로 이동합니다.

  • Google Cloud 조직

    Google Ads API는 개발자 토큰을 Google Cloud 조직에 연결하고 이를 사용하여 API 액세스 수준을 결정합니다. Google Cloud 조직을 만드는 방법에는 여러 가지가 있습니다.

    시나리오 단계
    기존 Google Workspace 또는 Google Cloud ID 고객입니다. 이미 조직 리소스를 소유하고 있을 가능성이 높습니다. 필요한 경우 확인하고 만들 수 있습니다.
    Google Workspace 또는 Google Cloud ID를 사용하지 않는 경우 Google Cloud ID 무료 버전에 가입합니다. 그런 다음 조직 리소스를 만듭니다.
    위의 옵션 중 어느 것도 작동하지 않음 파일럿에 가입하고 Google에 조직 리소스를 만들어 달라고 요청하는 시나리오를 설명합니다. Google은 이 조직 리소스를 무료로 소유하고 관리합니다.

  • 파일럿 프로그램에 사용할 Google API 콘솔 프로젝트 준비하기

    파일럿 프로그램에 Google Ads API와 함께 사용할 Google API Console 프로젝트를 다음과 같이 준비해야 합니다.

    시나리오 단계
    이미 Google Cloud 조직을 소유하고 있거나 이전 단계에서 조직을 만들었습니다. Google Ads API를 사용 설정한 모든 Google API Console 프로젝트가 이 조직에 속하는지 확인합니다. 그렇지 않은 경우 조직 아래로 이전합니다.

    기존 Google Workspace 또는 Google Cloud ID 고객인 경우 Google API 콘솔 프로젝트가 이미 조직에 속해 있을 가능성이 높으므로 이 단계를 건너뛰어도 됩니다.
    Google Cloud 조직을 소유하지 않고 이전 단계에서 조직을 만들 수 없음 Google Ads API 관리자 계정과 Google API Console 프로젝트에서 모두 관리자 사용자인지 확인합니다. 파일럿 신청이 승인된 후 추가 단계를 수행하려면 이 권한이 필요합니다.

  • 최신 API 문의 이메일

    Google Ads API 연락처 이메일이 최신 상태인지 확인합니다. API 연락처 세부정보는 Google Ads API 관리자 계정의 API Center 페이지에 표시됩니다. 로그인한 다음 도구 및 설정 > 설정 > API Center로 이동합니다.

파일럿 프로그램 가입

파일럿 프로그램에 가입합니다. 그러면 Google 규정 준수팀에서 신청서를 검토하고 API 담당자 이메일 주소로 승인 상태와 추가 세부정보를 이메일로 전송합니다.

Google에 Google Cloud 조직을 만들어 달라고 요청한 경우 몇 가지 추가 단계가 필요합니다.

  1. Google에서 Google 소유 Cloud 조직 리소스를 만듭니다. Google Ads API 관리자 계정의 모든 관리자에게 새로 생성된 조직에 대한 roles/resourcemanager.projectCreator 역할이 부여됩니다.

  2. Google에서 새로 생성된 조직 리소스의 세부정보를 API 연락처 이메일 주소로 이메일로 전송합니다.

  3. Google API Console 계정에 로그인하고 안내에 따라 새 조직으로 Google API Console 프로젝트를 이전해야 합니다.

  4. 이메일에 답장하여 프로젝트가 새 조직으로 이동되었음을 Google에 알립니다.

  5. Google 규정 준수팀에서 신청서를 검토한 후 API 연락처 이메일 주소로 승인 상태와 추가 세부정보를 이메일로 전송합니다.

API 요청 수정

API를 호출할 때 developer-token 헤더 전송을 중지하도록 앱을 수정할 수 있습니다. 이 단계는 선택사항이지만 권장됩니다. 파일럿 프로그램에 참여하는 경우 API 요청의 일부로 전송된 developer-token는 Google Ads API 서버에서 무시됩니다.

자바

출시 예정

.NET

Google Ads API.NET 라이브러리 버전 17.1 .0 이상을 다운로드하여 설치합니다.

다음으로 다음과 같이 코드를 수정합니다.

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

출시 예정

Python

출시 예정

Ruby

출시 예정

Perl

출시 예정

HTTP 클라이언트 (REST)

HTTP 요청에서 developer-token 헤더를 생략합니다.

curl -i -X POST https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

자주 묻는 질문(FAQ)

이번 변경사항으로 인해 Google Ads API를 사용하려면 Google Workspace 또는 Google Cloud 고객이어야 하나요?

아니요. Google Cloud 조직이 있어야 하며, 다양한 방법으로 조직을 얻을 수 있습니다. 이 요구사항은 현재 Google Ads API를 사용하려면 Google API 콘솔 프로젝트가 필요한 것과 유사합니다.

API 액세스 수준을 변경해야 합니다. 어떻게 하면 될까요?

지금은 API 액세스 수준 변경을 요청하려면 계속 API Center를 사용해야 합니다.

이 파일럿에 참여할 때 다운타임이 있나요?

아니요. 없습니다. 승인되면 Google Ads API에서 조직 수준 API 액세스 수준을 자동으로 사용하기 시작합니다.

이 파일럿에 참여하는 데 얼마나 많은 노력이 필요한가요?

최소한의 코드 변경이 예상됩니다. 대부분의 개발자는 30분 이내에 앱 변경사항을 완료할 수 있어야 합니다.

이 파일럿에 참여하면 요금이 청구되나요?

일반적으로 이 파일럿에 참여해도 요금이 청구되지 않습니다. Google Ads API는 무료로 제공되며 Google은 Google Ads API 가격 책정 모델을 변경하지 않습니다.

Google Cloud 조직을 얻을 수 있는 시나리오는 다음과 같습니다.

  1. 기존 Google Workspace 또는 Google Cloud ID 고객인 경우:

    이러한 제품을 정기적으로 사용하는 경우 평소와 같이 요금이 청구됩니다. 이 파일럿에 참여하기 위해 Google Cloud 조직을 만드는 데는 요금이 청구되지 않습니다.

  2. Google Cloud ID 무료 버전 계정을 만들었습니다.

    이 파일럿에 참여하기 위해 Google Cloud ID 무료 버전 계정에 가입하거나 Google Cloud 조직을 만들 때는 요금이 청구되지 않습니다.

  3. Google에서 Cloud 조직 리소스를 만들었습니다.

    이는 Google에서 관리하는 내부 Cloud 조직 리소스이므로 요금이 청구되지 않습니다.

여러 도구에 대한 개발자 토큰이 여러 개 있습니다. 이 파일럿은 내게 어떤 영향을 미치나요?

이 사용 사례는 지원되지 않으므로 이 파일럿에 참여하실 수 없습니다.

Google Ads API를 사용하여 관리하는 계정에 대한 기존 API 승인에 영향을 미치나요?

아니요. 이 변경사항은 Google Ads API를 사용하여 관리하는 Google Ads 계정에 대한 기존 API 승인에 영향을 미치지 않습니다.

이 파일럿에 참여했는데 문제가 있거나 의견이 있습니다. 지원팀에 문의하려면 어떻게 해야 하나요?

API 기술 지원 페이지를 사용하여 Google Ads API팀에 문의하고 문제의 성격을 설명합니다. 가능하면 조직 ID, 요청 및 응답 로그와 같은 세부정보를 포함하세요.