List of Pa-Api [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); 評価

著者のひとりは（あの「バイブル」とも呼ばれる）通称 “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); 評価

版元で 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); 評価

読書会のために購入。インプレス社の本は 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); 評価

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

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

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

「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 製のツールとパッケージをまとめてアップデートした

2020-10-02T07:40:54+00:00

GitHub リポジトリにある Go 言語製のツールやパッケージについて GitHub Actions で CI (Continuous Integration) を回す目処が立ったので，設定を変更しリリースし直すことにした。今回リリースしたツール・パッケージのうち主なものは以下の通り。

若干 lint に叱られたり軽微なバグを指摘されたりしたものもあるが，機能上の追加・変更はない。

それじゃあ，次のステージに行きましょう♪

ブックマーク

参考図書

プログラミング言語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)

射手座☆午後九時Don't be late: シェリル・ノーム starring May'n (メインアーティスト); FlyingDog 2008-05-08 (Release 2017-01-16); MP3 ダウンロード; B01MZ8UA8O (ASIN); 評価

移動中に聴くとノリノリになれる（笑）

reviewed by Spiegel on 2020-10-02 (powered by PA-APIv5)

エラーハンドリング・パッケージ errs v1.0.0 他のリリース【Go 1.15 リリース記念】

2020-08-13T00:48:44+00:00

この前 v0.7.0 を出したばかりだが，予告したとおり， Go 1.15 リリースを記念して spiegel-im-spiegel/errs パッケージのメジャー・バージョンを上げることにした。

Release v1.0.0 · spiegel-im-spiegel/errs · GitHub

機能追加なし。不具合修正もなし。 go.mod と Travis CI の設定を変更して Go 1.15 に対応させただけの簡単なお仕事デス。

今後は後方互換性をきちんと考えて改修していく予定です m(_ _)m

ついでに spiegel-im-spiegel/errs パッケージを利用している主なパッケージやツールもバージョンを上げた。

基本的には spiegel-im-spiegel/errs パッケージのバージョンを上げただけ。まぁ v0.7.0 で後方互換性をぶっ壊しているので，手直しが多かったけど（笑）

32ビット・バイナリの提供を止めました

gpgpdump, books-data, gnkf, mklink の各ツールはバイナリでの提供も行っているが，今回から32ビット・バイナリの提供を止めることにした（ARM アーキテクチャを除く）。

きっかけは Go 1.15 で darwin/386 のサポートが終了したこと。

As announced in the Go 1.14 release notes, Go 1.15 drops support for 32-bit binaries on macOS, iOS, iPadOS, watchOS, and tvOS (the darwin/386 and darwin/arm ports). Go continues to support the 64-bit darwin/amd64 and darwin/arm64 ports.

via Go 1.15 Release Notes - The Go Programming Language

クロスコンパイルは GoReleaser を使ってるのでそんなに面倒ではないんだけど… もう32ビット流行らんべ。 Windows で古い32ビット機を（しかも拙作を）使ってる人は多分いないだろうし Ubuntu も最新 LTS では遂に32ビット・アーキテクチャのサポートを終了したしね。

まぁ Pure Go で書いてるのでダウンロード&ビルドは難しくないし，たいした問題ではないだろう，うんうん。

ブックマーク

参考図書

プログラミング言語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 言語用 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); 評価