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

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

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

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

基本的な使い方

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

• YSAPI_SELLING
• YSAPI_ITEM
• YSAPI_PRODUCT
• YSAPI_STOCK
• YSAPI_CATEGORY
• YSAPI_IMAGE
• YSAPI_DESIGN
• YSAPI_ORDER
• YSAPI_QUESTION
• YSAPI_AUTH
• YSAPI_UTIL

どのクラスも基本的には同じ使い方です。
最初にYahooID連携の認証クラスを初期化します。
$auth = new YSAPI_AUTH('ApplicationID', 'Secret');
$auth->Authorization();商品APIの場合、
$api = new YSAPI_ITEM($auth, 'SellerID');
これで、商品APIの利用準備が出来ました。
【証明書について】
注文API、問い合わせAPIは証明書の利用が可能なため
$api = new YSAPI_ORDER($auth, 'SellerID', 'SHP-ショップ名.crtのパス', 'ショップ名.keyのパス');
とする事でリフレッシュトークンの有効期限を他のAPI群と同じように最大4週間まで延長可能です。
※注文API、問い合わせAPIは利用申請が必要です。
※証明書(.crt)、秘密鍵(.key)ファイルはYahooストアクリエーターよりダウンロードして下さい。
次に、商品情報の取得は、
$xml = $api->getItem('xxx-1234');
$item = new YSAPI_GET_ITEM_RESPONSE($xml->ResultSet->Result);
echo 'Price: '.$item->Price;これで商品情報が取得出来ました。
$xmlにsimplexmlデータが取得できます。
YSAPI_GET_ITEM_RESPONSEの初期化時に$xml->ResultSet->Resultを指定するとプロパティに各要素を展開します。
既存の商品データの内容を更新するにはリクエストモデル(YSAPI_EDIT_ITEM_REQUEST)に情報を設定してeditItemを実行します。
$req = new YSAPI_EDIT_ITEM_REQUEST();
$req->ItemCode = 'xxx-1234';
$req->price = 5800;
$req->display = 0;
$api->editItem( $req );これでサイト上の販売価格は5,800円、ページ公開指定は非公開に設定されました。
XMLの各キー名と同じ名前のプロパティで取得・設定が出来るので分かりやすいですね。
値の設定時に内部で型変換を行っています。

次に商品画像のアップロードの例です。
$auth = new YSAPI_AUTH('ApplicationID', 'Secret');
$auth->Authorization();
$api = new YSAPI_ITEM($auth, 'SellerID');
$api->uploadItemImage("./images/sample.jpg", "xxx-1234.jpg");
これだけでＯＫです。
最初の引数はアップロードするファイルのパス、２つ目は登録画像名です。
(商品画像：商品コード.拡張子 / 商品詳細画像：商品コード_(1-5).拡張子)
【受注の取得】
検索条件を指定して受注情報を取得します。
(例) 2016年10月20日以降の新規受付の受注を取得$api = new YSAPI_ORDER($auth, "SellerID");
//検索条件の設定
$req = new YSAPI_ORDER_LIST_REQUEST();
//ステータスの指定
$req->OrderStatus = 2 //処理中
$req->IsSeen = false //未閲覧
'受注日時を指定
$req->OrderTimeFrom = '2016-10-20';
'受注リストを取得
$xml = $api->orderList($req);
foreach ($xml->Result->Search->OrderInfo as $order)
{
　　var_dump($order);
}

価格について

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