出品パートナーAPIのプログラム開発の準備

これはAamzonの出品パートナーAPIを使えるようにするための奮闘記です。

プロローグ

AmazonのAPIサービスの１つ「MWS」は、Amazonで販売している商品を出品者があれこれできる便利なもの。

その後継として新しい「出品パートナーAPI」というものが出た、というアナウンスがAmazonの公式ブログで発表されたのが2020年9月29日でした。

「時期は未定ですが、将来的にはMWSが廃止される予定ですので、
早めの移行をご検討いただくことを推奨いたします」というコメントを信じてノンビリしていたら
2021/4/7に「[重要なお知らせ]Amazon MWSのSP APIへの移行」という件名のメールが届きました

なんと「2022年7月31日からMWSは使えなくなる！」らしい

そこで出品パートナーAPI（今後略してSP-APIと書きます）を導入しようとしたのですが、

なんだこれ？、全然よくわからない。
どこから読めばいいのかさえわからない。

さらにAmazonから提供されているのはプログラミング言語がJAVA。
ほしいのはPHP。

こうしてSP-APIをなんとか導入しようと悪戦苦闘が始まりました。

SP-APIの日本語の資料といえばこちら、Amazonが原文の英語を翻訳したものです。

これ、GitHubです。

知っている人は普通に知っている、
でも自分は恥ずかしながら名前だけしか知りませんでした。
プログラマ御用達のウェブサイト GitHub 。

いろいろ読んで試した結論から言うと、MWS開発者というだけではSP-APIは使えません。

SP-APIが使えるようになるためには
MWSで言う「アクセスキー、シークレットアクセスキー」の２つの情報ぐらいでは足りず
他にもいくつも取得が必要な情報があります。

これらをするための手順が上で紹介したページなのですが
これがまた、完璧でない。
文章に沿って忠実にやろうとすればするほど、できない、つまづきます。

そしてAmazonセラーセントラルにアプリケーションを登録する必要があります。
アプリはこれから作るのでまだ存在しないアプリを登録するのは変な感じですが
「こういう機能をもったアプリを作ります」という申請だと思ってください。
この登録でアプリが一般公開されるわけではありません。

次にプログラムには

ステップ1.Login with Amazonアクセストークンをリクエストする
ステップ2.出品パートナーAPIのURIを構築する
ステップ3.URIにヘッダーを追加する
ステップ4.リクエストの作成と署名

のプロセスを組み込むことが必要です。

またAmazonサーバからのレスポンスはJSON形式のものが多いということもMWSとの違いです。

さきほど紹介したSellingPartnerApiDeveloperGuide(日本語).mdを参考にして
出品パートナーAPIアプリケーションの登録をするまでの手順を行うわけですが
このページがわかりにくい。しかも間違っている記述もあります。
ページ内のリンクも切れています。

この手順はプログラムを作っていくうちに何度もすることになったので、
この際正しい手順を自分の忘備録を兼ねてここに書きたいと思います。

まず前提としてセラーセントラルで開発者に登録済みであることが必要です。
まだという人は、まず開発者に登録してください。
ちなみに、誰でも登録できるわけではなく結構ハードル高いです。

AWS無料利用枠のページから、「まずは無料で始める」をクリックして、無料のAWSアカウントを取得します。
これは問題なくできるでしょう。
これでAWSマネジメントコンソールというページから、手続きをすることができるようになります。

console.aws.amazon.com/iamでIAMコンソールを開く。
左側のメニューで、ユーザーをクリック
「ユーザーを追加」ボタンをクリック
新しいユーザー名を決めて入力。半角英語。
アクセスの種類で「プログラムによるアクセス」にチェックを入れる
「グループの作成」ボタンをクリック
新しいグループ名を決めて、グループ名に入力。半角英語。
ポリシーのフィルタの右横にAdministratorAccessを入力
下の表でAdministratorAccessにチェックを入れる
「グループの作成」をクリック
「次のステップ：タグ」をクリック
「次のステップ：確認」をクリック
次のように表示されていることを確認する
ユーザー名とグループ名には自分が入力した文字が表示される
「ユーザーの作成」をクリック
アクセスキーIDをコピーして保存する
「表示」をクリック
シークレットアクセスキーの下にある「表示」をクリック
シークレットアクセスキーをコピーして保存する
この時しか表示されないので注意
「閉じる」をクリック
左側のメニューで、ユーザーをクリック
今作ったユーザー名をクリック
ユーザーのARNからアカウントIDの部分をコピー
たとえば
arn:aws:iam::123456789012:user/test
なら
12桁の数字の部分「12345789012」がアカウントID

左のメニューで「ポリシー」をクリック
ポリシーを初めて選択する場合は、「管理ポリシーにようこそ」のページが表示されます。「開始する」をクリック
「ポリシーの作成」をクリック
「JSON」タブをクリック
コードを置き換える
{ "Version": "2012-10-17", "Statement": [] }
を
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "execute-api:Invoke", "Resource": "arn:aws:execute-api:*:*:*" } ] }
に置き換える
「次のステップ：タグ」をクリック
「次のステップ：確認」をクリック
「ポリシーの確認」ページで、名前を決めて入力（半角）
「ポリシーの作成」をクリック