開発者トークンは 22 文字の英数字からなる文字列で、アプリから Google Ads API への接続に使用できます。Google によってトークンが割り当てられると、Google 広告 MCC アカウントの [API センター] ページでトークンを表示したり新しいトークンを作成したりできます。
各開発者トークンにはアクセスレベルが割り当てられます。このアクセスレベルにより、トークンを使用して 1 日に実行できる API 呼び出しの数と、呼び出し可能な環境が制御されます。
本番環境用アカウントに対して API 呼び出しを行うには、トークンの申請プロセス中に、開発者トークンに対する基本アクセスまたは標準アクセスをリクエストする必要があります。テスト アカウントを呼び出すにはこれらのアクセスレベルが必要ないため、演習を進めることができますが、このガイドの完了後に、基本アクセス権の申請方法を確認することをおすすめします。
新しい開発者トークンが必要ですか?
新しい開発者トークンに登録する必要があるかどうかは、いくつかの要因によって決まります。急増することがあります。
シナリオ |
次のステップ |
Google Ads API を使用したことがなく、独自のアプリを開発したいと考えている | 新しい開発者トークンをご登録ください。詳細 |
Google Ads API を積極的に使用している、または過去に使用したことがある | 通常、Google が付与する開発者トークンは会社ごとに 1 つであるため、すでに Google Ads API を使用している場合は既存の開発者トークンを再利用する必要があります。詳細 |
すでに Google Ads API を使用しているが、新しいサービスやツールも開発している | 既存の開発者トークンを使用できないことが明らかな場合は、アプリケーションでの使用目的を説明する新しい開発者トークンを申請できます。このガイドの残りの部分では、既存の開発者トークンを使用できます。詳細 |
会社でサードパーティ製アプリを使用している | 開発者トークンは、独自のアプリを開発する場合にのみ必要です。サードパーティのアプリやサービスを使用している場合は、そのアプリのデベロッパーがアプリの開発者トークンを取得する必要があります。不明な点がある場合は、API コンプライアンス チームにお問い合わせください。 |
開発者トークンの申請方法
開発者トークンの申請には 2 つのステップがあります。
ステップ 1: Google 広告クライアント センター(MCC)アカウントを選択または作成する
すでに Google 広告クライアント センター(MCC)アカウントをお持ちの場合は、トークンの申請時にそのアカウントを選択してください。この MCC アカウントが他のアカウントにまだリンクされていない場合は、トークンの確認プロセスと後のアカウント管理を簡素化するために、アカウント階層のルートに配置することをおすすめします。
MCC アカウントをお持ちでない場合は、ヘルプセンターの手順に沿って作成してください。
手順 2: Google 広告 API へのアクセスを申し込む
開発者トークンの審査処理には時間がかかることがあります。 詳細
MCC アカウントにログインし、[検索] ボタンをクリックします。
「api center」と入力して、検索のオートコンプリートから選択します。[API センター] オプションは Google 広告クライアント センター(MCC)アカウントにのみ表示されます。広告主アカウントやテスト用の MCC アカウントでは表示されません。
[API アクセス] フォームに入力し、利用規約に同意します。
情報が正しいこと、会社のウェブサイトの URL が機能していることを確認します。ウェブサイトが公開されていない場合は、Google で申請を処理できず、拒否される可能性があります。
指定した API の連絡先メールアドレスが、定期的にモニタリングされている受信トレイにアクセスできることを確認してください。Google の API コンプライアンス チームは、確認のために審査プロセス中にこのメールアドレスに連絡することがあります。到達できない場合、Google はアプリケーションを続行しない可能性があります。
API の連絡先メールアドレスは API センターで編集できます。Google からサービスに関する重要なお知らせを送信できるように、申請プロセス後も、この情報は最新の状態に保ってください。
申請プロセスが完了すると、開発者トークンが [承認待ち] ステータスで API センターに表示されます。開発者トークンのレベルがテストアクセスになり、テスト アカウントに対して API 呼び出しを行えるようになりました。
開発者トークンを取得したら、最初の API 呼び出しの際に必要になるため、その値をメモします。
開発者トークンの確認方法
既存の開発者トークンは、Google 広告クライアント センター(MCC)アカウントの [API センター] ページで確認できます。
MCC アカウントにログインし、[検索] ボタンをクリックします。
「api center」と入力して、検索のオートコンプリートから選択します。[API センター] オプションは Google 広告クライアント センター(MCC)アカウントでのみ表示され、テスト用の MCC アカウントでは表示されません。
[API アクセス] の最初の値は、開発者トークンとそのアクセスレベルです。