List of Amazon [text.Baldanders.info]

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

2026-05-06T03:39:52+00:00

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

Release v0.16.0 · goark/pa-api · GitHub

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 にレビュー&修正を指示して¹， README とかのドキュメントも Copilot に直させて。私は1行もコードを書いてない。

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

利用者向けメモ

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

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

インポートパスは github.com/goark/pa-api のままにする（必要であれば，例では creatorsapi としてエイリアス可）

クライアント認証情報を置き換える: AWS Access Key / Secret Key → Creators API Credential ID / Credential Secret

マーケットプレイスはサーバー／クライアント側で設定する（WithMarketplace）。クエリごとのマーケットプレイス引数には依存しないこと

V1 の offers 利用を OffersV2 に置き換える（EnableOffersV2。EnableOffers は互換エイリアスとして残している）

Merchant，OfferCount，PartnerType が効くという前提は外すこと。これらは無視される

Credential Version（2.1/2.2/2.3）が呼び出すマーケットプレイスグループと一致していることを確認する

429 および一時的な 5xx 応答に対して再試行とレート制御を追加する

PR を作成する前に，プロジェクトの標準的なテスト／リントのワークフローでローカル検証を実行すること

移行チェックリストより

ブックマーク

参考図書

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

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

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

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

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

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

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

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

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

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

Amazon PA-API にアクセスできなくなった

2025-11-17T09:15:09+00:00

先日から Amazon の PA-API (Product Advertising API) にアクセスできなくて困っている。なんか 403 が返ってくるんだよな。 API で何か破壊的変更でもあったのかと PA-API のサイトを見てみるも，それらしい情報が見当たらず途方に暮れていたのだが…

AmazonのPA-APIでエラー発生！こっそり規約が変更されていた！？ | 忘れられたおもちゃ部屋

によると（引用の引用でゴメン）

お調べいたしましたところ、11月12日からポリシーが変更となり、PA-APIへのアクセスは過去30日以内に10件の的確な売上(10件の注文)を発生させていただく必要があることが確認できました。

こちら当プログラムサイト上ではまだお知らせ等が間に合っておりませんが、随時更新させていただきます。

AmazonのPA-APIでエラー発生！こっそり規約が変更されていた！？より

