Keepa APIのリクエストの1つ、「Graph Image API」の公式レファレンスを日本語訳しました。
Keepaの価格変動やランキング推移のグラフ画像を取得するAPIです。
…が、実はKeepaに有料登録している人はトークン消費なくほぼ同等の画像を取得できます。
詳しく知りたい人は以下の記事をご参考ください。
ということで、Keepa無料会員にランキング推移のグラフを提供したい！というニーズがある際に使用することになるかと思います。
それでは、↓から日本語訳スタートです！
- 「参考」で囲った部分は筆者の補足です。
- 適宜サブタイトルの追加や、意訳を実施しています。
- Keepaから翻訳の許可を頂いております。
こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！
リクエストの基本情報
消費トークン
1トークン / 1画像
製品の価格履歴グラフ イメージを PNG 形式で取得します。
グラフ イメージは、ユーザーごとに 90 分間キャッシュされます。
パラメータが変更されると、キャッシュは無効になります。
この時間内にまったく同じリクエストを送信しても、トークンは消費されません。
重要:
画像を直接埋め込まないようにしてください。
API キーが公開され、悪用される可能性があります。
これは常に避けるべきです。
グラフ イメージ リクエストをプロキシの背後に置くようにしてください。
リクエストのQueryパラメータ
/graphimage?key=<yourAccessKey>&domain=<domainId>&asin=<ASIN>- <yourAccessKey>
APIキー - <domainId>
アクセスする Amazon ロケールの整数値。
有効な値:
[ 1: com | 2: co.uk | 3: de | 4: fr | 5: co.jp | 6: ca | 8: it | 9: es | 10: in | 11: com.mx ] - <ASIN>
商品のASIN。
リクエストの追加パラメータ詳細
amazon
アマゾンの価格グラフ。
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 1
値の例： &amazon=1
new
新品価格グラフ。
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 1
値の例： &new=1
used
中古価格グラフ。
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &used=0
salesrank
売上ランキンググラフ。
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &salesrank=0
bb
カート価格グラフを購入します。
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &bb=1
fba
新品サードパーティの FBA価格グラフ。
※筆者注 Amazon以外のFBAセラーの販売価格のこと
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &fba=0
fbm
新品FBM価格グラフ。
※筆者注 自社配送セラー(FBA以外)の販売価格のこと
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &fbm=0
ld
ライトニング ディールの価格グラフ。
※筆者注 おそらく日本でいうタイムセールのこと
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &ld=1
wd
Warehouse Dealsの価格グラフ。
※筆者注 おそらく日本でいうAmazonアウトレットのこと
有効な値: 1 (描画)、0 (描画しない)。
デフォルト値: 0
値の例： &wd=1
range
チャートの日付範囲。
推奨値 (日数): 1、2、7、31、90、365。
デフォルト値: 90
値の例： &range=90
yzoom
クローズアップ ビュー (y 軸ズーム) を有効にするかどうか
有効な値: 1 (ズーム)、0 (ズームなし)。
デフォルト値: 1
値の例： &yzoom=0
width
グラフ イメージの幅 (ピクセル単位)。
300 から 1000 の間である必要があります。
デフォルト値: 500
値の例： &width=500
height
グラフ イメージの高さ (ピクセル単位)。
150 から 1000 の間である必要があります。
デフォルト値: 200
値の例： &height=200
リクエストの追加パラメータ詳細(配色関係)
次のパラメータを使用して、色をカスタマイズできます。
すべての色パラメータは、「ff0000」などの 16 進数コードです。
色パラメータはオプションです。
cBackground
チャートの背景色。
値の例： &cBackground=ffffff
cFont
フォントの色。
値の例： &cFont=444444
cAmazon
Amazon価格グラフの色。
値の例： &cAmazon=FFA500
cNew
新品価格グラフの色。
値の例： &cNew=8888dd
cUsed
中古価格グラフの色。
値の例： &cUsed=444444
cSales
売上ランキンググラフの色。
値の例： &cSales=3a883a
cFBA
FBA価格グラフの色。
値の例： &cFBA=ff5722
cFBM
FBM価格グラフの色。
値の例： &cFBM=039BE5
cBB
カート価格グラフの色。
値の例： &cBB=ff00b4
cLD
ライトニング ディール(タイムセール)の価格グラフの色。
値の例： &cLD=ff0000
cWD
Warehouse Deal (Amazonアウトレット)の価格グラフの色。
値の例： &cWD=9c27b0
以上です！
