楽天グループのウェブサービス/API/商品データベース。アフィリエイトにも対応
楽天ウェブサービス 楽天ウェブサービス

BETA

my Rakuten | 楽天市場へ
ウェブサービス規約 | ヘルプ
ウェブサービストップ 楽天市場 RMSパートナー 楽天アフィリエイトを利用
トップ > 楽天GORAプラン検索API
楽天ウェブサービス
オンラインドキュメント
楽天ウェブサービス規約
FAQ
クレジット表示
ウェブサービスチームブログ
旧ブログ
楽天市場系API
楽天商品検索API
楽天ジャンル検索API
楽天商品コード検索API
楽天商品ランキングAPI
楽天プロダクト製品検索API
楽天プロダクト製品詳細API
楽天プロダクトジャンル情報API
楽天プロダクトメーカー情報API
楽天ブックス系API
楽天ブックス総合検索API
楽天ブックス書籍API
楽天ブックスCD検索API
楽天ブックスDVD/Blu-ray検索API
楽天ブックス洋書検索API
楽天ブックス雑誌検索API
楽天ブックスゲーム検索API
楽天ブックスソフトウェア検索API
楽天ブックスジャンル検索API
楽天オークション系API
楽天オークション商品検索API
楽天オークション商品コード検索API
楽天オークションジャンル検索API
楽天トラベル系API
楽天トラベル施設検索API
楽天トラベル施設情報API
楽天トラベル空室検索API
楽天トラベル地区コードAPI
楽天トラベルキーワード検索API
楽天トラベルホテルチェーンAPI
楽天トラベルランキングAPI
>> 楽天トラベル系APIサンプル集
その他のAPI
楽天GORAゴルフ場検索API
楽天GORAゴルフ場詳細API
楽天GORAプラン検索API
楽天ダイナミックアドAPI
楽天ダイナミックアドAPI トラベル

提供API
楽天GORAプラン検索API (version:2011-05-12)
楽天GORAプラン検索APIとは
楽天GORAプラン検索APIは、 楽天GORAで提供している各ゴルフ場のプランの詳細や空き枠状況などを取得することが可能なAPIです。  
アカウント情報
デベロッパーIDの確認ヘルプ
アフィリエイトIDの確認ヘルプ
■リクエストURL(REST/JSON形式の場合)
http://api.rakuten.co.jp/rws/3.0/rest?[parameter]=[value]…
http://api.rakuten.co.jp/rws/3.0/json?[parameter]=[value]…

※JSONP形式は、JSON形式で入力パラメーターにcallBackを指定することで出力されます。

フィールド名keywordに対応する[value]はUTF-8でURLエンコードされている必要があります。(リクエストURL全体をエンコードするのではなく、[value]部分を個別にエンコードしてください。)
たとえば、2011/5/31に長野県(areaCode=20)のゴルフ場で、かつ昼食付きのプランで、結果を総合評価順に並べたい場合のリクエストURLは下記になります。(実際には改行せずに1行につなげてリクエストしてください。)
http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=GoraPlanSearch
&version=2011-05-12
&playDate=2011-05-31
&areaCode=20
&planLunch=1
&sort=evaluation
短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。
■入力パラメーター
楽天GORAプラン検索API(GoraPlanSearch) 入力パラメーター version:2011-05-12
区分 ID 項目名 フィールド名
(括弧内は
最大
バイト数)
必須 デフォルト 備考





|

|
1 デベロッパID developerId String --- デベロッパーID
2 アフィリエイトID affiliateId String - 指定無し アフィリエイトID
3 操作 operation String --- 使用するAPIの操作名:
GoraPlanSearch
4 コールバック関数名 callBack String - 指定無し JSONPとして出力する際のコールバック関数名
(UTF-8でURLエンコードした文字列)
英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上

|







|

