# 楽々おまかせリンクをバージョンアップしました(楽天 API の OR 検索に対応) - URL: https://www.drk7.jp/MT/archives/001198.html - 公開: 2007.03.25 - カテゴリ: drk7jp-Webサービス - 著者: drk ![楽々おまかせリンクをバージョンアップしました(楽天 API の OR 検索に対応)のイメージ(挿絵)](https://www.drk7.jp/media/opt/posts/001198/illust.jpg.w1600.webp) 結構頻繁に update されている楽天 API ですが、楽天 API をお使いのみなさま、情報を追いかけておりますでしょうか? 僕は情報を追いかけてはいたのですが、更新する時間が全然なくて、楽々おまかせリンクのメンテを放置してきました。この度、見た目は何ら変化しない地味なバージョンアップをしました。 ## 楽天 API に OR 検索が追加された [楽天ウェブサービスセンターブログで 2007.03.22 に公開された情報](http://plaza.rakuten.co.jp/webservice/diary/200703220002/)なのですが > 楽天市場関係のAPIへの機能追加 > > 以下のAPIで、「OR検索」機能、「除外キーワード」機能を追加をしました。 > > - 楽天商品検索API > - 楽天書籍検索API > - 楽天CD検索API > - 楽天DVD検索API > - 楽天カタログ検索API > > 「OR検索」では、複数キーワードが設定された場合に、AND検索・OR検索のいずれかが選択可能となりました。また、検索結果から除外したいキーワードを「除外キーワード」として指定することで、これまで以上にデベロッパーのニーズに沿った検索が可能となりました。 この OR 検索の実装が、非常に意味がある機能なのです。楽天 API が登場したての頃に、OR 検索がどうしても欲しいとメールを出したことがあるのですが、ついに実現されました。 ## 3つの特徴語を OR 検索するように変更 [楽々おまかせリンクのアルゴリズム説明](https://www.drk7.jp/MT/archives/001183.html)のところにも記載されていますが、 > 特徴語を用いて楽天ウェブサービスにリクエストを投げて商品情報を取得します。検索がヒットしない場合は、ランキング情報を代替情報として用います。 > > 現時点で楽天ウェブサービスがキーワードの OR 条件をサポートしていないため、1つの単語のみで検索をしています。※OR 検索が実装されれば精度が飛躍的に上がるとおもう・・・ の部分を変更しました。同時に3つの特徴語を OR 検索するようにしました。これによって、飛躍的に精度向上を図ることができました。 sort オプションも指定可能なので、random あたりが検索結果的におもしろい結果になるような気がします。もっとも random を指定しても毎回ランダムになるわけではなく、楽天 API 側でキャッシュされているっぽいので、ある一定期間は同じ結果しか返ってこないっぽいですが。 ## OR 検索のリクエスト方法 あ、ちなみに OR 検索のリクエスト方法はドキュメントに何も書かれていませんが、keyword フィールドに半角スペースでキーワードをつなげてリクエストすれば OK のようです。OR とかを連結文字列に使う必要はないみたいです。キーワードの順序による優先順位はないみたいです。 - リクエスト例1:[oracle OR mysql OR postgresql](http://api.rakuten.co.jp/rws/1.5/rest?operation=ItemSearch&version=2007-03-14&orFlag=1&&developerId=7cd22fe67ebe6ee6b5cfe25084c9f335&affiliateId=04041de8.e0d1ab1e.04041de9.6f5fc9ed&genreId=0&keyword=oracle%20mysql%20postgresql&sort=-reviewCount)⁠(現在リンク切れ) - リクエスト例2:[mysql OR oracle OR postgresql](http://api.rakuten.co.jp/rws/1.5/rest?operation=ItemSearch&version=2007-03-14&orFlag=1&&developerId=7cd22fe67ebe6ee6b5cfe25084c9f335&affiliateId=04041de8.e0d1ab1e.04041de9.6f5fc9ed&genreId=0&keyword=mysql%20oracle%20postgresql&sort=-reviewCount)⁠(現在リンク切れ) どちらの例も、keyword を半角スペース(URL 上は `%20`)でつなぎ、`orFlag=1` を付けてリクエストしています。 以上、バージョンアップのお知らせでした。