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