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

no extension

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

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

ありがたや 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.

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

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

ブックマーク

参考図書

photo
プログラミング言語Go
アラン・ドノバン (著), ブライアン・カーニハン (著), 柴田芳樹 (著)
丸善出版 2016-06-20 (Release 2021-05-21)
Kindle版
B094PRR7PZ (ASIN)
評価     

Kindle 版出た! 一部内容が古びてしまったが,この本は Go 言語の教科書と言ってもいいだろう。感想はこちら

reviewed by Spiegel on 2021-05-22 (powered by PA-APIv5)