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

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

アクセスレベル

表には、3 種類のアクセス権がレベル順にリストされています。Google Ads API にアクセスしたことがない場合は、まず登録してテストアカウントへのアクセス権を取得してください。アプリで追加の手順を完了すると、アクセスレベルを上げることができます。

アクセスレベル	アクセスできる項目	1 日あたりのオペレーションの上限¹	適用
アカウントへのアクセスをテストする	テストアカウント	15,000 オペレーション / 日	手順
ベーシックアクセス	テストアカウントと本番環境アカウント	15,000 オペレーション / 日	手順
標準アクセス	テストアカウントと本番環境アカウント	1 日あたりのオペレーション数: 無制限	手順

¹ 「1 日あたり」は、開発者トークンを使用して API リクエストが行われた 24 時間のスライド期間に基づいています。過去 24 時間以内にアクセスレベルのリクエスト上限を超えると、アプリケーションにエラーが返されます。

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

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

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

Google 広告のウェブインターフェースで Google Ads API の登録を完了すると、テストアカウントのアクセスレベルが自動的に付与されます。

ベーシックアクセス

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

基本アクセス権レベルでは、開発者トークンで 1 日あたり最大 15,000 件のオペレーションを実行できます。ほとんどのデベロッパーにとって、この方法で十分です。

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

テストアカウントのアクセスレベルの開発者トークンをお持ちで、本番環境アカウントへのアクセス権を申請する場合は、ベーシックアクセス申請フォームにご記入ください。以下の手順が完了していることを確認してください。

テストアカウントのアクセスレベルを持つデベロッパートークンがすでにあることを確認します。
API センターの [API 連絡先メールアドレス] が最新の状態であることを確認します。API センターを表示するには、MCC アカウントにログインする必要があります。有効で定期的に確認されるメールアドレスがないと、申請プロセスを完了できません。有効なすべての Google 広告アカウントが、API トークンを使用して MCC アカウントにリンクされていることを確認します。

標準権限

標準アクセスでは、デベロッパートークンを使用して、ほとんどのサービスで 1 日に無制限のオペレーションを実行できます。これには、GoogleAdsService Search や SearchStream が含まれますが、これらに限定されません。標準アクセスの上限と例外について詳しくは、API の割り当てをご覧ください。

標準のアクセスレベルは、大企業や多くのユーザーにサービスを提供するツールなど、Google Ads API の無制限の操作を必要とするデベロッパーにのみ付与されます。

アクセスレベルに関係なく、すべての API オペレーションにはシステムのレート制限が適用されます。レート制限エラーの処理方法の詳細については、エラーの種類をご覧ください。

標準アクセスに申し込む

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

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

許可されている用途

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

許容される使用	説明
広告の作成 / 管理	Google 広告のキャンペーン、広告グループ、広告、キーワードを作成、管理するための API のすべてのサービスへのアクセス権を付与します。
レポート	`GoogleAdsService.Search` リクエストまたは `GoogleAdsService.SearchStream` リクエスト、または読み取り専用呼び出しのみを行います。これは、API を使用して統計情報をリクエストするだけのデベロッパーを対象としています。
キーワードと推奨事項の調査	トークンに RecommendationService、KeywordPlanIdeaService、KeywordPlanService へのアクセスを許可します。これは、Google 広告キャンペーンの作成と管理を容易にするために候補を必要とするツールでのみ使用されます。

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

基本アクセス権または標準アクセス権が承認されている場合は、許可された使用を更新するための申請フォームに記入できます。許可される使用方法を更新する場合や、クライアントにツールへのアクセス権を付与する場合は、申請フォームに記入してください。

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