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

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

  • 開発者トークンの保護は不要: API アクセスは、 Google Cloud 組織に対して直接管理されるため、セキュリティの心配は 機密データを検出できます。次の場所で開発者トークンの送信をスキップできます: ただし、アクセス トークンを送信する必要があります。

  • アプリごとに別個の Google API Console プロジェクトを維持する: Google Cloud 組織の下でリンクされているすべてのプロジェクトが API を継承する アクセスレベルを適用します。これにより、複数の 次のような目的のためにこの組織の下に Google API Console プロジェクトを配置します。 きめ細かいプロジェクト管理、アプリごとに個別のプロジェクト、 複数の Google API Console プロジェクトを作成できます。

  • 割り当ての詳細なモニタリングと管理: API をモニタリングできます。 リソース使用量 API 使用量の上限を設定する。

前提条件

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

    この方法を使用するには、承認済みの開発者トークンが必要です。マイページ 既存の開発者トークンは、API センター Google 広告クライアント センター（MCC）アカウント。ログイン その後、[ツール&設定 >設定 >API センターをご覧ください。

  • Google Cloud 組織

    Google Ads API が開発者トークンを Google Cloud 組織に関連付けます。 それを使用して、API アクセス 。Google Cloud で Google Cloud 組織を作成します。

    シナリオ 手順
    お客様は既存の Google Workspace または Google Cloud Identity のお客様 組織リソースをすでに所有している可能性があります。Google Chat では 確認 と作成 1 つ作成できます。
    Google Workspace を利用していない または Google Cloud Identity 無料版に申し込む できます。その後、<ph type="x-smartling-placeholder"></ph> 組織リソースを作成するをご覧ください。
    上記のいずれの方法も使用できない 署名する際のシナリオを説明する 組織リソースの作成を Google にリクエストする できます。この組織リソースは Google によって所有、管理されます。 。

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

    Google Ads API で使用する Google API Console プロジェクトを準備する必要があります 次のとおりです。

    シナリオ 手順
    すでに Google Cloud 組織を所有しているか、 前のステップ 有効にしたすべての Google API Console プロジェクトが、 Google Ads API はこの組織に含まれています。そうでない場合は、 ロールを組織に割り当てる必要があります。

    すでに Google Workspace または Google Cloud Google API Console プロジェクトが Google API すでに組織に割り当てられているため、この手順を省略できます。
    Google Cloud 組織のオーナーではないため、組織を 前のステップ ご自身が Google Ads API Manager の管理者ユーザーであることをご確認ください Google API Console プロジェクトをホストしています。以下の操作を行うにはこの権限が必要です。 試験運用の申請が承認された後、追加の手順を実施してください。

  • 最新の API に関する連絡先メールアドレス

    Google Ads API の連絡先メールアドレスが最新であることを確認します。API の連絡先 詳細については、Google Ads API MCC アカウントの [API センター] ページで確認できます。 ログインして [ツール] に移動します。 および設定 >設定 >API センターをご覧ください。

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

パイロット プログラムにご登録ください。Google のコンプライアンス チームは アプリケーションを確認し、API の連絡先メールアドレスに 承認状況などの詳細情報を確認できます

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

  1. Google 所有の Cloud 組織リソースが Google によって作成されます。すべて Google Ads API MCC アカウントの管理者には、 新しく作成されたロールに対する roles/resourcemanager.projectCreator ロール できます。

  2. Google は、API の連絡先メールアドレスに、 組織リソースにのみ影響します。

  3. Google API Console アカウントにログインし、 Google API Console プロジェクトを移動する手順は以下のとおりです。 変更します。

  4. プロジェクトが できます。

  5. Google のコンプライアンス チームがアプリケーションを審査し、API をメールで送信します。 承認状況とその他の詳細情報が記載された連絡先メールアドレス。

API リクエストを変更する

次の場合に developer-token ヘッダーの送信を停止するようにアプリを変更できます。 API 呼び出しを行います。この手順は省略可能ですが、実施することをおすすめします。地域 テスト プログラムの一環として送信された場合、Google Ads 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/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"

よくある質問

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

いいえ。Google Cloud 組織が必要です。この組織は次の場所から取得できます。 できます。この要件は、Compute Engine インスタンスで Google API Console プロジェクトで、今すぐ 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 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 広告に対する既存の API 承認には影響しません。 Google Ads API を使用して管理しているアカウント。

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

Google Ads API チームに: API テクニカル サポート ページにご記入のうえ、問題の内容を説明します。含める リクエストとレスポンスのログなど、さまざまな詳細情報を 考えています