ログイン
IDでもっと便利に[ 新規取得 ]

ショッピング

商品関連付け 商品情報登録

Version 1

リクエストURL

JSONP

http://shopping.yahooapis.jp/ShoppingWebService/V1/json/urlItemMatchAdd

商品関連付け 商品情報登録APIは、URLに対して任意の商品を関連付ける為のAPIです。商品関連付け 商品情報検索APIで発行された署名(signature)を用いて登録を行います。

リクエストパラメータ

RESTリクエストの構築(GET)」をご参照ください。

パラメータ 説明
appid
(必須)
string アプリケーションID。詳細はこちらをご覧ください。登録できる商品数は1appidあたり1万件迄です。
affiliate_type yid/vc Yahoo! JAPANアフィリエイト(yid)とバリューコマースアフィリエイト(vc)の選択。
例:affiliate_type=yid
affiliate_id string Yahoo! JAPANアフィリエイトIDもしくは、バリューコマースアフィリエイトIDを入力。
callback string JSONPとして出力する際のコールバック関数名を入力する為のパラメータ。UTF-8でエンコードした文字列を入力する。
url
(必須)
string 商品を登録したいURL(要URLエンコード)
最大128byte。
GETパラメータは含めません。
URLあたり5件まで登録可能です。
登録後一定期間参照が無いと自動的に削除されます。
itemcode
(必須)
string 商品コード(商品情報検索APIの結果リストCodeの値)
start_at
(必須)
string 署名有効開始時間(商品情報検索APIのレスポンスからコピー)
end_at
(必須)
string 署名有効終了時間(商品情報検索APIのレスポンスからコピー)
signature
(必須)
string 署名(商品情報検索APIのレスポンスからコピー)

サンプルリクエストURL

http://shopping.yahooapis.jp/ShoppingWebService/V1/json/urlItemMatchAdd?appid=<あなたのアプリケーションID>&url=http%3A%2F%2Fshopping.yahoo.co.jp%2F&itemcode=20xxsozo_kadenvgn-P50g&start_at=2009-12-14T17%3A22%3A42%2B09%3A00&end_at=2009-12-14T18%3A22%3A42%2B09%3A00&signature=8fa64550e10fe3dc0729000b1908b601

レスポンスフィールド

フィールド 説明
ResultStatus 登録結果 成功した際はOK
NGの時はエラーレスポンスを返します

サンプルレスポンス

以下は、正しくリクエストした場合のレスポンスです。

エラー

商品関連付け 商品情報登録Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。(無料)
まずはヘルプページのお問い合わせフォームからご相談ください。

開発者ブログ

Yahoo! JAPANのスタッフや著名なデベロッパーのブログを紹介しています。新しいサービスのアイデアにお役立てください。

開発者コミュニティ

Yahoo!グループに開発者のためのグループを用意しています。ほかのデベロッパーと交流し、質問やアイデアの共有にお役立てください。

法人デベロッパー専用お問い合わせ