클라우드 관리 액세스 수준

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

  • 더 이상 개발자 토큰을 보호할 필요가 없음: API 액세스가 Google Cloud 조직을 통해 관리되므로 개발자 토큰 보안이나 토큰 유출에 대해 더 이상 걱정할 필요가 없습니다. API 호출에서 개발자 토큰 전송을 건너뛸 수 있지만 액세스 토큰은 계속 전송해야 합니다.

  • 앱마다 별도의 Google API 콘솔 프로젝트 유지: Google Cloud 조직 아래에 연결된 모든 프로젝트는 조직의 API 액세스 수준을 상속합니다. 이렇게 하면 세분화된 프로젝트 관리, 여러 앱을 위한 별도의 프로젝트, 팀 구성원을 위한 여러 Google API 콘솔 프로젝트 등을 위해 이 조직 아래에 여러 Google API 콘솔 프로젝트를 만들 수 있습니다.

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

기본 요건

  • 승인된 개발자 토큰

    이 옵션을 사용하려면 승인된 개발자 토큰이 이미 있어야 합니다. 기존 개발자 토큰은 Google Ads 관리자 계정의 API 센터 페이지에서 확인할 수 있습니다. 로그인한 다음 도구 및 설정 > 설정 > 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 콘솔 프로젝트를 다음과 같이 준비해야 합니다.

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

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

  • 최신 API 연락처 이메일

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

파일럿 프로그램에 가입하기

파일럿 프로그램에 가입하세요. 그러면 Google 규정 준수팀에서 신청서를 검토하고 승인 상태 및 추가 세부정보를 API 연락처 이메일 주소로 이메일로 보냅니다.

Google에 Google Cloud 조직 생성을 요청한 경우 몇 가지 추가 단계가 필요합니다.

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

  2. Google은 새로 생성된 조직 리소스의 세부정보가 포함된 API 연락처 이메일 주소로 이메일을 보냅니다.

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

  4. 이메일에 회신하여 프로젝트가 새 조직 아래로 이전되었음을 Google에 알립니다.

  5. Google 규정 준수팀에서 애플리케이션을 검토한 후 승인 상태와 추가 세부정보를 이메일로 API 연락처 이메일 주소로 보냅니다.

API 요청 수정

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

Java

출시 예정

.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.
...

2,399필리핀

출시 예정

Python

출시 예정

Ruby

출시 예정

Perl

출시 예정

HTTP 클라이언트 (REST)

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

curl -i -X POST https://googleads.googleapis.com/v16/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 액세스 수준 변경을 요청해야 합니다.

파일럿에 참여하는 데 다운타임이 발생하나요?

아니요. 없습니다. 승인되면 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 Free Edition 계정을 만든 경우:

    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, 요청 및 응답 로그와 같은 세부정보를 포함하세요.