rakuten 0.1.0

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+spec/ids.rb
+*~

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in rakuten.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    rakuten (0.1.0)
+      activesupport
+      i18n
+      json (>= 1.4.6)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.3)
+    diff-lcs (1.1.2)
+    i18n (0.5.0)
+    json (1.4.6)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  i18n
+  json (>= 1.4.6)
+  rakuten!
+  rspec (>= 2.3.0)

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Tomonori Kusanagi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# rakuten : Simple Rakuten API client for Ruby
+
+シンプルな楽天APIクライアント.
+Ruby 1.8.7, 1.9.2 で動作確認.
+
+## インストール
+
+    % gem install rakuten
+
+## SYNOPSYS
+
+[楽天WEB SERVICE](http://webservice.rakuten.co.jp/) の各種APIを簡単に使うための gem です.
+文字コードには UTF-8 を使用してください.
+
+## サンプル
+
+### 楽天市場系API, 楽天ブックス系API, 楽天オークション系API
+
+以下のようにして、楽天WEB SERVICE APIを呼び出すことができます.
+
+    client = Rakuten::Client.new('DEVELOPER_ID', 'AFFILIATE_ID(オプション)')
+    result = client.item_search('2010-09-15', {:keyword => '福袋', :sort => '+itemPrice'})
+
+Rakuten::Client オブジェクトに対して呼び出すメソッド名は、楽天APIの operation パラメーターの名前を小文字にしてアンダースコアでつないだ者です.  
+例えば、楽天商品検索API(operation名は"ItemSearch")の呼び出しの場合、メソッド名は "item_search" になります.  
+第一引数は、APIのバージョンです. APIのバージョンは、operation 毎に異なりますので注意してください.  
+楽天WEB SERVICE API に送信するパラメーター(operationとversionを除く)は、ハッシュにした上で第二引数としてメソッドに渡してください.  
+APIのバージョンやパラメーターについては、楽天WEB SERVICEの [ドキュメント](http://webservice.rakuten.co.jp/) を参照してください.
+
+結果は、レスポンスJSONからハッシュの形で取得します. 
+
+    cnt = result['count']
+    items = result['Items']['Item']
+
+形式は呼び出したAPIによって様々です. 楽天WEB SERVICEの [ドキュメント](http://webservice.rakuten.co.jp/) の、各APIの解説にある出力パラメーターの欄を参照してください.
+
+エラーが発生した場合は、Rakuten::ApiError が発生します.
+Rakuten::ApiError から、エラーの種類とメッセージを取得することができます.
+
+その他のAPIの呼び出し例については、[spec](https://github.com/xanagi/rakuten/blob/master/spec/rakuten_spec.rb) を参照してください.
+
+### 楽天トラベル系API
+
+楽天トラベル系APIは、以下のように Rakuten::TravelClient を使って呼び出します.
+
+    client = Rakuten::TravelClient.new('DEVELOPER_ID', 'AFFILIATE_ID(オプション)')
+    result = client.simple_hotel_search('2009-10-20', {:largeClassCode => 'japan', 
+                                                       :middleClassCode => 'akita', 
+                                                       :smallClassCode => 'tazawa'})
+使い方は、Rakuten::Client と同じです.  
+その他のAPIの呼び出し例については、[spec](https://github.com/xanagi/rakuten/blob/master/spec/rakuten_travel_spec.rb) を参照してください.
+
+### 楽天ダイナミックアドAPI, 楽天ダイナミックアドAPIトラベル
+
+楽天ダイナミックアドAPI, 楽天ダイナミックアドAPIトラベルを呼び出す場合には、Rakuten::DynamicAdClient を使います.
+
+    # 楽天ダイナミックアドAPI
+    client = Rakuten::DynamicAdClient.new('DEVELOPER_ID', 'AFFILIATE_ID(オプション)')
+    result = client.dynamic_ad(nil, {:url => 'http://plaza.rakuten.co.jp/isblog/diary/200705230001/'})
+
+    # 楽天ダイナミックアドAPIトラベル
+    client = Rakuten::DynamicAdClient.new('DEVELOPER_ID', 'AFFILIATE_ID(オプション)')
+    result = client.dynamic_ad_travel(nil, {:url => 'http://plaza.rakuten.co.jp/travelblog02/diary/200706140000/'})
+
+
+## ライセンス
+
+The MIT License

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/rakuten/version.rb

@@ -0,0 +1,3 @@
+module Rakuten
+  VERSION = "0.1.0"
+end

data/lib/rakuten.rb

@@ -0,0 +1,122 @@
+# -*- coding: utf-8 -*-
+# = Rakuten
+#   シンプルな楽天APIクライアント.
+#
+require 'cgi'
+require 'open-uri'
+require 'active_support/inflector'
+require 'json'
+require 'i18n'
+
+module Rakuten
+  class Client
+    attr_reader :raw_response
+
+    def initialize(developer_id, affiliate_id = nil)
+      @developer_id, @affiliate_id = developer_id, affiliate_id
+    end
+
+    # リクエストを実行して結果を返す.
+    # 結果はJSONをパーズしたHash.
+    # リクエストに失敗したら例外をスローする.
+    def request(operation, version = nil, params = {})
+      response = open(request_url(operation, version, params)) do |f|
+        @raw_response = f.read
+        JSON.parse(@raw_response)
+      end
+      unless response['Header']['Status'] == 'Success'
+        raise ApiError.new(response['Header']['Status'], response['Header']['StatusMsg']) 
+      end
+      extract_result(response, operation)
+    end
+
+    # リクエストURLを返す.
+    def request_url(operation, version = nil, params = {})
+      url = "#{host(operation)}?developerId=#{@developer_id}&operation=#{operation}&version=#{version}"
+      url += "&affiliateId=#{@affiliate_id}" if @affiliate_id && @affiliate_id != ''
+      if params
+        params.each do |k, v|
+          url += "&#{k}=" + CGI::escape(v.to_s)
+        end
+      end
+      #puts url
+      url
+    end
+
+    # リクエスト送信先ホストを返す.
+    def host(operation)
+      'http://api.rakuten.co.jp/rws/3.0/json'
+    end
+
+    # レスポンスから結果データを抽出する.
+    def extract_result(response, operation)
+      # Body の子要素は通常は操作名をキーとする要素1つだけのハッシュだが、
+      # ProductPriceInfo の場合だけは、キーがItemSearchになっている(バグ?).
+      #puts "#{operation}: #{response['Body'].keys.to_s}"
+      response['Body'].values[0]
+      #response['Body'][operation]
+    end
+
+    # 楽天APIにリクエストを送信する.
+    # メソッド名が item_ranking であれば、camel case に変換した上で操作名としてリクエストに含める.
+    # 第1引数はバージョン文字列、第2引数はパラメターHashであるとする.
+    def method_missing(method_id, *params)
+      request(method_id.id2name.camelize, params[0], params[1])
+    end
+  end
+
+  # 楽天トラベル用APIクライアント
+  class TravelClient < Client
+    def host(operation)
+      if ['GetAreaClass', 'GetHotelChainList', 'HotelRanking'].include? operation
+        'http://api.rakuten.co.jp/rws/2.0/json'
+      else
+        super
+      end
+    end
+
+    def extract_result(response, operation)
+      if ['VacantHotelSearch'].include? operation
+        response['Body']
+      else
+        super
+      end
+    end
+  end
+
+  # 楽天ダイナミックアド用APIクライアント
+  class DynamicAdClient < Client
+    def request_url(operation, version = nil, params = {})
+      url = case(operation)
+            when 'DynamicAd'
+              'http://dynamic.rakuten.co.jp/rcm/1.0/i/json'
+            when 'DynamicAdTravel'
+              'http://dynamic.rakuten.co.jp/rcm/1.0/t/json'
+            end
+      url += "?developerId=#{@developer_id}"
+      url += "&affiliateId=#{@affiliate_id}" if @affiliate_id && @affiliate_id != ''
+      if params
+        params.each do |k, v|
+          url += "&#{k}=" + CGI::escape(v.to_s)
+        end
+      end
+      #puts url
+      url
+    end
+
+    def extract_result(response, operation)
+      response['Body']
+    end
+  end
+
+  class ApiError < StandardError
+    attr_reader :status, :message
+    def initialize(status, message)
+      @status, @message = status, message
+    end
+
+    def to_s
+      "#{self.status}:#{self.message}"
+    end
+  end
+end

data/rakuten.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "rakuten/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rakuten"
+  s.version     = Rakuten::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Tomonori Kusanagi"]
+  s.email       = ["kusanagi@banana-systems.com"]
+  s.homepage    = "https://github.com/xanagi/rakuten"
+  s.summary     = %q{Simple Rakuten API client.}
+  s.description = %q{Simple Rakuten API client.}
+
+  s.add_dependency "i18n"
+  s.add_dependency "activesupport"
+  s.add_dependency "json", ">=1.4.6"
+  s.add_development_dependency "rspec", ">=2.3.0"
+
+  s.rubyforge_project = "rakuten"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/ids.rb.sample

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+# テストを実行するには、デベロッパーIDとアフィリエイトIDを書き換え、ids.rb という名前で保存してください.
+DEVELOPER_ID = 'Your developer id'
+AFFILIATE_ID = 'Your affiliate id'

data/spec/rakuten_dynamic_ad_spec.rb

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+require 'rakuten'
+require 'date'
+require 'pp'
+require File.dirname(__FILE__) + '/ids.rb'
+
+# see http://webservice.rakuten.co.jp/document/index.html
+
+# テストを実行するには、ids.rb.sample のデベロッパーIDとアフィリエイトIDを書き換え、
+# ids.rb という名前で保存してください.
+describe Rakuten::DynamicAdClient do
+
+  before(:all) do
+    @developer_id = DEVELOPER_ID
+    @affiliate_id = AFFILIATE_ID
+    @client = Rakuten::DynamicAdClient.new(@developer_id, @affiliate_id)
+  end
+
+  it "楽天ダイナミックアドAPIの呼び出しが可能であること" do
+    result = @client.dynamic_ad(nil, {:url => 'http://plaza.rakuten.co.jp/isblog/diary/200705230001/'})
+    result['Ads']['Ad'].should_not be_empty
+  end
+
+  it "楽天GORAダイナミックAPIトラベルの呼び出しが可能であること" do
+    result = @client.dynamic_ad_travel(nil, {:url => 'http://plaza.rakuten.co.jp/travelblog02/diary/200706140000/'})
+    result['Ads']['Ad'].should_not be_empty
+  end
+
+end

data/spec/rakuten_spec.rb

@@ -0,0 +1,242 @@
+# -*- coding: utf-8 -*-
+require 'rakuten'
+require 'date'
+require 'pp'
+require File.dirname(__FILE__) + '/ids.rb'
+
+# see http://webservice.rakuten.co.jp/document/index.html
+
+# テストを実行するには、ids.rb.sample のデベロッパーIDとアフィリエイトIDを書き換え、
+# ids.rb という名前で保存してください.
+describe Rakuten::Client do
+
+  before(:all) do
+    @developer_id = DEVELOPER_ID
+    @affiliate_id = AFFILIATE_ID
+    @client = Rakuten::Client.new(@developer_id, @affiliate_id)
+  end
+
+  it "API URLを正しく構築できること" do
+    url = @client.request_url('ItemRanking', '2010-08-05', {})
+    url.should == "http://api.rakuten.co.jp/rws/3.0/json?developerId=#{@developer_id}&operation=ItemRanking&version=2010-08-05&affiliateId=#{@affiliate_id}"
+  end
+
+  it "developerIdが無効であれば、例外が発生すること" do
+    client = Rakuten::Client.new('invalid_developer_id')
+    lambda{client.item_ranking('2010-08-15')}.should raise_error(Rakuten::ApiError)
+  end
+
+  it "versionが不正であれば、例外が発生すること" do
+    lambda{@client.item_ranking('2010-08-01')}.should raise_error(Rakuten::ApiError)
+  end
+
+  #
+  # 楽天市場系API
+  #
+
+  it "楽天商品検索APIを呼び出し可能であること" do
+    result = @client.item_search('2010-09-15', {:keyword => '福袋', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_nil
+  end
+
+  it "モバイル用の呼び出しが可能であること" do
+    result = @client.item_search('2010-09-15', {:keyword => '福袋', :carrier => 1})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_nil
+  end
+
+  it "楽天ジャンル検索APIの呼び出しが可能であること(ルートレベル)" do
+    result = @client.genre_search('2007-04-11', {:genreId => 0})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 1
+    result['child'][0]['genreName'].should_not be_nil
+    result['child'][0]['genreId'].should_not be_nil
+  end
+
+  it "楽天ジャンル検索APIの呼び出しが可能であること(食品ジャンル)" do
+    result = @client.genre_search('2007-04-11', {:genreId => 100227})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 2
+    result['child'][0]['genreName'].should_not be_nil
+    result['child'][0]['genreId'].should_not be_nil
+  end
+
+  it "楽天商品コード検索APIの呼び出しが可能であること" do
+    sample = @client.item_search('2010-09-15', {:keyword => '福袋', :hits => 1})
+    item_code = sample['Items']['Item'][0]['itemCode']
+    # 楽天商品コード検索API呼び出し.
+    result = @client.item_code_search('2010-08-05', {:itemCode => item_code})
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天カタログ検索APIの呼び出しが可能であること" do
+    result = @client.catalog_search('2009-04-15', {:keyword => '液晶テレビ', :sort => '-reviewCount'})
+    (result['count'] > 0).should be_true
+    result['Catalogs']['Catalog'].should_not be_empty
+  end
+
+  it "楽天商品ランキングAPIの呼び出しが可能であること" do
+    result = @client.item_ranking('2010-08-05')
+    result['title'].should_not be_nil
+    result['lastBuildDate'].should_not be_nil
+    result['Items']['Item'].should_not be_empty
+  end
+  
+  it "楽天プロダクト製品検索APIの呼び出しができること" do
+    result = @client.product_search('2010-11-18', {:keyword => 'ノートパソコン', :genreId => 100040})
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天プロダクト製品詳細APIの呼び出しが可能であること" do
+    sample = @client.product_search('2010-11-18', {:keyword => 'ノートパソコン', :genreId => 100040, :hits => 1})
+    product_id = sample['Items']['Item'][0]['productId']
+    # 楽天プロダクト製品詳細API呼び出し.
+    result = @client.product_detail('2010-11-18', {:productId => product_id, :detailFlag => 1})
+    result['Item'].should_not be_empty
+  end
+
+  it "楽天プロダクトジャンル情報APIの呼び出しが可能であること" do
+    result = @client.product_genre_info('2010-11-18', {:genreId => 500740, :makerHits => 10, :satisfiedHits => 5, :satisfiedPage => 3})
+    result['NewProductInformation'].should be_nil
+    result['SatisfiedInformation']['satisfier'].should_not be_empty
+    result['SellerInformation'].should be_nil
+    result['GenreInformation'].should_not be_empty
+    result['MakerInformation']['maker'].should_not be_empty
+  end
+
+  it "楽天プロダクトメーカー情報APIの呼び出しが可能であること" do
+    result = @client.product_maker_info('2010-11-18', {:makerCode => 104901780})
+    result['makerName'].should_not be_nil
+  end
+
+  it "楽天プロダクト価格比較情報APIの呼び出しが可能であること" do
+    sample = @client.product_search('2010-11-18', {:keyword => 'ノートパソコン', :genreId => 100040, :hits => 1})
+    product_id = sample['Items']['Item'][0]['productId']
+    # 楽天プロダクトか各比較情報API呼び出し.
+    result = @client.product_price_info('2010-11-18', {:productId => product_id, :availability => 1, :creditCardFlag => 1})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  #
+  # 楽天ブックス系API
+  # 
+  
+  it "楽天ブックス総合検索APIの呼び出しが可能であること" do
+    result = @client.books_total_search('2010-03-18', {:keyword => 'ガンダム', :NGKeyword => '予約', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックス書籍検索APIの呼び出しが可能であること" do
+    result = @client.books_book_search('2010-03-18', {:title => '太陽', :booksGenreId => '001004008', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックスCD検索APIの呼び出しが可能であること" do
+    result = @client.books_CD_search('2010-03-18', {:artistName => 'サザンオールスターズ', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックスDVD検索APIの呼び出しが可能であること" do
+    result = @client.books_DVD_search('2010-03-18', {:title => 'ガンダム', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックス洋書検索APIの呼び出しが可能であること" do
+    result = @client.books_foreign_book_search('2010-03-18', {:title => 'HarryPotter', :booksGenreId => '005407', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックス雑誌検索APIの呼び出しが可能であること" do
+    result = @client.books_magazine_search('2010-03-18', {:title => '週刊 経済', :booksGenreId => '007604001', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックスゲーム検索APIの呼び出しが可能であること" do
+    result = @client.books_game_search('2010-03-18', {:title => 'マリオ', :hardware => 'Wii', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックスソフトウェア検索APIの呼び出しが可能であること" do
+    result = @client.books_software_search('2010-03-18', {:title => '会計', :os => 'Mac', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天ブックスジャンル検索APIの呼び出しが可能であること" do
+    result = @client.books_genre_search('2009-03-26', {:booksGenreId => '000'})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 1
+    result['child'][0]['genreName'].should_not be_nil
+    result['child'][0]['genreId'].should_not be_nil
+  end
+
+  it "楽天ブックスジャンル検索APIの呼び出しが可能であること(DVD)" do
+    result = @client.books_genre_search('2009-03-26', {:booksGenreId => '003'})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 2
+    result['child'][0]['genreName'].should_not be_nil
+    result['child'][0]['genreId'].should_not be_nil
+  end
+
+  # 
+  # 楽天オークション系API
+  # 
+
+  it "楽天オークション商品検索APIの呼び出しが可能であること" do
+    result = @client.auction_item_search('2010-09-15', {:keyword => '福袋', :sort => '+itemPrice'})
+    (result['count'] > 0).should be_true
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天オークション商品コード検索APIの呼び出しが可能であること" do
+    sample = @client.auction_item_search('2010-09-15', {:keyword => '福袋', :hits => 1})
+    item_code = sample['Items']['Item'][0]['itemCode']
+    # 楽天オークション商品コード検索API呼び出し.
+    result = @client.auction_item_code_search('2010-09-15', {:itemCode => item_code})
+    result['Items']['Item'].should_not be_empty
+  end
+
+  it "楽天オークションジャンル検索APIの呼び出しが可能であること" do
+    result = @client.auction_genre_search('2010-09-15', {:auctionGenreId => '0'})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 1
+    result['child'][0]['auctionGenreName'].should_not be_nil
+    result['child'][0]['auctionGenreId'].should_not be_nil
+  end
+
+  it "楽天オークションジャンル検索APIの呼び出しが可能であること(レディースファッション)" do
+    result = @client.auction_genre_search('2010-09-15', {:auctionGenreId => '1010000000'})
+    result['child'].should_not be_empty
+    result['child'][0]['genreLevel'].should == 2
+    result['child'][0]['auctionGenreName'].should_not be_nil
+    result['child'][0]['auctionGenreId'].should_not be_nil
+  end
+  
+  #
+  # その他のAPI
+  #
+
+  it "楽天GORAゴルフ場検索APIの呼び出しが可能であること" do
+    result = @client.gora_golf_course_search('2010-06-30', {:keyword => '天然温泉', :sort => '50on'})
+    result['Items']['Item'].should_not be_empty
+    result['count'].should_not be_nil
+  end
+
+  it "楽天GORAゴルフ場詳細APIの呼び出しが可能であること" do
+    sample = @client.gora_golf_course_search('2010-06-30', {:keyword => '天然温泉', :hits => 1})
+    golf_course_id = sample['Items']['Item'][0]['golfCourseId']
+    # 楽天GORAゴルフ場詳細APIの呼び出し
+    result = @client.gora_golf_course_detail('2010-06-30', {:golfCourseId => golf_course_id})
+    result['Item'].should_not be_empty
+  end
+
+end

data/spec/rakuten_travel_spec.rb

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+require 'rakuten'
+require 'date'
+require 'pp'
+require File.dirname(__FILE__) + '/ids.rb'
+
+# see http://webservice.rakuten.co.jp/document/index.html
+
+# テストを実行するには、ids.rb.sample のデベロッパーIDとアフィリエイトIDを書き換え、
+# ids.rb という名前で保存してください.
+describe Rakuten::TravelClient do
+
+  before(:all) do
+    @developer_id = DEVELOPER_ID
+    @affiliate_id = AFFILIATE_ID
+    @client = Rakuten::TravelClient.new(@developer_id, @affiliate_id)
+  end
+
+  #
+  # 楽天トラベル系API
+  # 
+  
+  it "楽天トラベル施設検索APIの呼び出しが可能であること" do
+    result = @client.simple_hotel_search('2009-10-20', {:largeClassCode => 'japan', :middleClassCode => 'akita', :smallClassCode => 'tazawa'})
+    (result['pagingInfo'][0]['recordCount'] > 0).should be_true
+    result['hotel'].should_not be_empty
+
+    result = @client.simple_hotel_search('2009-10-20', {:latitude => 128440.51, :longitude => 503172.21, :searchRadius => 1})
+    (result['pagingInfo'][0]['recordCount'] > 0).should be_true
+    result['hotel'].should_not be_empty
+
+    result = @client.simple_hotel_search('2009-10-20', {:hotelNo => '2763,4624'})
+    (result['pagingInfo'][0]['recordCount'] > 0).should be_true
+    result['hotel'].should_not be_empty
+  end
+
+  it "楽天トラベル施設情報APIの呼び出しが可能であること" do
+    result = @client.hotel_detail_search('2009-09-09', {:hotelNo => '2763'})
+    result['hotel'][0]['hotelRatingInfo'].should_not be_nil
+  end
+
+  it "楽天トラベル空室検索APIの呼び出しが可能であること" do
+    result = @client.vacant_hotel_search('2009-10-20', {:largeClassCode => 'japan', :middleClassCode => 'akita', :smallClassCode => 'tazawa', :checkinDate => (Date.today + 1).to_s, :checkoutDate => (Date.today + 3).to_s, :adultNum => 2})
+    result['hotel'].should_not be_empty
+    result['pagingInfo']['recordCount'].should_not be_nil
+
+    result = @client.vacant_hotel_search('2009-10-20', {:latitude => 128440.51, :longitude => 503172.21, :searchRadius => 1, :checkinDate => (Date.today + 1).to_s, :checkoutDate => (Date.today + 3).to_s, :adultNum => 2})
+    result['hotel'].should_not be_empty
+    result['pagingInfo']['recordCount'].should_not be_nil
+
+    result = @client.vacant_hotel_search('2009-10-20', {:hotelNo => '2763,4624', :checkinDate => (Date.today + 1).to_s, :checkoutDate => (Date.today + 3).to_s, :maxCharge => 8500})
+    result['hotel'].should_not be_empty
+    result['pagingInfo']['recordCount'].should_not be_nil
+  end
+  
+  it "楽天トラベル地区コードAPIの呼び出しが可能であること" do
+    result = @client.get_area_class('2009-03-26')
+    result['largeClass']['middleClass'].should_not be_empty
+  end
+
+  it "楽天トラベルキーワード検索APIの呼び出しが可能であること" do
+    result = @client.keyword_hotel_search('2009-10-20', {:keyword => '品川シーサイド'})
+    result['hotel'].should_not be_empty
+    result['pagingInfo'][0]['recordCount'].should_not be_nil
+  end
+
+  it "楽天トラベルホテルチェーンAPIの呼び出しが可能であること" do
+    result = @client.get_hotel_chain_list('2009-05-12')
+    result['hotelChainList'].should_not be_empty
+  end
+
+  it "楽天トラベルランキングAPIの呼び出しが可能であること" do
+    result = @client.hotel_ranking('2009-06-25', {:genre => 'all'})
+    result['ranking'][0]['hotelRankInfo'].should_not be_empty
+    result['ranking'][0]['lastBuildDate'].should_not be_nil
+
+    result = @client.hotel_ranking('2009-06-25', {:genre => 'onsen'})
+    result['ranking'][0]['hotelRankInfo'].should_not be_empty
+    result['ranking'][0]['lastBuildDate'].should_not be_nil
+
+    result = @client.hotel_ranking('2009-06-25', {:genre => 'all,onsen'})
+    result['ranking'][0]['hotelRankInfo'].should_not be_empty
+    result['ranking'][0]['lastBuildDate'].should_not be_nil
+  end
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification 
+name: rakuten
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tomonori Kusanagi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-12 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 6
+        version: 1.4.6
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :development
+  version_requirements: *id004
+description: Simple Rakuten API client.
+email: 
+- kusanagi@banana-systems.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/rakuten.rb
+- lib/rakuten/version.rb
+- rakuten.gemspec
+- spec/ids.rb.sample
+- spec/rakuten_dynamic_ad_spec.rb
+- spec/rakuten_spec.rb
+- spec/rakuten_travel_spec.rb
+has_rdoc: true
+homepage: https://github.com/xanagi/rakuten
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: rakuten
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple Rakuten API client.
+test_files: 
+- spec/ids.rb.sample
+- spec/rakuten_dynamic_ad_spec.rb
+- spec/rakuten_spec.rb
+- spec/rakuten_travel_spec.rb