開発者トークンは、アプリが 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 アカウントが他のアカウントにまだリンクされていない場合は、アカウント階層のルートに配置することをおすすめします。これにより、トークンの審査プロセスが容易になり、後でアカウント管理が簡素化されます。
マネージャー アカウントをお持ちでない場合は、ヘルプセンターの手順に沿って作成できます。
手順 2: Google 広告 API へのアクセスを申し込む
なお、デベロッパー トークンの審査プロセスには時間がかかる場合があります。詳細
MCC アカウントにログインします。クライアント センター（MCC）アカウントかどうかは確認できます。
ページ上部の検索バーに「api center」と入力し、検索の自動入力から選択します。[API センター] オプションは、Google 広告 MCC アカウントでのみ表示され、クライアント アカウントやテスト用の MCC アカウントには表示されません。
API アクセス フォームに記入して、利用規約に同意します。
情報が正しいことと、会社のウェブサイトの URL が機能していることを確認します。ウェブサイトが公開されていない場合、Google は申請を処理できず、申請が却下される可能性があります。
指定した API 連絡先メールアドレスが、定期的に確認される受信トレイにつながるようにしてください。Google の API コンプライアンス チームは、審査プロセス中にこのメールアドレスに連絡し、確認を求めることがあります。連絡が取れない場合は、申請手続きを進めることができないことがあります。
API の連絡先メールアドレスは、API Center で編集できます。申請手続き後も、Google から重要なサービスに関するお知らせをお届けできるよう、この情報を最新の状態に保ってください。
申請プロセスが完了すると、API センターに開発者トークンが [Pending Approval] ステータスで表示されます。これで、デベロッパー トークンのテストアクセス レベルが付与され、テスト アカウントに対して API 呼び出しを開始できます。
デベロッパー トークンを取得したら、その値をメモしておきます。最初の API 呼び出しの際に必要になります。
MCC アカウントにログインしていることを確認する
開発者トークンにアクセスするには、MCC アカウントにログインする必要があります。テスト用 MCC アカウントは使用できません。
MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
アカウントにログインします。
左側の [管理] を選択します。左上に [クライアント センター（MCC）アカウントの設定] が表示されている場合は、MCC アカウントにログインしています。[アカウント設定] が表示されている場合は、顧客アカウントにログインしています。
右上に [テスト アカウント] が赤色で表示されている場合、アカウントはテスト マネージャーまたはテスト広告主です。
開発者トークンの確認方法
開発者トークン（存在する場合）は、Google 広告クライアント センターの [API センター] ページで確認できます。
MCC アカウントにログインします。クライアント センター（MCC）アカウントかどうかは確認できます。
ページ上部の検索バーに「api center」と入力し、検索の自動補完から選択します。[API センター] オプションは、Google 広告 MCC アカウントでのみ表示され、テスト用 MCC アカウントには表示されません。
デベロッパー トークンとそのアクセスレベルは、[API アクセス] の最初の値です。