|
1 ゴルフ場名 golfCourseName String
(*1)
--- UTF-8でURLエンコードした文字列
※半角スペース区切りで複数文字での検索も可
(*1)ゴルフ場名、エリアコード、ゴルフ場IDのいずれかが指定されていることが必須です
2 エリアコード areaCode int
(*1)
0 楽天GORAにおけるエリアを特定するためのコード
エリアコードを調べたい場合は、「楽天GORAエリアコード一覧」をご参照ください
(*1)ゴルフ場名、エリアコード、ゴルフ場IDのいずれかが指定されていることが必須です
3 ゴルフ場ID golfCourseId long
(*1)
--- 楽天GORAゴルフ場検索API(GoraGolfCourceSearch)の出力に含まれる
※カンマ区切りで最大30件指定可
(*1)ゴルフ場名、エリアコード、ゴルフ場IDのいずれかが指定されていることが必須です
4 バージョン version String --- 2011-05-12
5 プレー日 playDate String --- ※YYYY-MM-DDの形式で入力してください
※過去の日付を入れた場合はエラーになります
6 1ページあたりの取得件数 hits int - 30 1から30までの整数
7 取得ページ page int - 1 1から100までの整数
8 ソート sort String - reservation 【並び替え】
reservation:予約が多い
price:料金が安い
【評価順】
evaluation:総合評価
staff:スタッフ接客
facility:設備が充実
meal:食事が美味しい
course:コース/戦略性
costperformance:コストパフォーマンス
distance:距離が長い
fairway:フェアウェイが広い
9 プレー料金(最小価格) minPrice int - 指定無し  
10 プレー料金(最大価格) maxPrice int - 指定無し ※25,000円まで指定可能
11 時間帯指定 startTimeZone int - 0 0:指定しない
4:4時台
5:5時台
6:6時台
7:7時台
8:8時台
9:9時台
10:10時台
11:11時台
12:12時台
13:13時台
14:14時台
15:15時台以降
12 連続枠指定 range int - 0 同一コースの連続枠を検索することが出来ます
※指定組数以上の連続枠が検索対象になります
0:指定しない
2:2
3:3
4:4
5:5
6:6
7:7
8:8
9:9
10:10〜
13 【プラン指定】キャディ付 planCaddie int(1) - 0 0:選択しない
1:選択する
14 【プラン指定】乗用カート有 planCart int(1) - 0 0:選択しない
1:選択する
15 【プラン指定】宿泊プラン planStay int(1) - 0 0:選択しない
1:選択する
16 【プラン指定】昼食付 planLunch int(1) - 0 0:選択しない
1:選択する
17 【プラン指定】2サム保証 plan2sum int(1) - 0 0:選択しない
1:選択する
18 【プラン指定】4サム割引 planDiscount4sum int(1) - 0 0:選択しない
1:選択する
19 【プラン指定】追加1R無料 planAdd1RFree int(1) - 0 0:選択しない
1:選択する
20 【プラン指定】追加0.5R無料 planAddHalfFree int(1) - 0 0:選択しない
1:選択する
21 【プラン指定】2B追加料金なし planNoAddFee2b int(1) - 0 0:選択しない
1:選択する
22 【プラン指定】3B追加料金なし planNoAddFee3b int(1) - 0 0:選択しない
1:選択する
23 【プラン指定】1ドリンク付 planDrink int(1) - 0 0:選択しない
1:選択する
24 【プラン指定】GORA限定 planGoraOrg int(1) - 0 0:選択しない
1:選択する
25 【プラン指定】レッスン planLesson int(1) - 0 0:選択しない
1:選択する
26 【プラン指定】オープンコンペ planCompe int(1) - 0 0:選択しない
1:選択する
27 【プラン指定】9Hプレー planHalfRound int(1) - 0 0:選択しない
1:選択する
28 【プラン指定】早朝プレー planEarly int(1) - 0 0:選択しない
1:選択する
29 【プラン指定】検索除外プラン NGPlan String - 指定無し planCaddie:キャディ付
planCart:乗用カート有
planStay:宿泊プラン
planLesson:レッスン
planCompe:オープンコンペ
planHalfRound:9Hプレー
planEarly:早朝プレー
30 コース種別 courseType int(1) - 0 0:指定しない
1:丘陵
2:林間
3:河川
4:山岳
5:シーサイド
6:高原
31 【コース形状】フェアウェイが広い shapeWideFairway int(1) - 0 0:選択しない
1:選択する
32 【コース形状】OBが少なめ shapeLessOB int(1) - 0 0:選択しない
1:選択する
33 【施設】練習場あり practiceFacility int(1) - 0 0:選択しない
1:選択する
34 【施設】宿泊施設あり lodgingFacility int(1) - 0 0:選択しない
1:選択する
35 【施設】温泉あり onsenFacility int(1) - 0 0:選択しない
1:選択する
36 高速道路コード highwayCode int - 指定無し 楽天GORAにおける高速道路を特定するためのコード
高速道路コードを調べたい場合は、「楽天GORA高速道路コード一覧」をご参照ください
※エリア指定がない場合は、全ての高速道路コードでの絞り込みが可能ですが、エリアが指定された場合、エリアに応じて指定可能な高速道路コードが違いますのでご注意ください
37 インターチェンジからの距離 icDistance int(1) - 0 0:指定しない
1:5km以内
2:10km以内
3:15km以内
4:20km以内
5:25km以内
6:30km以内
7:31km以上
■出力パラメーター
楽天GORAプラン検索API(GoraPlanSearch) 出力パラメーター version:2011-05-12
区分 ID 大分類 小分類 項目名 フィールド名 備考





|

|
1 ARG --- User-Agent Valueにはユーザのユーザエージェントが表示される
2 --- developerId ValueにはデベロッパーIDが表示される
3 --- affiliateId ValueにはアフィリエイトIDが表示される
4 --- operation Valueにはユーザの指定した操作名が表示される
5 --- version Valueにはユーザの指定した操作のバージョンが表示される
6 Status --- Status Success / NotFound / ServerError / ClientError / Maintenance のいずれか
7 StatusMsg --- StatusMsg Statusに特化したメッセージを出力

|







|

