クラウド管理のアクセスレベル

この機能を使用すると、API アクセスレベルを Google Cloud 組織で管理できるようになり、次のようなメリットがあります。

  • デベロッパー トークンを保護する必要がなくなる: API アクセスは Google Cloud 組織を通じて管理されるため、デベロッパー トークンの保護や漏洩を心配する必要がなくなります。アクセス トークンは引き続き送信する必要がありますが、API 呼び出しで開発者トークンを送信する必要はありません。

  • アプリごとに別々の Google API Console プロジェクトを維持できる: Google Cloud 組織にリンクされているプロジェクトは、組織の API アクセスレベルを継承します。これにより、組織内に複数の Google API Console プロジェクトを作成して、プロジェクトのきめ細かい管理、アプリごとのプロジェクトの分離、チームメンバー用の複数の Google API Console プロジェクトなどの目的で使用できます。

  • 割り当てのモニタリングと管理の強化: 個々のプロジェクトの API 使用状況をモニタリング したり、API 使用量に上限を設定したりできます。

前提条件

試験運用版プログラムに登録する

登録して試験運用版プログラムに参加します。Google コンプライアンス チームが申請内容を確認し、承認状況と詳細を API の連絡先メールアドレスにメールで送信します。

Google に Google Cloud 組織の作成を依頼した場合は、次の追加の手順が必要です。

  1. Google が、Google 所有の Cloud 組織リソースを作成します。Google Ads API クライアント センター（MCC）アカウントのすべての管理者に、新しく作成された組織に対する roles/resourcemanager.projectCreator ロールが付与されます。

  2. Google から、新しく作成された組織リソースの詳細が API の連絡先メールアドレスに送信されます。

  3. Google API Console アカウントにログインし、 手順に沿って Google API Console プロジェクトを新しい組織に 移動します。

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

PHP

近日公開

Python

近日公開

Ruby

近日公開

Perl

近日公開

HTTP クライアント（REST）

HTTP リクエストで developer-token ヘッダーを省略します。

curl -i -X POST https://googleads.googleapis.com/v24/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"

よくある質問

Cloud で管理されるアクセスレベルに関するよくある質問をいくつかご紹介します。

この変更により、Google Ads API を使用するには Google Workspace または Google Cloud のお客様になる必要がありますか？

いいえ。Google Cloud 組織が必要です。これはいくつかの 方法で取得できます。この要件は、現在 Google Ads API を使用するために Google API Console プロジェクトが必要な場合と同様です。

API アクセスレベルを変更する必要があります。どうすればよいですか？

API アクセスレベルの変更をリクエストするには、当面は API センターを使用してください。

この試験運用版にオプトインする際にダウンタイムは発生しますか？

いいえ、ありません。承認されると、Google Ads API は組織レベルの API アクセスレベルを自動的に使用するようになります。

この試験運用版に参加するにはどのくらいの労力がかかりますか？

コードの変更は最小限で済みます。ほとんどのデベロッパーは、30 分以内にアプリの変更を完了できるはずです。

この試験運用版にオプトインすると料金が発生しますか？

通常、この試験運用版にオプトインしても料金は発生しません。Google Ads API は無料で提供されており、Google は Google Ads API の料金モデルを変更していません。

Google Cloud 組織を取得できるシナリオは次のとおりです。

  1. Google Workspace または Google Cloud Identity の既存のお客様:

    これらのプロダクトの通常の使用に対しては、通常どおり料金が発生します。この試験運用版に参加するために Google Cloud 組織を作成しても、料金は発生しません。

  2. Google Cloud Identity 無料版アカウントを作成した:

    Google Cloud Identity 無料版アカウントに登録する場合や、この試験運用版に参加するために Google Cloud 組織を作成する場合、料金は発生しません。

  3. Google が Cloud 組織リソースを作成した:

    これは Google が管理する内部 Cloud 組織リソースであるため、料金は発生しません。

ツールごとに複数のデベロッパー トークンがあります。この試験運用版はどのような影響がありますか？

このユースケースはサポートされていないため、この試験運用版には参加できません。

この変更は、Google Ads API を使用して管理しているアカウントに対する既存の API 認証に影響しますか？

いいえ。この変更は、Google Ads API を使用して管理している Google 広告アカウントに対する既存の API 認証には影響しません。

この試験運用版にオプトインしましたが、問題やフィードバックがあります。サポートへの連絡方法を教えてください

API テクニカル サポート ページから Google Ads API チームに連絡し、問題の内容を説明してください。可能な場合は、組織 ID、リクエスト ログ、レスポンス ログなどの詳細を含めてください。