Google Ads API の各開発者トークンには、アクセスレベルと「許可されている用途」が割り当てられます。 アクセスレベル によって、本番環境アカウントに影響を与えられるかどうか、1 日に実行できるオペレーション数とリクエスト数が決まります。許可されている用途 によって、開発者トークンが使用できる Google Ads API の特定の機能が決まります。
アクセスレベル
表に、4 種類の開発者トークンのアクセスレベルを順に示します。Google Ads API へのアクセス権をまだお持ちでない場合は、まず登録して、テスト アカウント アクセスレベルの開発者トークンを取得してください。アプリケーションで追加の手順を完了すると、アクセスレベルを上げることができます。
| アクセスレベル | アクセス可能 | 1 日あたりのオペレーション数の上限1 | 申請方法 | 審査にかかる期間（目安） |
|---|---|---|---|---|
| テスト アカウント アクセスレベル | テスト アカウント | 15,000 オペレーション / 日 | 手順 | |
| エクスプローラ アクセスレベル | テスト アカウントと本番環境アカウント | 本番環境アカウント: 2,880 オペレーション / 日 テスト アカウント: 15,000 オペレーション / 日 |
手順 | |
| ベーシック アクセスレベル | テスト アカウントと本番環境アカウント | テスト アカウントと本番環境アカウントの両方: 15,000 オペレーション / 日 | 手順 | 5 営業日 |
| 標準アクセスレベル | テスト アカウントと本番環境アカウント | テスト アカウントと本番環境アカウントの両方: オペレーション数無制限 / 日 | 手順 | 10 営業日 |
1 「1 日あたり」は、開発者トークンを使用して API リクエストが行われた 24 時間の期間に基づきます。過去 24 時間以内にアクセスレベルのリクエスト上限を超えると、アプリケーションでエラーが発生します。
テスト アカウント アクセスレベル
Google Ads API の初期登録が完了すると、テスト アカウント アクセスレベルの開発者トークンが発行されます。つまり、この開発者トークン使って、テスト アカウントに対してのみ Google 広告 API リクエストを行うことができます。
テスト アカウント アクセスレベルを申請する方法
Google 広告のウェブ インターフェースで Google Ads API の登録 を完了すると、テスト アカウント アクセス レベルが自動的に付与されます。
エクスプローラ アクセスレベル
Google Ads API の初期登録が完了すると、場合によっては、開発者トークンが テスト アカウント アクセス レベルからエクスプローラ アクセスレベルに自動的にアップグレードされることがあります。 エクスプローラ アクセスレベルでは、開発者トークンを使用して、テスト アカウントと本番環境アカウントの両方に対して Google Ads API リクエストを行うことができます。本番環境アカウント とは、実際の Google 広告を配信するアカウントのことです。テスト アカウントでは広告は配信されません。
エクスプローラ アクセスレベルでは、開発者トークンを使用して、本番環境アカウントに対して 1 日あたり最大 2,880 件のオペレーションを実行できます。これは、ほとんどのデベロッパーが API を使い始めて基本的な自動化を構築するのに十分な数です。
探索ユーザー アクセスレベルでは、次の機能へのアクセスが制限されます。これらの機能を使用する必要がある場合は、ベーシックアクセスレベルまたは標準アクセスレベルを申請する必要があります。
エクスプローラ アクセスレベルを申請する方法
Google 広告のウェブ インターフェースで Google Ads API の登録を完了します。登録が完了すると、開発者トークンがエクスプローラ アクセスレベルに自動的にアップグレードされる場合があります。
ベーシック アクセスレベル
ベーシック アクセスレベルでは、開発者トークンを使用して、テスト アカウントと本番環境アカウントの両方に対して Google Ads API リクエストを行うことができます。本番環境アカウント とは、実際の Google 広告を配信するアカウントのことです。テスト アカウントでは広告は配信されません。
ベーシック アクセスレベルでは、開発者トークンを使用して、1 日あたり最大 15,000 件のオペレーションを実行できます。これは、ほとんどのデベロッパーにとって十分な数です。
ベーシック アクセスレベルを申請する方法
テスト アカウント アクセスレベルまたはエクスプローラ アクセスレベルの開発者トークンをお持ちの場合は、次の手順でベーシック アクセスレベルを申請できます。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
[アクセスレベル] が [テスト アカウント] または [エクスプローラ] であることを確認します。
API センターの [API の連絡先メールアドレス] が最新であることを確認します。有効で定期的に確認しているメールアドレスがないと、申請手続きを完了できません。有効なすべての Google 広告アカウントが、API トークンを使用して Google 広告の MCC アカウントにリンクされていることを確認します。
[アクセスレベル] の横にあるプルダウン矢印をクリックし、[ベーシック アクセスを申請] リンクをクリックします。
Google Cloud プロジェクトのブランド確認を完了する
Google Ads API は、ベーシック アクセスレベルの申請を審査する際に、開発者トークンに関連付けられている Google Cloud プロジェクトのブランド確認ステータスを使用します。 Google Cloud プロジェクトでブランド確認プロセスを完了すると、ベーシック アクセスの申請の審査プロセスを迅速に進めることができます。場合によっては、ベーシック アクセスの申請を処理するための前提条件として、Google Cloud プロジェクトでブランド確認を完了するよう求められることもあります。詳しくは、ブランド確認ガイドをご覧ください。
標準アクセスレベル
標準アクセスレベルでは、開発者トークンを使用して、ほとんどのサービスで 1 日あたり無制限のオペレーションを実行できます。これには、
GoogleAdsService Search、
SearchStreamなどが含まれます。標準アクセスレベルの上限と例外について詳しくは、API
の割り当てをご覧ください。
標準アクセスレベルは、大規模な企業や多くのユーザーにサービスを提供するツールなど、Google Ads API のオペレーションを無制限に必要とするデベロッパーにのみ付与されます。
標準アクセスレベルを申請する方法
ベーシック アクセスレベルの開発者トークンをお持ちの場合は、次の手順で標準アクセスレベルを申請できます。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
[アクセスレベル] が [ベーシック] であることを確認します。
API センターの [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 広告キャンペーンの作成と管理を容易にするための提案を必要とするツールでのみ使用されます。 |
許可されている用途を変更する方法
開発者トークンがベーシック アクセスレベルまたは 標準アクセスレベルで承認されている場合は、申請書に記入して許可されている用途を更新できます。許可されている用途を更新する場合や、クライアントにツールへのアクセス権を付与する場合は、申請書に記入してください。