[観] 楽天の XML Web サービスその2

« Blog クライアントを使って Vox に投稿できるのかと思いきや…… | トップページ | Vox の Atom API »

2006.09.14

楽天の XML Web サービスその2

今までずっと「楽天ブックス」のみだった楽天市場の Web サービスですが、ようやく楽天市場本体も対象になったみたいです。「楽天ブックス」の Webサービスが始まったのが2004年5月ですから、楽天市場全体に広がるまでに2年以上もかかったことになります。

「頻繁に商品情報を更新するのも面倒だし、
　商品情報が自動で更新されるツールがあったらな～」
という声にお応えしまして楽天アフィリエイトでは、
商品が自動更新されるランキング市場リンクをリリースしました
自動更新で手間いらず。ランキング市場リンクが登場！ - 楽天アフィリエイト事務局ブログ - 楽天ブログ（Blog）

ランキング市場のアフィリエイトリンクが登場しました！商品情報はランキング市場と連動しているので売れ筋情報を探す手間が省けます。そのうえ一度リンクを貼ったら更新する手間も不要です、さあリンクを貼ってスーパーポイントを稼ごう！
【楽天アフィリエイト】日本最大級のアフィリエイトプログラム: 自動更新の便利ツールランキング市場リンク登場!

というのを見て、「楽天ブックス」の売り上げランキングを取得・表示する XML Webサービスに似ているな、と思いました。どんな(Webページ貼り付け用)コードが生成されるのか知りたいので、試しに「おもちゃ・ホビー・ゲーム」のランキング市場のコードを取得してみました。生成されたコードは、以下のような感じ。

<script type='text/javascript' src='http://xml.affiliate.rakuten.co.jp/?type=js&service=ichiba&hash=0008a695.5601c7dd&genre=hobby&num=5&p=2_FF7E00_FFFFFF_FFF7D2_0000FF'></script>

http://xml.affiliate.rakuten.co.jp/ というのは、楽天ブックスの Webサービス(のエンドポイントURL)と同じですね。楽天自身は、今回の新サービスを「ランキング市場リンク」と言っているだけで、Webサービスであるとは一言も言っていませんが、これは Webサービスだと断定してしまっていいでしょう。

やっぱり、Webサービスが楽天市場全体に広がったものと考えてよさそうです。ちなみに、type=js の代わりに type=html を指定すると、JavaScript ではなく、html ソース(<table> の嵐ですが)が得られます。残念ながら、「楽天ブックス」では利用可能な type=xml は、楽天市場ではサポートされてないようです。

以下、http://xml.affiliate.rakuten.co.jp/ に渡すパラメータの意味を推定してみました。あくまでも私個人の推定なので、楽天に質問したり、問い合わせたりするのは控えてください。

楽天 Webサービスのパラメータ

エンドポイント URL http://xml.affiliate.rakuten.co.jp/ に対し、以下のパラメータを指定して、GET リクエストを発行すると、求める応答が返ってきます。

type=生成するコードの種類
- js: JavaScript
  ただし、service=books 指定時は、type=js の場合も type=html と同じ html ソースが生成される
- html : HTML
- xml: XML
  service=books 指定時のみ有効
service=対象サービス
- books: 楽天ブックス
- ichiba: 楽天市場全体
hash=アフィリエイトID
正確には「アフィリエイトID」ではなく、アフィリエイターを特定するためのハッシュコード(前半)と謎のコード(後半)を合体させたもの。「謎のコード」の正体は、楽天の中の人しかわからないんじゃないかと思います。
genre=ジャンル
- service=books の場合
  - 0: 総合
  - 1: コミック・ジュブナイル
  - 2: 語学・就職・資格試験
  - 3: 絵本・児童書
  - 4: 文芸・ノンフィクション
  - 5: ＰＣ・システム開発
  - 6: ビジネス・経済・経営
  - 7: 旅行・紀行・アウトドア
  - 8: 学問がわかる本
  - 9: ホビー・スポーツ
  - 10: ライフスタイル
  - 11: エンターテイメント
  - 12: 専門書・学術書
  - 13: 写真集・タレント
- service=ichiba の場合
  - all: 総合ランキング
  - fashion: ファッション・アパレル・靴
  - fashiongoods: バッグ・小物・ブランド雑貨
  - accessories: ジュエリー・腕時計
  - gourmet: グルメ（食品）
  - drink: グルメ（ドリンク）
  - wine: ワイン
  - computer: パソコン・周辺機器
  - electronics: 家電・AV・カメラ
  - sports: スポーツ・アウトドア
  - interior: インテリア・寝具
  - daily: キッチン・日用品雑貨・文具
  - health: ダイエット・健康
  - beauty: 美容・コスメ・香水
  - baby: キッズ・ベビー・マタニティ
  - flower: フラワー・ガーデン
  - pet: ペット・ペットグッズ
  - hobby: おもちゃ・ホビー・ゲーム
  - media: CD・DVD・楽器
  - auto: 車・バイク
  - golf: ゴルフ
num=表示件数
「表示件数」は 1 ～ 10 の範囲で指定 (10 より大きな値を指定すると 10 を指定したものとみなされるようです)
p=表示パターン・配色
『service=ichiba』かつ『type=html または type=js』のときのみ有効。
pp_aaaaaa_bbbbbb_cccccc_dddddd (pp は10進表記、aaaaaa ～ dddddd は16進表記)、例えば、 2_FF7E00_FFFFFF_FFF7D2_0000FF のように指定。
最初の pp は最終的に表示される html のパターンで、1～10 を指定。 aaaaaa は「タイトルの背景色」、bbbbbb は「タイトルのテキスト色」、cccccc は「タイトル以外の背景色」、dddddd は「テキストリンク色」を意味します。