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

この機能を使用すると、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 センター] に移動します。API Center で、[API Access] > [Developer token] に移動します。

  • 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 コンソール プロジェクトはすでに組織に属している可能性が高いため、この手順をスキップできます。
    Google Cloud 組織を所有しておらず、前の手順で作成できなかった Google 広告 API クライアント センター（MCC）アカウントと Google API Console プロジェクトの両方で管理者ユーザーであることを確認します。この権限は、トライアル アプリケーションが承認された後に、追加の手順を行うために必要です。

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

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

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

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

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

  1. Google が、Google 所有の Cloud 組織リソースを作成します。Google 広告 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/v21/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 広告 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 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、リクエストとレスポンスのログなどの詳細を含めてください。