アクセスレベルと許容される用途

各 Google 広告 API 開発者トークンには、アクセス権と「許可されている用途」が割り当てられています。アクセスレベルによって、本番環境のアカウントに影響を及ぼすことができるかどうかと、1 日に実行できるオペレーションとリクエストの数が決まります。「許可される用途」は、開発者トークンの使用を許可する Google Ads API の機能を決定します。

アクセスレベル

表には、3 種類のアクセス権がレベル順にリストされています。Google 広告 API のアクセス権がない場合は、まずはテスト アカウントへのアクセス権を取得するようお申し込みください。追加の申請手順を行うことで、アクセスレベルを増やすことができます。

アクセスレベル アクセスできるデータ 1 日あたりのオペレーション上限1 get2 オペレーションに対する 1 日あたりの上限 適用
テスト アカウントのアクセス権 テスト アカウント 15,000 オペレーション / 日 1,000 リクエスト / 日 手順
基本アクセス テスト アカウントと本番環境アカウント 15,000 オペレーション / 日 1,000 リクエスト / 日 手順
標準権限 テスト アカウントと本番環境アカウント 無制限のオペレーション / 日 1,000 リクエスト / 日 手順

1「1 日」: 開発者トークンで API リクエストを 24 時間スライドする期間です。過去 24 時間以内にアクセスレベルのリクエスト制限を超えると、アプリケーションはエラーを受け取ります。

2 get は v10 でサービスを終了します。代わりに search または searchStream を使用してオブジェクトを取得します。

テスト アカウントのアクセス権

Google Ads API への最初の登録を完了すると、テスト アカウントのアクセスレベルを持つ開発者トークンが発行されます。つまり、この開発者トークン使って、テスト アカウントに対してのみ Google 広告 API リクエストを行うことができます。

テスト アカウントへのアクセス権の申し込み

Google 広告の管理画面で Google Ads API のお申し込みを完了すると、テスト アカウントのアクセス権が自動的に付与されます。

基本アクセス権

ベーシック アクセスにより、開発者トークンはテスト アカウントと本番用アカウントの両方に対して Google 広告 API リクエストを行うことができます。本番用アカウントは、実際の Google 広告を配信するアカウントです(テスト アカウントで広告は配信されません)。

基本アクセスレベルでは、開発者トークンは 1 日あたり最大 15,000 件のリクエスト、1 日あたり 1,000 件の get オペレーションを実行できます。ほとんどの場合、これで事足ります。

ベーシック アクセスを申し込む

現在、テスト アカウントのアクセスレベルの開発者トークンを使用していて、本番環境のアカウントへのアクセスを申し込む場合は、ベーシック アクセスの申請フォームに記入してください。お申し込み前に、以下の点をご確認ください。

  1. テスト アカウントのアクセスレベルを持つ開発者トークンがすでに存在することを確認します。
  2. API センターの [API の連絡先メールアドレス] が最新であることを確認します。申請プロセスを完了するには、有効な定期メール(デベロッパーの連絡先メール)が必要です。有効なすべての Google 広告アカウントを API トークンのクライアント センター(MCC)アカウントにリンクします。

標準権限

標準アクセス権では、開発者トークンでほとんどのサービスに対して 1 日あたり回数無制限のオペレーションを実行できます。これには、GoogleAdsServiceSearchSearchStream が含まれます(ただしこれらに限定されません)。制限と例外の詳細については、API 割り当てのページをご覧ください。

標準アクセス トークンには、引き続き 1 日あたりの get オペレーションの上限(1,000 回)が適用されます。標準権限は、Google 広告 API を無制限に利用する必要があるデベロッパー(通常は多くのユーザーにサービスを提供する大企業やツール)にのみ付与されます。

標準アクセスに申し込む

現在、ベイシック アクセス権があり、無制限の Google 広告 API オペレーションが必要な場合は、標準アクセスにお申し込みください。

使用するツールが外部の場合は、ツールにデモログイン アクセスを許可してください。ツールは、必須機能の要件に準拠している必要があります。

許可されている用途

許容される使用は、基本アクセス トークンと標準アクセス トークンにのみ適用されます。許可される用途は、Google Ads API の意図された用途に基づいて割り当てられます。これらの権限により、下の表に示すように、トークンを使用できる API の機能が決まります。

以下は、「許容される用途」のリストです。

許可される用途 説明
広告の作成と管理 Google 広告のキャンペーン、広告グループ、広告、キーワードを作成し、管理するための API のすべてのサービスにアクセスできます。
レポート GoogleAdsService.Search リクエストまたは GoogleAdsService.SearchStream リクエスト(または読み取り専用呼び出し)のみを作成します。これは、API のみを使用して統計情報をリクエストするデベロッパーを対象としています。
キーワードと最適化案の調査 トークンが RecommendationService、KeywordPlanIdeaService、KeywordPlanService にアクセスできるようにします。これは、Google 広告キャンペーンの作成と管理を容易にするための提案が必要なツールでのみ使用されます。

「許可されている用途」を変更する

ベイシック アクセスまたは標準アクセスのいずれかが承認されている場合は、「許可されている用途」を更新するためにお申し込みいただけます。許容される用途を更新する場合、またはクライアントにツールへのアクセス権を付与する場合は、アプリケーションに入力します。