Google Ads API の各開発者トークンには、アクセスレベルと「使用許諾」が割り当てられます。アクセスレベルによって、本番環境アカウントに影響を与えられるかどうかと、1 日に実行できるオペレーションとリクエストの数が決まります。許可されている用途では、デベロッパー トークンが使用できる Google Ads API の特定の機能が指定されます。
アクセスレベル
表には、4 つの異なる開発者トークン アクセスレベルが順に記載されています。Google Ads API へのアクセス権をまだお持ちでない場合は、まず登録して、テスト アカウント アクセス レベルの開発者トークンを取得してください。アクセスレベルを上げるには、アプリで追加の手順を完了します。
| アクセスレベル | アクセス可能 | 1 日あたりのオペレーション上限1 | 申請方法 | 審査には通常どのくらいの時間がかかりますか？ |
|---|---|---|---|---|
| テスト アカウントのアクセスレベル | テスト アカウント | 15,000 オペレーション / 日 | 手順 | |
| エクスプローラ アクセスレベル | テスト アカウントと本番環境アカウント | 本番環境アカウントの場合は 2,880 オペレーション / 日 テスト アカウントの場合は 15,000 オペレーション / 日 |
手順 | |
| 基本アクセスレベル | テスト用と本番用のアカウント | テスト アカウントと本番環境アカウントの両方で 1 日あたり 15,000 件のオペレーション | 手順 | 2 営業日 |
| 標準アクセスレベル | テスト用と本番用のアカウント | テスト アカウントと本番環境アカウントの両方で、1 日あたりのオペレーション数に制限はありません。 | 手順 | 10 営業日 |
1 「1 日あたり」は、開発者トークンを使用して API リクエストが行われた 24 時間の期間に基づいています。過去 24 時間以内にアクセスレベルのリクエスト上限を超えると、アプリケーションでエラーが発生します。
テスト アカウントのアクセスレベル
Google Ads API の初回登録が完了すると、テスト アカウントのアクセスレベルを持つ開発者トークンが発行されます。つまり、この開発者トークン使って、テスト アカウントに対してのみ Google 広告 API リクエストを行うことができます。
テスト アカウントのアクセスレベルを申請する方法
Google 広告ウェブ インターフェースで Google Ads API の登録を完了すると、テスト アカウント アクセス レベルが自動的に付与されます。
エクスプローラ アクセスレベル
Google Ads API の初回登録が完了すると、場合によっては、開発者トークンが [テスト アカウント アクセスレベル] から [エクスプローラ アクセスレベル] に自動的にアップグレードされることがあります。Explorer アクセスレベルでは、開発者トークンを使用して、テスト アカウントと本番環境アカウントの両方に対して Google Ads API リクエストを行うことができます。本番環境アカウントは、実際の Google 広告を配信するアカウントです。テスト アカウントは広告を配信しません。
エクスプローラ アクセスレベルでは、開発者トークンは本番環境アカウントに対して 1 日あたり最大 2,880 件のオペレーションを実行できます。これは、ほとんどのデベロッパーが API を使い始めて基本的な自動化を構築するのに十分です。
Explorer アクセスレベルでは、次の機能へのアクセスが制限されます。これらの機能を使用する必要がある場合は、ベーシック アクセスレベルまたはスタンダード アクセスレベルを申請する必要があります。
エクスプローラ アクセスレベルの申請方法
Google 広告のウェブ インターフェースで Google Ads API の登録を完了します。登録が完了すると、Google によってデベロッパー トークンが Explorer アクセスレベルに自動的にアップグレードされる場合があります。
基本アクセスレベル
基本アクセスレベルでは、開発者トークンを使用してテスト アカウントと本番用アカウントの両方に対して Google Ads API リクエストを行うことができます。本番環境アカウントは、実際の Google 広告を配信するアカウントです。テスト アカウントは広告を配信しません。
基本アクセスレベルでは、開発者トークンで 1 日あたり最大 15,000 回のオペレーションを実行できます。ほとんどのデベロッパーにとって、この対応で十分です。
ベーシック アクセスレベルの申請方法
テスト アカウント アクセスレベルまたはエクスプローラ アクセスレベルを持つ開発者トークンをお持ちの場合は、次のようにしてベーシック アクセスレベルを申請できます。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
[アクセスレベル] が [テスト アカウント] または [エクスプローラ] になっていることを確認します。
API センターの [API Contact Email]（API の連絡先メールアドレス）が最新の状態であることを確認します。有効で定期的に確認しているメールアドレスがないと、申請手続きを完了できません。有効な Google 広告アカウントがすべて、API トークンを使用して Google 広告クライアント センター（MCC）アカウントにリンクされていることを確認します。
[アクセスレベル] の横にあるプルダウン矢印をクリックし、[基本アクセスを申請] リンクをクリックします。
標準アクセスレベル
標準アクセスレベルでは、開発者トークンを使用して、ほとんどのサービスで 1 日あたりのオペレーション数を無制限に実行できます。これには、GoogleAdsService Search や SearchStream などが含まれますが、これらに限定されません。標準アクセスレベルの制限と例外の詳細については、API 割り当てをご覧ください。
標準アクセス レベルは、大規模な企業や多数のユーザーにサービスを提供するツールなど、Google Ads API のオペレーションを無制限に必要とするデベロッパーにのみ付与されます。
標準アクセスレベルを申請する方法
基本アクセスレベルのデベロッパー トークンをお持ちの場合は、次の手順で標準アクセスレベルを申請できます。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
[アクセスレベル] が [ベーシック] であることを確認します。
API センターの [API Contact Email]（API の連絡先メールアドレス）が最新の状態であることを確認します。有効で定期的に確認しているメールアドレスがないと、申請手続きを完了できません。有効な Google 広告アカウントがすべて、API トークンを使用して Google 広告クライアント センター（MCC）アカウントにリンクされていることを確認します。
[アクセスレベル] の横にあるプルダウン矢印をクリックし、[標準アクセスを申請] リンクをクリックします。
ツールを外部ユーザーが使用する場合は、ツールのデモ用ログイン アクセスを提供できるように準備してください。ツールは、必須機能の要件に準拠している必要があります。
API の割り当てとシステム レートの上限
アクセスレベルに関係なく、すべての API オペレーションにはシステム レート制限が適用されます。これにより、一定期間（1 時間あたりのオペレーション数）に実行できるオペレーションの数が制限されます。レート制限エラーの処理方法については、エラータイプをご覧ください。
プロダクト設計の制限、プロダクト ポリシーの制限、API のパフォーマンスとレイテンシの考慮事項などの理由により、個々のサービスで追加の制限と割り当て制限が適用されることがあります。これらの制限の詳細については、API 割り当てに関するドキュメントをご覧ください。
許可されている用途
許容される使用は、ベーシック アクセスレベルと標準アクセスレベルの開発者トークンにのみ適用されます。許可される用途は、Google Ads API の使用目的に基づいて割り当てられます。これらの権限は、次の表に示すように、開発者トークンで使用できる API の機能を決定します。
| 許容される使用 | 説明 |
|---|---|
| 広告の作成 / 管理 | Google 広告のキャンペーン、広告グループ、広告、キーワードの作成と管理を行うための API のすべてのサービスへのアクセスを提供します。 |
| レポート | GoogleAdsService.Search リクエストまたは GoogleAdsService.SearchStream リクエスト、あるいは読み取り専用呼び出しのみを行います。これは、API を使用して統計情報をリクエストするデベロッパーを対象としています。 |
| キーワードと推奨事項を調査する | 開発者トークンが RecommendationService、KeywordPlanIdeaService、KeywordPlanService にアクセスできるようにします。これは、Google 広告キャンペーンの作成と管理を容易にするために提案を必要とするツールでのみ使用されます。 |
許可される使用方法を変更する方法
開発者トークンがベーシック アクセスレベルまたは標準アクセスレベルで承認されている場合は、許可される使用を更新するための申請を記入できます。許可される使用方法を更新する場合や、クライアントにツールへのアクセス権を付与する場合は、申請書に記入してください。