.netライブラリ for Yahoo!ショッピングAPI

「.netライブラリ for Yahoo!ショッピングAPI」について

Yahoo!ストアに出店している自社のサイト管理や、顧客のサイト管理システムなど、Windowsアプリケーションの開発時に、Microsoft Visual Stuioの.netアプリケーションからストアクリエーターにログインする事なくWEB APIを利用して簡単に情報を操作するためのライブラリです。
Yahoo!デベロッパーネットワーク公式ドキュメントで挫折した人にも、なるべく簡単に利用出来るようにしました。
商品の取得や登録・更新・削除、商品カテゴリやプロダクトコードの検索、カテゴリ追加・更新・削除や追加画像のフォルダ・画像の操作まで様々な処理がすべて簡単なコードで可能になります。
注文API在庫APIも利用可能ですので、受注管理や在庫更新にと活躍します。
YahooID連動のため、受注の無人自動取込の処理でお困りの方は是非お問い合わせ下さい。
.netライブラリ for RMS WEB SERVICE(楽天WebAPI)」と組み合わせて楽天との在庫連動も可能です。
※注文APIはProfessional Editionのみご利用になれます。
PHPライブラリ for Yahoo!ショッピングAPI」も発売中です。

この製品の質問、お問合せは「製品に関するお問合せ」よりお願いいたします。

Yahoo!ショッピングAPIの以下のAPI機能に対応しています。

出品管理に関連するAPI
dataCheckHistorySummary データチェック履歴一覧API
dataCheckHistoryDetail データチェック履歴詳細API
publishHistorySummary 反映履歴/未反映項目一覧API
publishHistoryDetail 反映履歴/未反映項目詳細API
reservePublish 全反映予約API
downloadRequest ダウンロード要求API
downloadList ダウンロード準備完了通知API
downloadSubmit ダウンロード実行API
商品に関連するAPI
editItem 商品登録API
updateItems 商品一括更新API
moveItems 商品移動API
sortItems 商品表示順序変更API
setItemDisplayPriority 商品表示優先順変更API
getItem 商品参照API
deleteItem 商品削除API
submitItem 商品個別反映API
myItemList 商品リストAPI
uploadItemFile 商品アップロードAPI
製品/SHPカテゴリ/ブランドに関連するAPI
getShopProductCodeList SHP製品コード検索API
getShopCategory SHPカテゴリツリー取得API
getShopCategoryList SHPカテゴリ/スペック検索API
downloadShopCategories SHPカテゴリ/スペックダウンロードAPI
getShopBrandList SHPブランドコード検索API
downloadShopBrands SHPブランドコードダウンロードAPI
在庫に関連するAPI
getStock 在庫参照API
setStock 在庫更新API
uploadStockFile 在庫アップロードAPI
ストアカテゴリに関連するAPI
editStCategory ストアカテゴリ編集API
getStCategory ストアカテゴリ参照API
stCategoryList ストアカテゴリ一覧API
moveStCategory ストアカテゴリ移動API
deleteStCategory ストアカテゴリ削除API
sortCategories ストアカテゴリ表示順序変更API
画像に関連するAPI
itemImageList 商品画像一覧API
uploadItemImage 商品画像アップロードAPI
uploadItemImagePack 商品画像一括アップロードAPI
deleteItemImage 商品画像削除API
libImageList 追加画像一覧API
uploadLibImage 追加画像アップロードAPI
uploadLibImagePack 追加画像一括アップロードAPI
deleteLibImage 追加画像削除API
libDirectoryList 追加画像ディレクトリ一覧API
addLibDirectory 追加画像ディレクトリ登録API
moveLibDirectory 追加画像ディレクトリ変更API
deleteLibDirectory 追加画像ディレクトリ削除API
デザインに関連するAPI
getPreviewHtml プレビューHTML参照API
getCustomPageDesign カスタムページ参照API
editCustomPageDesign カスタムページ編集API
getCustomPageList カスタムページ一覧API
deleteCustomPage カスタムページ削除API
getStoreinfoFreespace ストア設定フリースペース参照API
setStoreinfoFreespace ストア設定フリースペース編集API
注文に関連するAPI ※Professional Editionのみ
orderCount 注文ステータス別件数参照API
orderList 注文検索API
orderInfo 注文詳細API
orderStatusChange 注文ステータス変更API
orderPayStatusChange 入金ステータス変更API
orderShipStatusChange 出荷ステータス変更API
orderChange 注文内容変更API
orderChangeHistory 注文操作履歴一覧API
orderSplit 注文分割API
orderItemAdd 注文ライン追加API
orderPayNumber 支払番号発行API
orderCouponCancel クーポンキャンセルAPI

