클라우드 관리 액세스 수준

이 기능을 사용하면 API 액세스 수준을 Google Cloud 조직의 API를 사용하여 다음과 같은 이점을 제공합니다.

  • 더 이상 개발자 토큰에 보안을 설정할 필요가 없음: API 액세스는 Google Cloud의 보안이나 보안에 대해 더 이상 걱정할 필요가 없으며 유출을 일으킬 수 있습니다. 다음에서 개발자 토큰 전송을 건너뛸 수 있습니다. 여전히 액세스 토큰을 전송해야 합니다.

  • 앱마다 별도의 Google API 콘솔 프로젝트 유지: Google Cloud 조직에 연결된 모든 프로젝트는 API를 상속합니다. 조직의 액세스 수준입니다. 이렇게 하면 여러 개의 다음과 같은 목적으로 이 조직에 속한 Google API 콘솔 프로젝트 세부적인 프로젝트 관리, 앱별로 프로젝트 분리, 및 여러 개의 Google API 콘솔 프로젝트를 사용할 수 있습니다.

  • 세분화된 할당량 모니터링 및 관리: API를 모니터링할 수 있습니다. 개별 프로젝트의 사용량 또는 API 사용량 한도

기본 요건

  • 승인된 개발자 토큰

    이 옵션을 사용하려면 승인된 개발자 토큰이 있어야 합니다. 나 기존 개발자 토큰은 API 센터 페이지에서 찾을 수 있습니다. Google Ads 관리자 계정 로그인하세요. 그런 다음 도구 및 설정 > 설정 > 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 API 콘솔 프로젝트가 Google Ads 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 규정 준수팀에서는 신청서를 검토하고 승인 상태 및 추가 세부정보

Google에 Google Cloud 조직을 만들어 달라고 요청한 경우 다음과 같은 몇 가지 추가 단계를 거쳐야 합니다.

  1. Google에서 Google 소유 Cloud 조직 리소스를 생성합니다. 전체 Google Ads API 관리자 계정의 관리자에게 새로 만든 대상의 roles/resourcemanager.projectCreator 역할 되었습니다.

  2. Google은 API 연락처 이메일 주소로 새로 생성된 조직 리소스에 대한 액세스 권한을 제공합니다

  3. Google API 콘솔 계정에 로그인하고 Google API 콘솔 프로젝트 이전 방법을 새 조직을 만들 수 있습니다

  4. 이메일에 답장하여 프로젝트가 사용할 수 있습니다

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

API 요청 수정

다음과 같은 경우 developer-token 헤더 전송을 중지하도록 앱을 수정할 수 있습니다. API 호출하기 이 단계는 선택사항이지만 권장되는 단계입니다. developer-token를 전송하는 경우 Google Ads API 서버에서 이를 무시합니다. 확인할 수 있습니다

자바

출시 예정

.NET

Google Ads API .NET 버전 17.1.0 이상을 다운로드하여 설치합니다. 라이브러리를 사용하여 v3 지도에 통합할 수 있습니다.

그런 다음 코드를 다음과 같이 수정합니다.

// 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/v17/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 Workspace 또는 Google Cloud 고객만 Google Ads API를 사용할 수 있나요?

아니요. Google Cloud 조직은 다양한 제공합니다. 이 요구사항은 지금 바로 Google Ads 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팀에 문의하기 페이지를 열고 문제의 성격을 설명합니다. 포함 요청 및 응답 로그와 같은 세부 정보를 있습니다.