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

この機能を使用すると、API アクセスレベルを Google Cloud 組織で管理できるため、次の利点があります。

  • デベロッパー トークンの保護が不要: API アクセスは Google Cloud 組織によって管理されるため、デベロッパー トークンの保護や漏洩について心配する必要がなくなります。API 呼び出しで開発者トークンの送信をスキップすることもできますが、アクセス トークンの送信は必要です。

  • アプリごとに個別の Google API Console プロジェクトを維持する: Google Cloud 組織の下にリンクされているプロジェクトは、その組織の API アクセスレベルを継承します。これにより、この組織の下に複数の Google API Console プロジェクトを作成し、詳細なプロジェクト管理、アプリごとの個別のプロジェクト、チームメンバー用の複数の Google API Console プロジェクトの作成などを行うことができます。

  • きめ細かな割り当てのモニタリングと管理: 個々のプロジェクトの API 使用状況のモニタリングや、API 使用量の上限設定ができます。

前提条件

  • 承認済みの開発者トークン

    このオプションを使用するには、承認済みの開発者トークンが必要です。既存の開発者トークンは、Google 広告クライアント センター（MCC）アカウントの [API センター] ページで確認できます。ログインし、[ツールと設定] > [設定] > [API センター] に移動します。

  • Google Cloud 組織

    Google Ads API は、開発者トークンを Google Cloud の組織に関連付けられ、そのトークンを使用して API アクセスレベルを決定します。Google Cloud 組織を作成するには、複数の方法があります。

    シナリオ 歩数
    Google Workspace または Google Cloud Identity の既存のお客様であること すでに組織リソースを所有している可能性があります。必要に応じて、チェックして作成できます。
    Google Workspace または Google Cloud Identity を使用していない Google Cloud Identity の無料版に登録します。次に、 組織リソースを作成します。
    上記のいずれにも当てはまらない 試験運用に登録し、組織リソースの作成を Google にリクエストする際のシナリオを説明してください。Google はこの組織リソースを無料で所有、管理します。

  • パイロット プログラム用に Google API Console プロジェクトを準備する

    Google Ads API を使ってパイロット プログラムで使用する Google API Console プロジェクトは、次のように準備する必要があります。

    シナリオ 歩数
    Google Cloud 組織をすでに所有しているか、前の手順で作成した Google Cloud 組織 Google Ads API を有効にしたすべての Google API Console プロジェクトがこの組織に配置されていることを確認します。存在しない場合は、組織に移行します。

    Google Workspace または Google Cloud Identity をすでにご利用の場合は、Google API Console プロジェクトがすでに組織内にある可能性があるため、この手順をスキップできます。
    Google Cloud 組織を所有していないため、前のステップで作成できなかった Google 広告 API クライアント センター（MCC）アカウントと Google API Console プロジェクトの管理者ユーザーになっていることを確認してください。パイロット申請が承認された後、追加の手順を実行するには、この権限が必要です。

  • 最新の API 連絡先メールアドレス

    Google Ads API の連絡先メールアドレスが最新であることを確認します。API に関するお問い合わせ先は、Google 広告 API クライアント センター（MCC）アカウントの [API センター] ページでご確認いただけます。ログインし、[ツールと設定] > [設定] > [API センター] に移動します。

パイロット プログラムに登録する

パイロット プログラムに登録します。Google コンプライアンス チームが申請を審査し、API の連絡先メールアドレスに承認ステータスと詳細情報をメールで送信します。

Google に Google Cloud 組織の作成をリクエストした場合は、追加の手順があります。

  1. Google が所有する Cloud 組織リソースが自動的に作成されます。Google Ads API MCC アカウントのすべての管理者には、新しく作成された組織に対する roles/resourcemanager.projectCreator の役割が付与されます。

  2. API の連絡先メールアドレスに、新しく作成した組織リソースの詳細を記載したメールが届きます。

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

  4. メールに返信して、プロジェクトが新しい組織下に移動されたことを Google に通知します。

  5. Google コンプライアンス チームが申請を審査し、承認状況と追加情報を API の連絡先メールアドレスにメールで送信します。

API リクエストを変更する

API 呼び出しの際に developer-token ヘッダーの送信を停止するようにアプリを変更できます。このステップは省略可能ですが、実施することをおすすめします。パイロット プログラムに参加している場合、API リクエストの一部として送信された developer-token は、Google Ads API サーバーで無視されます。

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/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"

よくある質問

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 Free Edition アカウントを作成している:

    Google Cloud Identity Free Edition アカウントの登録や、この試験運用への参加を目的とした Google Cloud 組織の作成では、料金は発生しません。

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

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

ツールごとに複数の開発者トークンがあります。この試験運用による影響

このユースケースはサポートされていないため、このパイロットに参加することはできません。

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

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

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

API テクニカル サポートページを使用して Google Ads API チームにお問い合わせいただき、問題の内容をご説明ください。可能であれば、組織 ID やリクエストとレスポンスのログなどの詳細を含めてください。