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