基本的な使い方

このライブラリにはYahoo!ショッピングAPIのAPI群に合わせて、以下のクラスが存在します。

  • YSAPI.ySelling
  • YSAPI.yItem
  • YSAPI.yProduct
  • YSAPI.yStock
  • YSAPI.yCategory
  • YSAPI.yImage
  • YSAPI.yDesign
  • YSAPI.yOrder
  • YSAPI.yAuth
  • YSAPI.yUtil

どのクラスも基本的には同じ使い方です。
最初にクラスを初期化します。
商品APIの場合、
[VB.net]
Dim Auth = new YSAPI.yAuth("ApplicationID", "Secret")
Dim Api = new YSAPI.yItem(Auth, "SellerID")
[C#.net]
YSAPI.yAuth auth = new YSAPI.yAuth("ApplicationID", "Secret", "UserID", "UserPassword");
YSAPI.yItem api = new YSAPI.yItem(auth, "SellerID");
これで、ItemAPIの利用準備が出来ました。
次に、商品情報の取得は、
[VB.net]
Dim Doc As XmlDocument = API.getItem("xxx-1234")
Dim item As YSAPI.yItemInfo = new YSAPI.yItemInfo(Doc["ResultSet"]["Result"]);
[C#.net]
XmlDocument doc = api.getItem("xxx-1234");
YSAPI.yItemInfo item = new YSAPI.yItemInfo(doc["ResultSet"]["Result"]);
これで商品情報が取得出来ました。
取得した商品データ(yItemInfo モデル)の内容を更新するには
[VB.net]
item.price = 5800
item.display = 0
API.editItem( item )
[C#.net]
item.price = 5800;
item.display = 0;
api.editItem( item );
これでサイト上の販売価格は5,800円、ページ公開は非公開に設定されました。
XMLの各キー名と同じ名前のプロパティで取得・設定が出来ます。
各プロパティの詳細についてはYahoo!デベロッパーネットワークを参照して下さい。

次に商品画像のアップロードの例です。
[VB.net]
Dim API = new YSAPI.yImage(Auth, "SellerID")
API.uploadItemImage("C:\images\sample.jpg", "xxx-1234.jpg")
[C#.net]
YSAPI.yImage api = new YSAPI.yImage(auth, "SellerID");
api.uploadItemImage(@"C:\images\sample.jpg", "xxx-1234.jpg");
これだけでOKです。
最初の引数はアップロードするファイルのパス、2つ目は登録画像名です。
(商品画像:商品コード.拡張子 / 商品詳細画像:商品コード_(1-5).拡張子)
【受注の取得】
検索条件を指定して受注情報を取得します。
(例) 2016年10月20日以降の新規受付の受注を取得[VB.net]
Dim API = new YSAPI.yOrder(Auth, "SellerID")
'検索条件の設定
Dim cond As new YSAPI.yOrderListCondition()
'ステータスの指定
cond.OrderStatus = 2 '処理中
cond.IsSeen = false '未閲覧
'受注日時を指定
cond.OrderTimeFrom = new DateTime(2016, 10, 20)
'受注リストを取得
Dim Doc As XmlDocument = API.orderList(cond)
Dim orders As New List(of YSAPI.yOrderInfo)
For Each el As XmlElement In Doc["ResultSet"].getElementsByTagName("Result")
  orders.Add( New YSAPI.yOrderInfo(el) )
Next

価格について

ライセンス体系 摘要 価格 (税抜)
1開発ライセンス 開発環境(PC)1台につき1ライセンスが必要です Std 75,000円
Pro 95,000円

※Yahoo!ショッピングAPIをご利用になるには、Yahoo!デベロッパーネットワークよりAPIキーの発行と機能の利用設定が必要です。
※注文APIをご利用になるには、別途申請が必要となります。
※Yahoo!ID連携および注文API関連の仕様詳細についてはお問い合わせ下さい。
※ライブラリを利用した開発についてのご相談や他ECサイトのライブラリ開発もご相談下さい。
楽天RMSアプリケーション開発用の「.netライブラリ for RMS WEB SERVICE(楽天WebAPI)」も発売中です。
この製品の購入希望、質問、お問合せは「製品に関するお問合せ」よりお願いいたします。

2017/06/06