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 広告 API リクエストを送信できるのはテスト アカウントに対してのみです。
テストアクセスを申請する
Google Cloud プロジェクトで Google Ads API を有効にすると、プロジェクトのテストアクセスが自動的に付与されます。
エクスプローラのアクセスレベル
Google Ads API の初期登録が完了すると、Google からエクスプローラ アクセスレベルの申請を求められることがあります。
エクスプローラ アクセスレベルでは、Google Cloud プロジェクトでテスト アカウントと本番環境アカウントの両方に対して Google Ads API リクエストを行うことができます。本番環境アカウントは、実際の Google 広告を配信するアカウントです。テスト用アカウントでは広告は配信されません。
エクスプローラ アクセスレベルでは、Google Cloud プロジェクトは本番環境アカウントに対して 1 日あたり最大 2,880 回のオペレーションを実行できます。これは、ほとんどの開発者が API を使用して基本的な自動化を構築するのに十分です。
Explorer アクセスレベルでは、次の機能へのアクセスが制限されます。これらの機能を使用する必要がある場合は、ベーシック アクセスレベルまたは標準アクセスレベルを申請する必要があります。
エクスプローラ アクセスレベルを申請する
- Google Cloud プロジェクトの Google Ads API の概要ページに移動します。
- ページに現在のアクセスレベルが [テスト] と表示されていることを確認します。
- [アクセスレベルをアップグレード] セクションをクリックして開きます。
- [次のアクセスレベル] が [エクスプローラ] と表示されていることを確認します。
- [アクセスを申請] ボタンをクリックして、エクスプローラ アクセスレベルを申請します。
申請を送信すると、プロジェクトの API アクセスレベルが自動的にエクスプローラにアップグレードされる場合があります。
ベーシック アクセスレベル
ベーシック アクセスレベルでは、Google Cloud プロジェクトからテスト アカウントと本番環境アカウントの両方に対して Google Ads API リクエストを送信できます。本番環境アカウントとは、実際の Google 広告を配信するアカウントのことです。テスト アカウントでは広告は配信されません。
Basic アクセスレベルでは、Google Cloud クラウド プロジェクトで 1 日あたり最大 15,000 件のオペレーションを実行できます。ほとんどのデベロッパーにとって、この方法で十分です。
ベーシック アクセスレベルを申し込む
- Google Cloud プロジェクトの Google Ads API の概要ページに移動します。
- ページに現在のアクセスレベルが [Explorer] と表示されていることを確認します。
- [アクセスレベルをアップグレード] セクションをクリックして開きます。
- [次のアクセスレベル] が [ベーシック] と表示されていることを確認します。
- プロジェクトのブランド確認が完了していないことを示す警告が表示されていないことを確認します。アラートが表示された場合は、こちらの手順に沿ってブランド確認を完了してから続行してください。
- [アクセスを申請] ボタンをクリックして、Basic アクセスレベルを申請します。
申請を送信すると、プロジェクトの 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 プロジェクトで標準アクセス レベルが承認されている場合は、許可される使用を更新するための申請にご記入ください。許可される使用方法を更新する場合や、クライアントにツールへのアクセス権を付与する場合は、申請書に記入してください。