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

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

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

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

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

前提条件

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

    このオプションを使用するには、承認済みの開発者トークンが必要です。既存の開発者トークンは、Google 広告クライアント センターの API センターで確認できます。ログインし、[管理] > [API センター] に移動します。API Center で、[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 Ads API を有効にしたすべての Google API Console プロジェクトがこの組織に属していることを確認します。そうでない場合は、組織に移行します。

    Google Workspace または Google Cloud Identity の既存のお客様の場合、Google API Console プロジェクトがすでに組織に含まれている可能性が高いため、この手順はスキップできます。
    Google Cloud 組織を所有しておらず、前の手順で作成できなかった Google 広告 API クライアント センター（MCC）アカウントと Google API Console プロジェクトの両方で管理者ユーザーであること。パイロット アプリケーションの承認後に追加の手順を実行するには、この権限が必要です。

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

    Google 広告 API の連絡先メールアドレスが最新の状態であることを確認します。API の連絡先情報は、Google Ads API マネージャー アカウントの API Center ページに表示されます。ログインし、[ツールと設定] > [設定] > [API センター] に移動します。

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

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

Google Cloud 組織の作成を Google にリクエストした場合は、いくつかの追加手順が必要です。

  1. Google が Google 所有の Cloud 組織リソースを作成します。Google 広告 API マネージャー アカウントのすべての管理者には、新しく作成された組織に対する roles/resourcemanager.projectCreator ロールが付与されます。

  2. 新しく作成された組織リソースの詳細が、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/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"

よくある質問

この変更により、Google Ads API を使用するには Google Workspace または Google Cloud のユーザーである必要があるのですか？

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

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

現時点では、API アクセスレベルの変更をリクエストするには、引き続き API Center を使用する必要があります。

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

いいえ、ありません。承認されると、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 Free Edition アカウントに登録したり、Google Cloud 組織を作成したりしても、料金は発生しません。

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

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

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

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

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

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

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

API テクニカル サポート ページから Google Ads API チームに連絡し、問題の性質を説明します。可能であれば、組織 ID、リクエスト ログ、レスポンス ログなどの詳細情報を含めます。