各 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 広告 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 広告キャンペーンの作成および管理を容易にするための提案を必要とするツールでのみ使用されます。 |
「許可されている用途」を変更する
ベーシック アクセス レベルまたは標準アクセスレベルのいずれかが承認されている場合は、「許可された用途」の更新申請にご記入ください。許容される用途を更新するか、クライアントにツールへのアクセス権を付与する場合は、申請書にご記入ください。