開発者トークン は、アプリを Google Ads API に接続するための 22 文字の英数字文字列です。Google 広告の
MCC アカウントの [API センター] ページで登録すると取得できます。API 呼び出しを行うときは、developer-token
http ヘッダーまたは gRPC ヘッダーを設定して、リクエストの一部として開発者トークンを送信します。
各開発者トークンにはアクセスレベルが割り当てられます。このアクセスレベルによって、 トークンを使用して 1 日に実行できる API 呼び出しの数と、 呼び出しを実行できる環境が制御されます。
開発者トークンに登録すると、デフォルトで エクスプローラ アクセス レベルが付与される場合があります。これにより、本番アカウントに対して呼び出しを行うことができますが、いくつかの制限があります。開発者トークン申請の自動審査ができない場合は、代わりに開発者トークンに テスト アカウント アクセス レベルが付与されることがあります。この場合、API 呼び出しはテストアカウントに対してのみ行うことができます。エクスプローラ アクセス レベルとテスト アカウント アクセス レベルの制限を解除するには、開発者トークンの基本アクセス レベルまたは標準アクセス レベルをリクエストする必要があります。開発者トークン申請が審査され承認されると、開発者トークンに適切なアクセスレベルが付与されます。
新しい開発者トークンが必要ですか？
新しい開発者トークンに登録するかどうかは、いくつかの要因によって異なります。一般的なシナリオをいくつかご紹介します。
シナリオ |
次のステップ |
| 貴社が Google Ads API を使用したことがなく、独自のアプリを開発したい場合 | 新しい開発者トークンに登録します。詳細 |
| 貴社が Google Ads API を現在使用しているか、過去に使用したことがある場合 | 通常、Google は 1 社につき 1 つの開発者トークンを付与します。貴社がすでに Google Ads API を使用している場合は、既存の開発者 トークンを再利用してください。詳細 |
| 貴社がすでに Google Ads API を使用しているが、新しい プロダクトやツールも開発している場合 | 既存の開発者トークンを使用できない場合は、 申請書にユースケースを記載して新しいトークンを申請できます。 このガイドの残りの部分では、既存の開発者 トークンを使用できます。詳細 |
| 貴社がサードパーティ製アプリを使用している場合 | 開発者トークンが必要なのは、独自のアプリを開発する場合のみです。サードパーティ製アプリやサービスを使用する場合は、そのアプリのデベロッパーがアプリの開発者トークンを取得する必要があります。ご不明な場合は、API コンプライアンス チームにお問い合わせください。 |
開発者トークンを申請できるのは誰ですか？
企業と個人のデベロッパーの両方が開発者トークンを申請できます。次の表に、開発者トークンに登録する際に提供する必要がある情報の概要を示します。
| あなたが | 次のデベロッパーの詳細情報を入力してください | その他の注意事項 |
|---|---|---|
| 貴社またはプロダクト チームを代表するデベロッパー | 会社名と会社の URL | 通常、Google は 1 社につき 1 つの開発者トークンを付与しますが、個別のツールに対しては個別の開発者トークンをケースバイケースで承認します。 |
| 会社を代表しない個人のデベロッパー | 会社名として「Individual 」と入力します。会社の URL の代わりに、GitHub プロフィール URL や LinkedIn プロフィール
URL などの代替 URL を入力できます。 |
オンラインでのプレゼンスが必要であり、Google Ads API を使用して何を行う予定であるかを Google が評価するのに役立つ URL
を提供する必要があります。`test.com` や `example.com` などの一般的な URL は使用できません。 |
開発者トークンを申請する方法
開発者トークンを申請する手順は 2 つあります。
ステップ 1: Google 広告の MCC アカウントを選択または作成する
すでに Google 広告の MCC アカウントをお持ちの場合は、開発者トークンを申請する際に選択します。この MCC アカウントが他のアカウントにまだリンクされていない場合は、トークンの審査プロセスを容易にし、後でアカウント管理を簡素化するために、アカウント階層のルートに配置することをおすすめします。
MCC アカウントをお持ちでない場合は、ヘルプセンター の手順に沿って作成できます。
手順 2: Google 広告 API へのアクセスを申し込む
開発者トークンの審査プロセスには時間がかかる場合があります。 詳細
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
[API アクセス] フォームに必要事項を入力し、利用規約に同意します。
情報が正しく、会社のウェブサイトの URL が機能していることを確認してください。ウェブサイトが公開されていない場合、Google は申請を処理できず、申請が拒否される可能性があります。
API の連絡先メールアドレスが、定期的にモニタリングされている受信トレイにつながっていることを確認してください。審査プロセス中に、Google の API コンプライアンス チームからこのメールアドレスに連絡して、不明な点を確認する場合があります。連絡が取れない場合、Google は申請を続行できない可能性があります。
API の連絡先メールアドレス は、API センター で編集できます。申請手続き後もこの情報を最新の状態に保つことで、Google から重要なサービスに関するお知らせを受け取ることができます。
申請手続きが完了すると、開発者トークンが API センターに表示され、次のいずれかの結果が表示されます。
- 開発者トークンにエクスプローラ アクセス レベルが付与され、ステータスが [承認済み] になっています。これは、Google がエクスプローラ アクセス レベルの開発者トークン申請を自動的に審査して承認できたことを意味します。本番アカウントまたは テストアカウントに対して API 呼び出しを開始できます。
- 開発者トークンにテスト アカウント アクセス レベルが付与され、ステータスが [承認待ち] になっています。これは、Google がエクスプローラ アクセス レベルの開発者トークン申請を自動的に審査して承認できなかったことを意味します。テストアカウントに対して API 呼び出しを開始できます。このガイドを完了したら、基本アクセス レベルを申請する方法をご確認ください。
Google 広告の MCC アカウントにログインしているかどうかを確認する
開発者トークンにアクセスするには、Google 広告の MCC アカウントにログインする必要があります。Google 広告のテスト MCC アカウントは使用できません。
Google 広告の MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。
お客様アカウントにログインしている場合、ページに「API センターは、クライアント センター（MCC）アカウントでのみご利用可能です。 」と表示されます。
右上に [テスト アカウント] が赤色で表示されている場合、アカウントはテスト MCC アカウントまたはテスト広告主アカウントです。
開発者トークンを確認する場所
開発者トークンが存在する場合は、Google 広告の MCC アカウントの [API センター] ページで確認できます。