Amazon PA-API 改め Creators API v0.16.0 をリリース

no extension

現行の Amazon Product Advertising API (PA-API) v5 が 2026-05-15 で廃止になるのに伴い Creators API への移行が必要なのだが，拙作の goark/pa-api パッケージのユーザの方に素晴らしい pull request をいただいた。 これをマージして v0.16.0 としてリリースした。

v1.x ならメジャーバージョンを上げなきゃいけないところだったけど v0 系なのでマイナーバージョンを上げるだけにした。 まだ v1 に上げる勇気がない（笑）

パッケージ名がアレなのだが，パッケージ名を変えようとすると別リポジトリになってしまうので，README のサンプルコードに

import creatorsapi "github.com/goark/pa-api"

と書いてお茶を濁している。

完全に言い訳なのだが，私は今 Amazon Associate の API が使えないのよ。 なんか月間で10アイテム以上売り上げないと API が使えないそうで，うちみたいにネットの端っこで細々と運営しているブログサイトじゃ無理だっての。 Amazon Associate の利用目的だって，単に書影を合法的に使いたいからという，超消極的なものだし。

というわけで Creators API の対応はほとんど諦めてたんだけど，まさか PR を貰えるとは。 今回は貰った PR をそのままマージして GitHub Copilot にレビュー&修正を指示して1， README とかのドキュメントも Copilot に直させて。 私は1行もコードを書いてない。

ホンマこのパッケージは，文字通り皆さんの貢献（contributions）のおかげで成り立ってると実感できる。 今後ともよろしくお願いします 🙇

利用者向けメモ

README にも書いてるけど，移行に関するメモを記しておく。

既存の PA-API v5 呼び出し箇所を移行する際は，この手順に従う:

  1. インポートパスは github.com/goark/pa-api のままにする（必要であれば，例では creatorsapi としてエイリアス可）
  2. クライアント認証情報を置き換える: AWS Access Key / Secret Key → Creators API Credential ID / Credential Secret
  3. マーケットプレイスはサーバー／クライアント側で設定する（WithMarketplace）。クエリごとのマーケットプレイス引数には依存しないこと
  4. V1 の offers 利用を OffersV2 に置き換える（EnableOffersV2。EnableOffers は互換エイリアスとして残している）
  5. Merchant，OfferCount，PartnerType が効くという前提は外すこと。これらは無視される
  6. Credential Version（2.1/2.2/2.3）が呼び出すマーケットプレイスグループと一致していることを確認する
  7. 429 および一時的な 5xx 応答に対して再試行とレート制御を追加する
  8. PR を作成する前に，プロジェクトの標準的なテスト／リントのワークフローでローカル検証を実行すること

ブックマーク

参考図書

photo
プログラミング言語Go (ADDISON-WESLEY PROFESSIONAL COMPUTING SERIES)
Alan A.A. Donovan (著), Brian W. Kernighan (著), 柴田 芳樹 (翻訳)
丸善出版 2016-06-20
単行本（ソフトカバー）
4621300253 (ASIN), 9784621300251 (EAN), 4621300253 (ISBN)
評価     

著者のひとりは（あの「バイブル」とも呼ばれる）通称 “K&R” の K のほうである。この本は Go 言語の教科書と言ってもいいだろう。と思ったら絶版状態らしい（2025-01 現在）。復刊を望む！

reviewed by Spiegel on 2016-07-13 (powered by PA-APIv5)

photo
Go言語 100Tips ありがちなミスを把握し、実装を最適化する impress top gearシリーズ
Teiva Harsanyi (著), 柴田 芳樹 (著)
インプレス 2023-08-18 (Release 2023-08-18)
Kindle版
B0CFL1DK8Q (ASIN)
評価     

版元で PDF 版を購入可能。事実上の Effective Go とも言える充実の内容。オリジナルは敢えてタイトルに “tips” という単語を入れるのを避けたのに邦題が「100 Tips」とかなっていて，原作者がお怒りとの噂（あくまで噂）

reviewed by Spiegel on 2023-08-18 (powered by PA-APIv5)

photo
Go言語で学ぶ並行プログラミング　他言語にも適用できる原則とベストプラクティス impress top gearシリーズ
James Cutajar (著), 柴田 芳樹 (著)
インプレス 2024-12-04 (Release 2024-12-04)
Kindle版
B0DNYMMBBQ (ASIN)
評価     

読書会のために購入。インプレス社の本は Kindle 版より版元で PDF 版を買うのがオススメ。「並行処理」について原理的な解説から丁寧に書かれている。 Go で解説されているが Go 以外の言語でも応用できる。

reviewed by Spiegel on 2025-01-25 (powered by PA-APIv5)

  1. ちなみに PR に対して Copilot にレビューさせてみたんだけど，どうにも「分かってない」感じがして丸無視してしまった。今後もあるから copilot-instructions.md ファイルを作った。これで次回以降はもう少しまともなレビューにならないかなぁ。 ↩︎