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