Amazon Ads APIの使い方（認証許可を得るまでの手順）

はじめに

本記事では、Amazonのデータの1つであるAmazon広告データを活用するためのAPI利用方法について紹介していきます。

自分でこのAPIを触っていた時に、日本語の参考記事がほぼなく、公式ドキュメントだけだと手こずったところがあったので、手順をまとめていければと思います。

手順のすべてを1つにまとめると長すぎるので、2セクションに分けます。
この記事では、前処理であるAPIを利用するための認証作業までをまとめていきます。

この記事の作業完了には、Amazonへの申請作業があるため1週間程度の期間がかかる可能性があります。

Amazon Adsの公式ドキュメントはこちら

advertising.amazon.com

外部リンク

Amazon Advertising Advanced Tools Center

https://advertising.amazon.com/API/docs/en-us/info/api-overview

手順

Amazonデベロッパーに登録する
LwA セキュリティプロファイルを作成
Amazon Ads APIへの登録（申請）
API アクセスを LwAアプリケーションに割り当てる
対象アカウントから認証許可を付与する

Amazonデベロッパーに登録する

まずは、Amazon Developerに登録しましょう。

Developer Portal Master

外部リンク

Home

https://developer.amazon.com/ja/

LwA セキュリティプロファイルを作成

Amazon Developerに登録後、“アカウント＞設定” からセキュリティプロファイルを作成していきます。

セキュリティプロファイル名はなんでも構いません。
複数作成が可能なので、今回利用する用途にわかりやすいような名称が良いと思います。

セキュリティプロファイル： report-api
セキュリティプロファイルの説明：広告レポートを操作するためのAPI

Amazon Ads APIへの登録（申請）

次に、Amazona Ads APIを利用するための利用申請をしていきます。
サイトから利用申請をしていきますので、以下のURLの “Register” から申請していきましょう。

Amazon Ads

外部リンク

Amazon Ads: Online advertising for businesses of all sizes

https://advertising.amazon.com

Grow your business and increase sales with online advertising solutions that help you find, attract, and engage customers on and off Amazon.

承認可否はメールで返ってきますので、登録メールアドレスからメールを確認してください。承認された場合は、以下のようなメール内容が返ってきます。
※申請完了には数営業日かかる場合があります。

API アクセスを LwAアプリケーションに割り当てる

次に、Login with Amazon（LwA）アプリケーションとAPIを紐づけていきます。
Amazon Ads API登録リクエスト承認メールに記載されているリンクからAmazon Ads APIをAmazonDevelopアプリケーションに紐づけることができます。

※誤ってセラー用アカウントに割り当てないようにブラウザに保持されているログイン情報にご注意ください。

対象アカウントから認証許可を付与する

最後に、対象のセラーアカウントに対して、Amazon Ads APIの認証許可を通していきます。

LwAセキュリティプロファイルを作成した画面のウェブ設定タブにある以下情報を参照してください。（許可された返信URLは任意のものを設定してください。）

クライアントID
クライアントシークレット
許可された返信URL

# 以下の管理画面で確認・設定する
# https://developer.amazon.com/settings/console/securityprofile/web-settings/update.html
LWA_CLIENT_ID = "clientID"
LWA_CLIENT_SECRET = "clientSecret"
RETURN_URL = "returnUrl"

# レポートを取得したいAmazonAccountでログインして,許可すること
url = f"https://apac.account.amazon.com/ap/oa?client_id={LWA_CLIENT_ID}&scope=advertising::campaign_management&response_type=code&redirect_uri={RETURN_URL}"
print(url)
# https://apac.account.amazon.com/ap/oa?client_id={clientID}&scope=advertising::campaign_management&response_type=code&redirect_uri={returnUrl}

生成したURLに飛んで、Amazonセラーアカウントでログイン後、許可ボタンを押下すれば認証許可を付与することができます。