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