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 Ads 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 プロジェクトで標準アクセス レベルが承認されている場合は、許可される使用を更新するための申請書に記入できます。利用規約を更新したり、クライアントにツールへのアクセス権を付与したりする場合は、申請書に記入してください。