Google Cloud プロジェクトには、アクセスレベルと「許可される使用」が割り当てられます。アクセスレベルによって、本番環境アカウントに影響を与えられるかどうか、1 日に実行できるオペレーションとリクエストの数が決まります。許可される用途によって、プロジェクトで使用できる Google Ads API の特定の機能が決まります。
Cloud コンソールの Google Ads API の概要に移動
アクセスレベル
表には、4 つの異なる API アクセスレベルが順番に記載されています。Google Ads API にまだアクセスできない場合は、まず API を有効にして Google Cloud プロジェクトのテスト アクセスレベルを取得し、次に Google Ads API の概要ページで Explorer アクセスを申請して本番環境アカウントにアクセスします。
| アクセスレベル | アクセス可能 | 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 からエクスプローラ アクセスレベルの申請を求められることがあります。
エクスプローラ アクセスレベルでは、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 広告を配信するアカウントです。テスト用アカウントでは広告は配信されません。
基本アクセスレベルでは、Google Cloud プロジェクトで 1 日あたり最大 15,000 回のオペレーションを実行できます。ほとんどのデベロッパーにとって、この方法で十分です。
Basic アクセスレベルを申請する
- 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 プロジェクトが標準アクセスレベルで承認されている場合は、許可される用途を更新するための申請に記入できます。許可された用途を更新する場合や、クライアントにツールへのアクセス権を付与する場合は、申請書に記入してください。