Google の開発者トークンを使用すると、アプリを Google Ads API に接続できます。各開発者トークンには、トークンを使用して 1 日に実行できる API 呼び出しの数と呼び出しを行う環境を制御するアクセスレベルが割り当てられます。詳細
各 Google API Console プロジェクトは、1 つの MCC アカウントからのみ開発者トークンに関連付けることができます。Google Ads API リクエストを送信すると、開発者トークンは Google API Console プロジェクトと完全にペア設定されます。
新しい MCC アカウントで開発者トークンに切り替える場合は、まず、新しいマネージャーのトークンを使用する Google Ads API リクエスト用に新しい Google API Console プロジェクトを作成する必要があります。新しい Google API Console プロジェクトを使用しない場合は、リクエストを行うときに DEVELOPER_TOKEN_PROHIBITED
エラーが発生します。
手順
ステップ 1: Google 広告 MCC アカウントを選択または作成する
開発者トークンを申請するには、まず Google 広告クライアント センター(MCC)アカウントが必要です。
MCC アカウントは、既存の Google 広告 アカウントで使用しているものと同じメールアドレスで作成することはできません。そのため、Google 広告 アカウントとは関連付けられていないメールアドレスを使用して、MCC アカウントを作成する必要があります。
なお、選択した MCC アカウントは、開発者トークンがアクセスできる一連の Google 広告アカウントには影響しません。開発者トークンを保持するために使用されます。
適切な OAuth 認証情報があれば、トークン自体はどのアカウントにもアクセスできます。この MCC アカウントを会社の有効な Google 広告アカウントをリンクすると、アプリの審査プロセスが合理化され、API でアカウントを管理するために認証プロセスを経る回数が削減されます。詳しくは、アカウントのリンクに関するヘルプセンター記事をご覧ください。
手順 2: Google 広告 API へのアクセスを申し込む
MCC アカウントから Google Ads API へのアクセスの申し込みを行います。ログインして、[ツールと設定] > [設定] > [API Center] に移動します。[API センター] オプションは、Google 広告のクライアント センター(MCC)アカウントにのみ表示されます。
API アクセス フォームのすべてのフィールドを入力し、利用規約に同意する必要があります。情報が正しく、会社のウェブサイトの URL が正しく機能していることを確認してください。ウェブサイトが公開中のページでない場合、お申し込みは処理されません。
提供する API の連絡先メールアドレスが、定期的にモニタリングされる受信トレイにアクセスできることを確認します。このメールアドレスにご連絡いただけない場合、お申し込みは処理されず、不承認となります。
API の連絡先メールアドレスは、API センターで編集できます。
重要なサービスに関するお知らせを Google から送信できるよう、お申込み手続きの後でも、これらの情報を最新の状態にすることを強くおすすめします。
手順 3: お申し込み手続きを進める
保留中の開発者トークンは、本番環境の Google 広告アカウントで使用する前に承認を受ける必要があります。ベーシック アクセスまたはスタンダード アクセスのいずれかを適用できます。
API 使用量を最小限に抑えることが想定される場合は、ベーシック アクセスを申請します。
API 使用量が多くなることが予想される場合は、標準権限を申請します。
ベーシック アクセスとスタンダード アクセスのどちらが必要かを判断するには、レートシートをご覧ください。今後の API 使用量が不明な場合は、ベーシック アクセスから開始し、ベーシック アクセスによって適用される割り当て制限に頻繁にアクセスされたら、標準アクセスにアップグレードすることをおすすめします。
ベーシック アクセスと標準アクセスの両方のアプリケーションが、Google Ads API での使用を推奨するツールまたはソフトウェア アプリが利用規約とポリシー(最低限必要な機能(該当する場合)を含む)に準拠しているかどうか審査されます。クライアント用の Google 広告アカウントを管理している企業が Google Ads API にアクセスするには、サードパーティ ポリシーに準拠する必要があります。
通常は、お申し込みの送信日から 2 営業日以内に、ステップ 2 で指定したメールアドレスにご連絡します。この受信トレイにアクセスできない場合や、このメールアドレスを積極的にモニタリングする予定がない場合は、Google からのご連絡を受けられるよう、上記の手順 2 の手順どおりに API センターでメールアドレスを編集してください。
お申し込みが承認された場合
割り当てられた開発者トークンは、API アクセスのアプリケーションが承認されると、本番環境で有効になります。トークンは API センターからアクセスでき、適用元の MCC アカウントの [アカウント設定] メニューからアクセスできます。Google のシステムとやり取りするときに API にリクエスト ヘッダーを含めることで、その API にアクセスできるようになります。
指定したメールアドレスにサービスの変更や中断に関する重要な情報が送信されるため、連絡先のメールアドレスは常に最新の状態にしておいてください。
今後ツールに変更を加えた場合は、Google Ads API ツールの変更フォームに記入し、Google にその変更を報告する必要があります。
お申し込みが不承認となった場合
トークン審査チームは、お客様が Google Ads API の利用を申し込む際に提供された情報を審査し、お客様のソフトウェアが Google Ads API の利用規約と必須機能要件(該当する場合)に準拠していることを確認します。
お申し込みが不承認となる一般的な理由には、次のようなものがあります。
- 指定された連絡先メールアドレスを使用しても連絡が付かない場合
- サードパーティで使用するツールに開発者トークンが必要なため、お申し込み済みです。
- アプリケーションが利用規約の他の条項に違反している場合
- お客様のアプリは、必須機能に必要な要素を実装していません(該当する場合)。
Google Ads API のポリシーに準拠するよう API ツールに変更を加えた場合、またはお申し込みが間違って不承認となったと思われる場合は、MCC アカウントの [API センター] ページで [再申請] リンクをクリックして再申請できます。
申請について Google からのメールが予定期間内に届かなかった場合は、Google Ads API コンプライアンス チームまでお問い合わせください。
お支払い
Google 広告 API は無料でご利用いただけます。最低限必要な機能を遵守していない場合、違約金は請求されます。詳細については、レートシートをご覧ください。