|
1 全体情報 検索数 count 検索結果の総商品数
2 ページ番号 page 現在のページ番号
3 ページ内商品始追番 first 検索結果の何件目からか
4 ページ内商品終追番 last 検索結果の何件目までか
5 ヒット件数 hits 1度に返却する商品数
6 総ページ数 pageCount 最大100
7 ゴルフ場情報 ゴルフ場
基本情報
ゴルフ場ID golfCourseId  
8 ゴルフ場名 golfCourseName  
9 ゴルフ場説明文 golfCourseCaption  
10 ゴルフ場予約種別 golfCourseRsvType 1:リアルタイム予約コース
2:リクエスト予約・キャンセル待ち可能コース
3:その他コース
11 エリアコード areaCode エリアコードを調べたい場合は、「楽天GORAエリアコード一覧」をご参照ください。
12 都道府県名 prefecture  
13 最寄高速道路コード highwayCode 高速道路コードを調べたい場合は、「楽天GORA高速道路コード一覧」をご参照ください。
14 最寄高速道路 highway  
15 最寄IC ic  
16 ICからの距離 icDistance  
17 ゴルフ場画像URL golfCourseImageUrl  
18 価格情報 平日最安値 weekdayMinPrice その他加盟コースの場合設定なし
19 休日最安値 holidayMinPrice その他加盟コースの場合設定なし
20 キャンセル料有無 cancelFeeFlag 0:無し
1:有り
21 キャンセル料 cancelFee  
22 クチコミ クチコミ件数 ratingNum  
23 総合評価 evaluation  
24 URL 予約カレンダーURL(PC) reserveCalUrlPC 入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります。
25 予約カレンダーURL(モバイル) reserveCalUrlMobile 入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります。
26 クチコミURL(PC) ratingUrlPC  
27 クチコミURL(モバイル) ratingUrlMobile  
28 ゴルフ場プラン
全体:<planInfo>〜</planInfo> 個別:<plan>〜</plan>
プラン詳細 プランID planId  
29 プラン名 planName  
30 プランタイプ planType 1:通常
2:お得
3:GORA限定
31 期間限定プラン limitedTimeFlag 0:通常
1:期間限定プラン
32 プレー料金 price  
33 最小プレー人数 playerNumMin  
34 最大プレー人数 playerNumMax  
35 スタート時間帯 startTimeZone ex)6時台、7時台
※ゴルフ場からスタート時間帯情報の登録があったもののみ表示しています。
36 ラウンド数 round  
37 キャディ caddie 0:セルフ
1:キャディ
38 カート種類 cart 1:2人乗りカート
2:4・5人乗りカート
3:電動カート
4:手引きカート
39 2サム保証 assu2sum 0:無し
1:2サム保証
40 2B追加料金フラグ addFee2bFlag 0:無し
1:有り
41 2B追加料金 addFee2b  
42 2B組合せフラグ assortment2bFlag 0:無し
1:有り
43 3B追加料金フラグ addFee3bFlag 0:無し
1:有り
44 3B追加料金 addFee3b  
45 3B組合せフラグ assortment3bFlag 0:無し
1:有り
46 4サム割引フラグ discount4sumFlag 0:無し
1:有り
47 昼食 lunch 0:別料金
1:料金に含まれる
48 1ドリンク drink 0:無し
1:有り
49 宿泊 stay 0:無し
1:有り
50 レッスン lesson 0:無し
1:有り
51 オープンコンペ compe 0:無し
1:有り
52 備考 other  
53 在庫情報
<calInfo>〜</calInfo>
プレー日 playDate  
54 在庫ステータス stockStatus 1: 空き有り/リクエスト予約可
2: 空き有り/リクエスト予約不可
3: 在庫有り お得プラン
4: 在庫有り GORA限定プラン
5: リクエスト予約のみ
6: キャンセル待ち
55 在庫数 stockCount  
56 予約ページURL(PC) reservePageUrlPC 入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります
※在庫状況はリアルタイムに変更するため、予約ページにて各種受付を終了していることがございますことをご了承ください。
57 予約ページURL(モバイル) reservePageUrlMobile 入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります
※在庫状況はリアルタイムに変更するため、予約ページにて各種受付を終了していることがございますことをご了承ください。
■アフィリエイトに関して
デベロッパーは、楽天GORAプラン検索APIからアフィリエイトURLを取得することが可能です。リンク先にそのアフィリエイトURLを指定することで、楽天アフィリエイト経由の成果報酬を獲得することができます。
アフィリエイトURLを作るには、APIの入力パラメーターに「アフィリエイトID」を含めてリクエストしてください。
入力パラメーターcarrierでPCが指定された場合でもモバイルが指定された場合でも同様の方法でアフィリエイトURLを作成することができます。(2011年05月現在)
■エラー
エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。
Statusでの表示 内容
NotFound 検索結果が存在しない。
ServerError 楽天ウェブサービス側のエラー。
ClientError デベロッパーの入力に起因するエラー。
Maintenance メンテナンス。
AccessForbidden リクエスト回数制限オーバー。
※しばらく時間を空けて、再度ご利用ください

個人情報保護方針
Copyright (c) 1997-2012 Rakuten, Inc. All Rights Reserved.