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