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