なんじゃそらぁ (╯°□°）╯︵ ┻━┻

いやまじかんべんしてください。

このサイトは確かにアソシエイトプログラムに参加しているけど，アフィリエイト目的のサイトじゃない。書影とか商品画像を合法的に使いたくて PA-API を使っているだけで，売上件数も微々たるもの。年に数回 Amazon ギフトもらって「これでマンガ単行本が1冊余分に買える」とか細やかに喜んでるレベルの運用なのよ。月に1件でも危ない時があったのに，10件以上とか絶対無理無理無理！

これはもう Amazon を頼るのは駄目かもしれん。他の方法を考えないと。

…と考えて，そういえば今どきは出版社の書籍紹介ページの OGP イメージで書影を使ったりするよな。ということは，別に Amazon のサービスを使わなくても画像を含むリンクカードを生成する仕組みを作ればいいのか。うーん，この線で考えてみよう。

他にも

Amazon SP-API有料化の真相。SaaS依存のリスクと内製化という次の一手 | EC・ネット通販を中心とした物販ビジネス専門メディア「コマースピック」

なんてな話もあるようで¹，自前で管理システムを構築できない企業などはしんどいことになりそうだ。まぁ，かつての「ロングテール理論」とか今のインターネット老人が若き日の妄想だったということかな。

ブックマーク

PA-API v5 への移行
goark/pa-api: APIs for Amazon Product Advertising API v5 by Golang : このパッケージは皆さまからの PR で運用されています（笑）

SP-API は Seller Partner API のことで， Amazon に出品している商品の管理をするための API らしい。実際には間にサードパーティの SaaS サービスが入ることが多いそうで，それら SaaS サービスに対して2026年から料金が発生するよってことのようだ。最終的にその費用はエンドユーザが負担することになるんだろうけど。 ↩︎

goark/pa-api パッケージで GetBrowseNodes オペレーションに対応した

2022-07-18T07:01:46+00:00

今更であるが，Amazon PA-APIv5 にアクセスするための自作パッケージ goark/pa-api は実はコードの半分以上が他人様の PR でできているのだが（感謝！），今回は GetBrowseNodes オペレーション追加をリクエストされまして

Enable to get browse node Info · Issue #25 · goark/pa-api · GitHub

たまには自分でコードを書こうと思い立ったのだった。ちなみに GetBrowseNodes オペレーションの API 仕様は以下の通り。

GetBrowseNodes · Product Advertising API 5.0

ここで browse node というのは構造化された商品カテゴリのようなものらしい。

Browse Nodes · Product Advertising API 5.0

goark/pa-api を使って browse node の情報を取得してみよう。ちなみに PA-API アクセス用パラメータを以下に例示する。

パラメータ名	値
マーケットプレイス	`www.amazon.co.jp`
アソシエイト・タグ	`mytag-20`
アクセス・キー	`AKIAIOSFODNN7EXAMPLE`
シークレット・キー	`1234567890`

もちろん実際には使えないのでご安心を（笑）さっそくコードを書いてみる。

//go:build run
// +build run

package main

import (
    "bytes"
    "context"
    "fmt"
    "io"
    "os"

    paapi5 "github.com/goark/pa-api"
    "github.com/goark/pa-api/query"
)

func main() {
    //Create client
    client := paapi5.New(
        paapi5.WithMarketplace(paapi5.LocaleJapan),
    ).CreateClient(
        "mytag-20",
        "AKIAIOSFODNN7EXAMPLE",
        "1234567890",
    )

    //Make query
    q := query.NewGetBrowseNodes(
        client.Marketplace(),
        client.PartnerTag(),
        client.PartnerType(),
    ).BrowseNodeIds([]string{"2291970051"})

    //Requet and response
    body, err := client.RequestContext(context.Background(), q)
    if err != nil {
        fmt.Printf("%+v\n", err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(body))
}

これを実行してみよう。

$ go run sample1.go | jq .
{
  "BrowseNodesResult": {
    "BrowseNodes": [
      {
        "ContextFreeName": "産業研究",
        "DisplayName": "産業研究",
        "Id": "2291970051",
        "IsRoot": false
      }
    ]
  }
}

これで browse node ID が 2291970051 の情報が取得する。さらに

//Make query
q := query.NewGetBrowseNodes(
    client.Marketplace(),
    client.PartnerTag(),
    client.PartnerType(),
).BrowseNodeIds([]string{"2291970051"}).EnableBrowseNodes()

と，リソースパラメータを有効にすると

$ go run sample2.go | jq .
{
  "BrowseNodesResult": {
    "BrowseNodes": [
      {
        "Ancestor": {
          "Ancestor": {
            "Ancestor": {
              "Ancestor": {
                "ContextFreeName": "Kindleストア",
                "DisplayName": "Kindleストア",
                "Id": "2250738051"
              },
              "ContextFreeName": "Kindleストア",
              "DisplayName": "カテゴリー別",
              "Id": "2250739051"
            },
            "ContextFreeName": "Kindle本",
            "DisplayName": "Kindle本",
            "Id": "2275256051"
          },
          "ContextFreeName": "ビジネス・経済",
          "DisplayName": "ビジネス・経済",
          "Id": "2291905051"
        },
        "Children": [
          {
            "ContextFreeName": "コンサルティング",
            "DisplayName": "コンサルティング",
            "Id": "4715053051"
          },
          {
            "ContextFreeName": "経営情報システム",
            "DisplayName": "経営情報システム",
            "Id": "4715061051"
          },
          {
            "ContextFreeName": "銀行・金融業",
            "DisplayName": "銀行・金融業",
            "Id": "2292599051"
          },
          {
            "ContextFreeName": "人事・労務管理",
            "DisplayName": "人事・労務管理",
            "Id": "2291959051"
          },
          {
            "ContextFreeName": "経理・アカウンティング",
            "DisplayName": "会計",
            "Id": "2292083051"
          },
          {
            "ContextFreeName": "e コマース",
            "DisplayName": "e コマース",
            "Id": "2291907051"
          },
          {
            "ContextFreeName": "NGO・NPO",
            "DisplayName": "非営利組織",
            "Id": "2293150051"
          },
          {
            "ContextFreeName": "不動産",
            "DisplayName": "不動産",
            "Id": "2291980051"
          }
        ],
        "ContextFreeName": "産業研究",
        "DisplayName": "産業研究",
        "Id": "2291970051",
        "IsRoot": false
      }
    ]
  }
}

という感じに親ノードと子ノードも併せて取得できる。

この browse node ID を使って商品検索結果を絞り込むことができる。たとえば結城浩さんの著作を 2291970051 で絞り込んでみる。

//Make query
q := query.NewSearchItems(
    client.Marketplace(),
    client.PartnerTag(),
    client.PartnerType(),
).Search(query.Author, "結城浩").Request(query.BrowseNodeID, "2291970051").EnableItemInfo()

これを実行すると

$ go run sample3c.go | jq .
{
  "SearchResult": {
    "Items": [
      {
        "ASIN": "B08S2LY9VG",
        "DetailPageURL": "https://www.amazon.co.jp/dp/B08S2LY9VG?tag=mytag-20&linkCode=osi&th=1&psc=1",
        "ItemInfo": {
          "ByLineInfo": {
            "Manufacturer": {
              "DisplayValue": "SBクリエイティブ",
              "Label": "Manufacturer",
              "Locale": "ja_JP"
            },
            "Contributors": [
              {
                "Name": "結城 浩",
                "Locale": "ja_JP",
                "Role": "著"
              }
            ]
          },
          "Classifications": {
            "Binding": {
              "DisplayValue": "Kindle版",
              "Label": "Binding",
              "Locale": "ja_JP"
            },
            "ProductGroup": {
              "DisplayValue": "Digital Ebook Purchas",
              "Label": "ProductGroup",
              "Locale": "ja_JP"
            }
          },
          "ContentInfo": {
            "Languages": {
              "DisplayValues": [
                {
                  "DisplayValue": "日本語",
                  "Type": "発行済み"
                }
              ],
              "Label": "Language",
              "Locale": "ja_JP"
            },
            "PagesCount": {
              "DisplayValue": 218,
              "Label": "NumberOfPages",
              "Locale": "en_US"
            },
            "PublicationDate": {
              "DisplayValue": "2021-02-19T00:00:00Z",
              "Label": "PublicationDate",
              "Locale": "en_US"
            }
          },
          "ProductInfo": {
            "IsAdultProduct": {
              "DisplayValue": false,
              "Label": "IsAdultProduct",
              "Locale": "en_US"
            },
            "ReleaseDate": {
              "DisplayValue": "2021-02-20T00:00:00Z",
              "Label": "ReleaseDate",
              "Locale": "en_US"
            }
          },
          "TechnicalInfo": {
            "Formats": {
              "DisplayValues": [
                "Kindle本"
              ],
              "Label": "Format",
              "Locale": "ja_JP"
            }
          },
          "Title": {
            "DisplayValue": "再発見の発想法",
            "Label": "Title",
            "Locale": "ja_JP"
          }
        }
      }
    ],
    "SearchURL": "https://www.amazon.co.jp/s?rh=n%3A2291970051%2Cp_lbr_three_browse-bin%3A%E7%B5%90%E5%9F%8E%E6%B5%A9%2Cp_n_availability%3A-1&tag=mytag-20&linkCode=osi",
    "TotalResultCount": 1
  }
}

という感じに『再発見の発想法』のみ絞り込めた。

まぁ，こんな感じに使ってみてください。

ブックマーク

参考図書

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

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

デベロッパーゴースーパーゴラン Tシャツ: Geek Go Super Golang Tees; ウェア&シューズ; B09C2XBC2F (ASIN); 評価

[Comment] ついカッとなってポチった。反省はしない

reviewed by Spiegel on 2022-04-10 (powered by PA-APIv5)

再発見の発想法: 結城浩 (著); SBクリエイティブ 2021-02-19 (Release 2021-02-20); Kindle版; B08S2LY9VG (ASIN); 評価

[Comment] 「Software Design」誌の同名連載の書籍化。「技術用語」の解説書だが，平易な内容で読みやすい。

reviewed by Spiegel on 2021-03-14 (powered by PA-APIv5)

PA-APIv5 クライアント・パッケージ v0.9.1 をリリースした

2021-07-16T12:18:45+00:00

ちょっとした改修の pull request をいただいたので，これを反映した Amazon Product Advertising API v5 (PA-APIv5) クライアント・パッケージ spiegel-im-spiegel/pa-api の v0.9.1 をリリースした。と思ったのだが，何故か v0.9.0 のアナウンスをしてなかったみたいなので，併せて紹介する。

v0.8.0 をリリースしたときに「いっそ interface 型で汎化してしまうか」と書いたのだが，実際に v0.9.0 では Marketplace 型を

type Marketplace interface {
    String() string   // marketplace name (www.amazon.com)
    HostName() string // hostname (webservices.amazon.com)
    Region() string   // region (us-east-1)
    Language() string // language code (en_US)
}

と interface 型で定義しなおすことで自前でマーケットプレイス情報を定義できるようにした。なお，元々の列挙型は MarketplaceEnum で再定義している。

私が公開しているパッケージでは珍しく pull request をいただくことが多いのだが，使っていただけるのなら幸いである。

参考図書

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

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

PA-APIv5 クライアント・パッケージ v0.8.0 をリリースした

2020-11-06T12:01:53+00:00

ありがたいことに pull request をいただきまして， Amazon Product Advertising API v5 へアクセスできる Go 言語用パッケージ spiegel-im-spiegel/pa-api の v0.8.0 をリリースした。

Release v0.8.0 · spiegel-im-spiegel/pa-api · GitHub

今回は Marketplace 定義の追加のみ。

spiegel-im-spiegel/pa-api では Marketplace を列挙型で定義しているのだが，頻繁に追加や変更があるなら上手いやり方ではないかもしれない。いっそ interface 型で汎化してしまうか。手を入れるのは簡単だが，今のところは考え中。

Go 言語用 PA-API v5 クライアント・パッケージ v0.7.0 をリリースした

2020-06-30T05:26:02+00:00

またも pull request をいただきまして，マージして v0.7.0 をリリースしました。

Release v0.7.0 · spiegel-im-spiegel/pa-api · GitHub

ついでにコメントの不備も直してもらっちゃいました。

ありがたや m(_ _)m

PA-API v5 のドキュメントには書かれてないのだが，問い合わせ時の resources parameter に CustomerReviews の項目があるみたいで paapi5/query サブパッケージで指定できるようにしてもらった。

こんな感じ。

package main

import (
    "bytes"
    "fmt"
    "io"
    "os"

    paapi5 "github.com/spiegel-im-spiegel/pa-api"
    "github.com/spiegel-im-spiegel/pa-api/query"
)

func main() {
    //Create client
    client := paapi5.New(
        paapi5.WithMarketplace(paapi5.LocaleJapan),
    ).CreateClient(
        "mytag-20",
        "AKIAIOSFODNN7EXAMPLE",
        "1234567890",
    )

    //Make query
    q := query.NewGetItems(
		client.Marketplace(),
		client.PartnerTag(),
		client.PartnerType(),
	).
		ASINs([]string{"B07NVMYB7K"}).
		EnableCustomerReviews()

    //Requet and response
    body, err := client.Request(q)
    if err != nil {
        fmt.Printf("%+v\n", err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(body))
}

これでリクエスト側のペイロードの内容は

{
 "ItemIds": [
  "B07NVMYB7K"
 ],
 "Resources": [
  "CustomerReviews.Count",
  "CustomerReviews.StarRating"
 ],
 "PartnerTag": "mytag-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.jp",
 "Operation": "GetItems"
}

となり，返ってきた値も

Added undocumented Customer Rating to API

となる筈，なのだが，手元では CustomerReviews 項目が上手く取れなかった（指定してもエラーにはならない）。いただいた pull request には

It seems you have to request this functionality directly at Amazon to be able to use the resource. My organization got approval and therefore needs this resource in this API.

via Added undocumented Customer Rating to API

とあるので CustomerReviews 項目を使えるようにする何らかの手続きが必要なのかもしれない（日本の marketplace が対応してないだけかもしれないが）。まぁ，私個人は使わない項目なので，困らないのが困りもの（笑）

ちうわけで，日本の環境で CustomerReviews 周りの情報を知っておられる方は是非教えてください。

ブックマーク

Go 言語用 PA-API v5 クライアント・パッケージ

参考図書

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

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

PA-API v5 クライアント・パッケージ v0.5.0 をリリースした

2019-10-20T11:29:51+00:00

Go 言語用 PA-API v5 クライアント・パッケージ spiegel-im-spiegel/pa-api v0.5.0 をリリースした。

Release v0.5.0 · spiegel-im-spiegel/pa-api · GitHub

以前いただいた pull request のコードがなかなかよかったので paapi5/query サブパッケージを全面的に書き直した。

もともと paapi5/query サブパッケージは paapi5.Query インタフェースの実装サンプル・コード程度にしか考えてなかったのだが， PA-API の GetItems および SearchItems オペレーションに限れば，そのまま使えそうな感じになってしまった。 PR を送っていただいた方にはホンマに感謝である。

コメントとかドキュメントはまだまだ整理中なので，長い目で見てやってください。あっ PR はいつでも歓迎です。

ブックマーク

参考図書

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

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

PA-API v5 クライアント・パッケージ v0.4.0 をリリースした

2019-10-15T12:52:44+00:00

いや， Go 言語用の PA-API v5 クライアント・パッケージなんか私以外に需要はないと思ってたのよ。したら pull request 貰っちゃって大慌て（笑）

貰った PR を受け入れた後，コメント・ドキュメントの整理と若干の機能追加をした v0.4.0 をリリースした。

まずは，アイテム検索用の query 構造体を作ってもらっちゃった。これを使って，こんな感じにアイテムの検索ができる。

package main

import (
    "context"
    "fmt"
    "net/http"

    paapi5 "github.com/spiegel-im-spiegel/pa-api"
    "github.com/spiegel-im-spiegel/pa-api/entity"
    "github.com/spiegel-im-spiegel/pa-api/query"
)

func main() {
    //Create client
    client := paapi5.New(
        paapi5.WithMarketplace(paapi5.LocaleJapan),
    ).CreateClient(
        "mytag-20",             //Amazon associate tag
        "AKIAIOSFODNN7EXAMPLE", //access key for PA-API
        "1234567890",           //secret key for PA-API
        paapi5.WithContext(context.Background()),
        paapi5.WithHttpClient(http.DefaultClient),
    )

    //Make query
    q := query.NewSearchItems(
        client.Marketplace(),
        client.PartnerTag(),
        client.PartnerType(),
    ).Search("数学ガール", query.Keywords)

    //Requet and response
    body, err := client.Request(q)
    if err != nil {
        fmt.Printf("%+v\n", err)
        return
    }
    //io.Copy(os.Stdout, bytes.NewReader(body))

    //Decode JSON
    res, err := entity.DecodeResponse(body)
    if err != nil {
        fmt.Printf("%+v\n", err)
        return
    }
    fmt.Println(res.String())
}

あっ，もちろんアクセス・キー等は自分のを使ってね。

サーバ側の情報を格納する paapi5.Server インスタンスを生成しているのが以下の部分だが

paapi5.New(
    paapi5.WithMarketplace(paapi5.LocaleJapan),
)

引数の関数オプションの仕様を変更した。以下のシンボルをマーケットプレイスとしてセットできる。

//Marketplace is enumeration of locale information
type Marketplace int

const (
    LocaleUnknown            Marketplace = iota //Unknown local
    LocaleAustralia                             //Australia
    LocaleBrazil                                //Brazil
    LocaleCanada                                //Canada
    LocaleFrance                                //France
    LocaleGermany                               //Germany
    LocaleIndia                                 //India
    LocaleItaly                                 //Italy
    LocaleJapan                                 //Japan
    LocaleMexico                                //Mexico
    LocaleSpain                                 //Spain
    LocaleTurkey                                //Turkey
    LocaleUnitedArabEmirates                    //United Arab Emirates
    LocaleUnitedKingdom                         //United Kingdom
    LocaleUnitedStates                          //United States
)

これらのシンボルからマーケットプレイス名，サービスサーバ名，リージョン，言語の情報を取得できる。既定値は paapi5.LocaleUnitedStates とした。

他の人が使うとか勘定に入れてなかったので相当にやっつけコードだったが，余暇にちょっとずつコードもコメント・ドキュメントも整理していく予定である。なので長い目で見てやってください。あっ pull request はいつでも歓迎です。

ブックマーク

参考図書

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

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

Go 言語用 Amazon Creators API クライアント・パッケージ

2019-10-06T06:46:03+00:00

goark/pa-api: Go client for the Amazon Creators API

【2026-05-15 追記】

Amazon Product Advertising API v5 は2026年5月中旬に廃止され， Creators API に移行した。これに伴い本パッケージも Creators API に移行ししている。したがって，このページの内容は既に obsolete となっている。

詳しくはリポジトリの README を参照のこと。

本パッケージは Amazon Product Advertising API v5 へアクセスできる Go 言語用クライアント・パッケージだ。 API を通じて Amazon で取り扱っている商品の情報を取得できる。

なお paapi5 パッケージは Go 1.16 以上を要求する。ご注意を。

インポート

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

簡単な使い方

PA-API アクセス用のパラメータ

使い方の前に，この記事で使用する PA-API アクセス用のパラメータを以下に例示しておく。

パラメータ名	値
マーケットプレイス	`www.amazon.co.jp`
アソシエイト・タグ	`mytag-20`
アクセス・キー	`AKIAIOSFODNN7EXAMPLE`
シークレット・キー	`1234567890`

もちろん実際には使えないのでご安心を（笑）

サンプル・コード

以下に簡単なコード例を示す。

package main

import (
    "bytes"
    "fmt"
    "io"
    "os"

    paapi5 "github.com/goark/pa-api"
    "github.com/goark/pa-api/query"
)

func main() {
    //Create client
    client := paapi5.New(
        paapi5.WithMarketplace(paapi5.LocaleJapan),
    ).CreateClient(
        "mytag-20",
        "AKIAIOSFODNN7EXAMPLE",
        "1234567890",
        paapi5.WithHttpClient(&http.Client{}),
    )

    //Make query
    q := query.NewGetItems(
		client.Marketplace(),
		client.PartnerTag(),
		client.PartnerType(),
	).
		ASINs([]string{"B07NVMYB7K"}).
		EnableItemInfo().
		EnableImages().
		EnableParentASIN()

    //Requet and response
    body, err := client.Request(q)
    if err != nil {
        fmt.Printf("%+v\n", err)
        return
    }
    io.Copy(os.Stdout, bytes.NewReader(body))
}

このコードの実行結果はこんな感じ。

$ go run sample.go | jq .
{
  "ItemsResult": {
    "Items": [
      {
        "ASIN": "B07YCM5K55",
        "DetailPageURL": "https://www.amazon.co.jp/dp/B07YCM5K55?tag=mytag-20&linkCode=ogi&th=1&psc=1",
        "Images": {
          "Primary": {
            "Large": {
              "Height": 500,
              "URL": "https://m.media-amazon.com/images/I/51Ef9EF+HaL.jpg",
              "Width": 352
            },
            "Medium": {
              "Height": 160,
              "URL": "https://m.media-amazon.com/images/I/51Ef9EF+HaL._SL160_.jpg",
              "Width": 113
            },
            "Small": {
              "Height": 75,
              "URL": "https://m.media-amazon.com/images/I/51Ef9EF+HaL._SL75_.jpg",
              "Width": 53
            }
          }
        },
        "ItemInfo": {
          "ByLineInfo": {
            "Contributors": [
              {
                "Locale": "ja_JP",
                "Name": "宮成楽",
                "Role": "著"
              }
            ],
            "Manufacturer": {
              "DisplayValue": "竹書房",
              "Label": "Manufacturer",
              "Locale": "ja_JP"
            }
          },
          "Classifications": {
            "Binding": {
              "DisplayValue": "Kindle版",
              "Label": "Binding",
              "Locale": "ja_JP"
            },
            "ProductGroup": {
              "DisplayValue": "Digital Ebook Purchas",
              "Label": "ProductGroup",
              "Locale": "ja_JP"
            }
          },
          "ContentInfo": {
            "Languages": {
              "DisplayValues": [
                {
                  "DisplayValue": "日本語",
                  "Type": "発行済み"
                }
              ],
              "Label": "Language",
              "Locale": "ja_JP"
            },
            "PagesCount": {
              "DisplayValue": 116,
              "Label": "NumberOfPages",
              "Locale": "en_US"
            },
            "PublicationDate": {
              "DisplayValue": "2019-09-27T00:00:00.000Z",
              "Label": "PublicationDate",
              "Locale": "en_US"
            }
          },
          "ProductInfo": {
            "IsAdultProduct": {
              "DisplayValue": false,
              "Label": "IsAdultProduct",
              "Locale": "en_US"
            },
            "ReleaseDate": {
              "DisplayValue": "2019-09-27T00:00:00.000Z",
              "Label": "ReleaseDate",
              "Locale": "en_US"
            }
          },
          "TechnicalInfo": {
            "Formats": {
              "DisplayValues": [
                "Kindle本"
              ],
              "Label": "Format",
              "Locale": "ja_JP"
            }
          },
          "Title": {
            "DisplayValue": "晴れのちシンデレラ　（１２） (バンブーコミックス MOMOセレクション)",
            "Label": "Title",
            "Locale": "ja_JP"
          }
        }
      }
    ]
  }
}

リクエスト実行インスタンスの生成

上のコード例の

client := paapi5.New(
    paapi5.WithMarketplace(paapi5.LocaleJapan),
).CreateClient(
    "mytag-20",
    "AKIAIOSFODNN7EXAMPLE",
    "1234567890",
    paapi5.WithHttpClient(&http.Client{}),
)

がリクエストを実行する paapi5.Client 型のインスタンスを生成している部分である。ちなみに

client := paapi5.DefaultClient("mytag-20", "AKIAIOSFODNN7EXAMPLE", "1234567890") //Create default client

と既定値で簡単に paapi5.Client インスタンスを生成することもできるが，マーケットプレイスが米国（www.amazon.com）になるのでご注意を。

クエリの生成とリクエストの実行

リクエストを実行する関数

func (c *Client) Request(q Query) ([]byte, error)

の引数 paapi5.Query は interface 型で以下のように定義している。

type Query interface {
    Operation() Operation
    Payload() ([]byte, error)
}

paapi5.Query.Operation() 関数の返り値の paapi5.Operation 型は以下のように定義している。

type Operation int

const (
    NullOperation Operation = iota
    GetVariations
    GetItems
    SearchItems
)

paapi5.Query.Payload() 関数はリクエストのペイロードにセットする JSON データを返す。 JSON データの内容は，例えばこんな感じ。

{
 "ItemIds": [
  "B07YCM5K55"
 ],
 "Resources": [
  "Images.Primary.Small",
  "Images.Primary.Medium",
  "Images.Primary.Large",
  "ItemInfo.ByLineInfo",
  "ItemInfo.ContentInfo",
  "ItemInfo.Classifications",
  "ItemInfo.ExternalIds",
  "ItemInfo.ProductInfo",
  "ItemInfo.Title"
 ],
 "PartnerTag": "mytag-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.jp",
 "Operation": "GetItems"
}

適切な paapi5.Operation 値と JSON データを出力できるのであれば，利用者側でクエリ・オブジェクトを自由に設計できる。

余談だが…

ある型が特定の interface 型に適合するかコンパイル時点でチェックするには以下の記述を加えるとよい。

var _ paapi5.Query = (*CustomQuery)(nil)

context.Context を付けてリクエストを実行する

先ほどのリクエスト実行関数

func (c *Client) Request(q Query) ([]byte, error)

の代わりに， context.Context を引数に加えた

func (c *client) RequestContext(ctx context.Context, q Query) ([]byte, error)

メソッドを使うこともできる。

クエリの実例とレスポンスの取り込み例

paapi5 パッケージではクエリ用のサンプルとして paapi5/query サブパッケージを用意している。最初のコード例の

q := query.NewGetItems(
    client.Marketplace(),
    client.PartnerTag(),
    client.PartnerType(),
).
    ASINs([]string{"B07NVMYB7K"}).
    EnableItemInfo().
    EnableImages().
    EnableParentASIN()

の部分がそれである。また paapi5.Client.Request() 関数の出力結果を構造体に落とし込むための paapi5/entity サブパッケージも用意した。どちらもそのままではあまり使い勝手がいいとは言えないが，コード例として自由に利用していただいて構わない。

なお paapi5 パッケージは Apache License, Version 2.0 でライセンスしている。

ブックマーク

参考図書

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

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

PA-API v5 への移行

2019-10-06T06:46:03+00:00

先月の2019年9月に Amazon Product Advertising API v5 がリリースされた。

これによると 2019-11-30 までに v5 に移行する必要があるらしい。

【2020-02-08 追記】 v5 への移行期限が 2020-03-09 まで延長になったようだ。ユーザに周知されてなかったのかな（笑）

v4 では GET リクエストで XML 形式のデータを返していたが， v5 では POST リスエストで JSON 形式のデータを返す。

たとえば ASIN コード B01IGW5IIW の商品の情報を取得する場合は， POST リクエストのペイロードに

{
 "ItemIds": [
  "B07YCM5K55"
 ],
 "Resources": [
  "Images.Primary.Medium",
  "ItemInfo.ByLineInfo",
  "ItemInfo.ContentInfo",
  "ItemInfo.Classifications",
  "ItemInfo.ExternalIds",
  "ItemInfo.ProductInfo",
  "ItemInfo.Title"
 ],
 "PartnerTag": "mytag-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.jp",
 "Operation": "GetItems"
}

とクエリをセットして送信すると

{
 "ItemsResult": {
  "Items": [
   {
    "ASIN": "B07YCM5K55",
    "DetailPageURL": "https://www.amazon.co.jp/dp/B07YCM5K55?tag=mytag-20&linkCode=ogi&th=1&psc=1",
    "Images": {
     "Primary": {
      "Medium": {
       "Height": 160,
       "URL": "https://m.media-amazon.com/images/I/51Ef9EF+HaL._SL160_.jpg",
       "Width": 113
      }
     }
    },
    "ItemInfo": {
     "ByLineInfo": {
      "Contributors": [
       {
        "Locale": "ja_JP",
        "Name": "宮成楽",
        "Role": "著"
       }
      ],
      "Manufacturer": {
       "DisplayValue": "竹書房",
       "Label": "Manufacturer",
       "Locale": "ja_JP"
      }
     },
     "Classifications": {
      "Binding": {
       "DisplayValue": "Kindle版",
       "Label": "Binding",
       "Locale": "ja_JP"
      },
      "ProductGroup": {
       "DisplayValue": "Digital Ebook Purchas",
       "Label": "ProductGroup",
       "Locale": "ja_JP"
      }
     },
     "ContentInfo": {
      "Languages": {
       "DisplayValues": [
        {
         "DisplayValue": "日本語",
         "Type": "発行済み"
        }
       ],
       "Label": "Language",
       "Locale": "ja_JP"
      },
      "PagesCount": {
       "DisplayValue": 116,
       "Label": "NumberOfPages",
       "Locale": "en_US"
      },
      "PublicationDate": {
       "DisplayValue": "2019-09-27T00:00:00.000Z",
       "Label": "PublicationDate",
       "Locale": "en_US"
      }
     },
     "ProductInfo": {
      "IsAdultProduct": {
       "DisplayValue": false,
       "Label": "IsAdultProduct",
       "Locale": "en_US"
      },
      "ReleaseDate": {
       "DisplayValue": "2019-09-27T00:00:00.000Z",
       "Label": "ReleaseDate",
       "Locale": "en_US"
      }
     },
     "Title": {
      "DisplayValue": "晴れのちシンデレラ　（１２） (バンブーコミックス MOMOセレクション)",
      "Label": "Title",
      "Locale": "ja_JP"
     }
    }
   }
  ]
 }
}

などとレスポンスが返る。クエリ JSON の Resources フィールドで欲しい情報をかなり細かく指定できるのが特徴である。

Java と PHP については SDK が用意されている。ぶっちゃけ何の参考にもならなかったが（笑）

PA-API v5 を試すのであれば Scratchpad が便利だ。実際の動作を確認でき Java, PHP, curl のサンプルコードも見れるようになっている。 Java コードはブラックボックスだらけで全く参考にならなかったが PHP と curl のコードはかなり参考になる。

というわけで Go 言語用のパッケージを作ってみた。

spiegel-im-spiegel/pa-api: APIs for Amazon Product Advertising API v5 by Golang

自作の books-data 用に「とりあえず」で作ったので色々と不足しているのだが，基本機能は押さえてあるはず。

詳しくは以下を参照のこと。

Go 言語用 PA-API v5 クライアント・パッケージ

なお， AWS 用のアクセスキーと秘密キーは PA-API v5 からは使えなくなるらしい。使うためには PA-API 用にキーを取得する必要がある。既に PA-API 用のキーを持っているならそのまま使えるようだ。

ブックマーク

Product Advertising API 5.0 Documentation