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
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 周りの情報を知っておられる方は是非教えてください。

ブックマーク

参考図書

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

著者のひとりは(あの「バイブル」とも呼ばれる)通称 “K&R” の K のほうである。この本は Go 言語の教科書と言ってもいいだろう。

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