開発者トークンは、アプリが Google Ads API に接続できるようにする 22 文字の英数字の文字列です。Google からトークンが割り当てられたら、Google 広告 MCC アカウントの [API センター] ページでトークンを確認したり、新しく作成したりできます。
各デベロッパー トークンにはアクセスレベルが割り当てられます。このレベルにより、トークンを使用して 1 日に実行できる API 呼び出し数と、呼び出しを実行できる環境が制御されます。
本番環境アカウントに対して API 呼び出しを行うには、トークン申請プロセスで開発者トークンの基本アクセスまたは標準アクセスをリクエストする必要があります。テスト アカウントに対して呼び出しを行うにはこれらのアクセスレベルは必要ないため、演習を続行できますが、このガイドを完了したら、基本アクセス権を申請する方法を確認することをおすすめします。
新しいデベロッパー トークンが必要ですか？
新しいデベロッパー トークンを登録するかどうかは、いくつかの要因によって異なります。急増することがあります。
シナリオ |
次のステップ |
| これまで Google Ads API を使用したことがなく、独自のアプリを開発したい | 新しい開発者トークンを登録します。詳細 |
| 貴社が Google Ads API を現在使用しているか、過去に使用したことがあること | 通常、Google は 1 社につき 1 つの開発者トークンを付与します。そのため、すでに Google Ads API をご利用の場合は、既存の開発者トークンを再利用してください。詳細 |
| すでに Google Ads API を使用しているものの、新しいプロダクトやツールも開発している | 既存の開発者トークンを使用できない場合は、申請時にユースケースを説明して新しいトークンを申請できます。このガイドの残りの部分では、既存のデベロッパー トークンを使用できます。詳細 |
| 会社でサードパーティ製アプリを使用している | 開発者トークンは、独自のアプリを開発する場合にのみ必要です。サードパーティ製のアプリやサービスを使用している場合は、そのアプリのデベロッパーがアプリの開発者トークンを取得する必要があります。ケースが不明な場合は、API コンプライアンス チームにお問い合わせください。 |
開発者トークンを申請する方法
デベロッパー トークンを申請する手順は 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 コンプライアンス チームは、審査プロセス中にこのメールアドレスに連絡し、確認を求めることがあります。連絡が取れない場合は、申請手続きを進めることができないことがあります。
API の連絡先メールアドレスは、API Center で編集できます。申請手続き後も、Google から重要なサービスに関するお知らせをお届けできるよう、この情報を最新の状態に保ってください。
申請プロセスが完了すると、API センターに開発者トークンが [Pending Approval] ステータスで表示されます。これで、開発者トークンのアクセス権がテスト アクセスレベルになり、テスト アカウントに対して API 呼び出しを開始できるようになりました。
デベロッパー トークンを取得したら、その値をメモしておきます。最初の API 呼び出しの際に必要になります。
MCC アカウントにログインしていることを確認する
開発者トークンにアクセスするには、MCC アカウントにログインする必要があります。テスト用 MCC アカウントは使用できません。
MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。
お客様のアカウントにログインしている場合、ページには「API センターはクライアント センター（MCC）アカウントでのみご利用いただけます」と表示されます。
右上に [テスト アカウント] が赤色で表示されている場合、アカウントはテスト マネージャーまたはテスト広告主です。
開発者トークンの確認方法
開発者トークン（存在する場合）は、Google 広告クライアント センターの [API センター] ページで確認できます。