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