'ERSS'에 해당되는 글 1건
"Ecommerce RSS" Module Specification (ERSS) v1.0
Purpose
The ecommerce namespace is an RSS module that extends the capabilities of RSS 2.0 to allow for more robust ecommerce syndication through standardization.
Change Notes
13 / October / 2006 ? Created.
1 / November / 2006 ? Moderate node and attribute additions for better syndication.
- Added <ecommerce:shipping> element for item shipping details.
- Added <ecommerce:condition> element for identification of item condition.
- Added <ecommerce:auction> element for establishing item as an auction.
- Added upc attribute to <ecommerce:sku> element for univeral product code.
- Added model attribute to <ecommerce:manufacturer> element for manufacturer number identification.
- Removed <ecommerce:productId> element due to its ambiguity.
Namespace Declaration
The namespace for the ecommerce RSS module is defined to be: http://shopping.discovery.com/erss
For example:
<rss version="2.0" xmlns:ecommerce="http://shopping.discovery.com/erss">
Principal Node Elements
<ecommerce:listPrice>_____</ecommerce:listPrice>
<ecommerce:listPrice> is a sub-element of <item>. It is the value or current price of the item. The value is typically a number expressed in the local currency without a dollar sign. It has one optional attribute.
<ecommerce:listPrice currency="USD">1,200.00</ecommerce:listPrice>
- currency specifies the local unit of currency, conforming to the ISO 4217 specification; if not present, default "USD". It is an optional attribute.
<ecommerce:SKU>_____</ecommerce:SKU>
<ecommerce:SKU> is a sub-element of <item>. A SKU or stock keeping unit is an identifier that is used by merchants to permit the systematic tracking of products and services offered to customers. (It can be pronounced as either "skew" or "ess-kay-you".) Usage of the SKU system is rooted in the drill down method, pertaining to data management. SKUs are assigned and serialized at the merchant level. Each SKU is attached to an item, variant, product line, bundle, service, fee or attachment. The value is typically a string of alphanumeric characters that may include dashes. It has one optional attribute.
<ecommerce:SKU UPC="0-543698-986745-1">986745</ecommerce:SKU>
- UPC or universal product code is one of a wide variety of bar code languages called symbologies which encodes twelve decimal digits. It is an optional attribute.
Optional Node Elements
<ecommerce:auction />
<ecommerce:auction> is a sub-element of <item> and is self terminating. It identifies the item as an auction rather then a set item of fixed price. It has two required and two optional attributes.
<ecommerce:auction bids="0" endDate="Sat, 07 Sep 2002 00:00:01 GMT" buyNowPrice="49.50" currency="USD" />
- bids specifies the number of bids the item has recieved. It is a required attribute.
- endDate specifies the date the auction ends. RFC 822 specification. It is a required attribute.
- buyNowPrice specifies the value or buy now price of the item. The value is typically a number expressed in the local currency without a dollar sign. It is an optional attribute.
- currency specifies the local unit of currency, conforming to the ISO 4217 specification; if not present, default "USD". It is an optional attribute.
<ecommerce:condition>_____</ecommerce:condition>
<ecommerce:condition> is a sub-element of <item>. The value indicates the condition of the item and can be expressed as "new", "used" or "refurbished".
<ecommerce:condition>new</ecommerce:condition>
<ecommerce:manufacturer>_____</ecommerce:manufacturer>
<ecommerce:manufacturer> is a sub-element of <item>. It is the company that manufactured or fabricated the item. It has one optional attribute.
<ecommerce:manufacturer model="55HD-LCOS/19.5">Panasonic</ecommerce:manufacturer>
- model specifies the identification assigned to the item by the manfacturer. It is a optional attribute.
<ecommerce:mass />
<ecommerce:mass> is a sub-element of <item> and is self terminating. It has two required attributes.
<ecommerce:mass unit="ounces" weight="4" />
- unit specifies the local unit of measurment. It is a required attribute.
- weight specifies the weight of the item. It is a required attribute.
<ecommerce:offerPrice>_____</ecommerce:offerPrice>
<ecommerce:offerPrice> is a sub-element of <item>. It is the value or offer price of the item. The value is typically a number expressed in the local currency without a dollar sign. It has one optional attribute.
<ecommerce:offerPrice currency="USD">899.95</ecommerce:offerPrice>
- currency specifies the local unit of currency, conforming to the ISO 4217 specification; if not present, default "USD". It is an optional attribute.
<ecommerce:promoText>_____</ecommerce:promoText>
<ecommerce:promoText> is a sub-element of <item>. Promo text is used to supplement the <description> node with descriptive promotional text about the item. The value is typically a sentence in length. It has one optional attribute.
<ecommerce:promoText type="plain">On sale now for only 24 hours!</ecommerce:promoText>
- type specifies the type of text embedded. Possible values are either "plain" or "html". Default value is "plain". All html must be entity-encoded. It is an optional attribute.
<ecommerce:rating />
<ecommerce:rating> is a sub-element of <item> and is self terminating. It has two required attributes.
<ecommerce:rating possible="5" scored="3" />
- possible specifies the highest possible score or rating for the item. It is a required attribute.
- scored specifies the current score or rating of the item. It is a required attribute.
<ecommerce:shipping>_____</ecommerce:shipping>
<ecommerce:shipping> is a sub-element of <item>. Offers details about shipping of the item.
<ecommerce:shipping>Ground, 2nd day and next day air available.</ecommerce:shipping>
<ecommerce:size />
<ecommerce:size> is a sub-element of <item> and is self terminating. It has one required and three optional attributes.
<ecommerce:size unit="inches" width="5.25" height="7.75" depth="0.75" />
- unit specifies the local unit of measurment. It is a required attribute.
- width specifies the width of the item. It is an optional attribute.
- height specifies the height of the item. It is an optional attribute.
- depth specifies the depth of the item. It is an optional attribute.
<ecommerce:stockAvailability>_____</ecommerce:stockAvailability>
<ecommerce:stockAvailability> is a sub-element of <item>. The current availability of a item. The value can be expressed as "available" or "out of stock". It has one optional attribute.
<ecommerce:stockAvailability quanity="1342">available</ecommerce:stockAvailability>
- quanity specifies the amount of items that are available. Possible values are whole integers starting from "0". It is an optional attribute.
Examples
- A basic / minimal ERSS feed.
<?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:ecommerce="http://shopping.discovery.com/erss"> <channel> <title>Discovery Channel Store</title> <description>Find educational toys and other unique gift ideas at the Discovery Channel Store online.</description> <link>http://shopping.discovery.com</link> <pubDate>Wed, 18 Oct 2006 01:00:36 GMT</pubDate> <item> <title>Ice Age Columbus: Who Were the First Americans?</title> <description>Chart the epic journey of Stone Age hunters from their homeland in France to their ...</description> <link>http://shopping.discovery.com/servlet/Jumpzone?product=0-54369-9867454-17&ti=000454</link> <ecommerce:listPrice>19.95</ecommerce:listPrice> <ecommerce:SKU UPC="0-543698-986745-1">986745</ecommerce:SKU> <category>DVD</category> <pubDate>Tue, 17 Oct 2006 15:49:36 GMT</pubDate> </item> ... </channel> </rss> - An expanded ERSS + MRSS feed.
<?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:ecommerce="http://shopping.discovery.com/erss" xmlns:media="http://search.yahoo.com/mrss"> <channel> <title>Discovery Channel Store</title> <description>Find educational toys and other unique gift ideas at the Discovery Channel Store online.</description> <link>http://shopping.discovery.com</link> <pubDate>Wed, 18 Oct 2006 01:00:36 GMT</pubDate> <item> <title>Ice Age Columbus: Who Were the First Americans?</title> <description>Chart the epic journey of Stone Age hunters from their homeland in France to their ...</description> <ecommerce:promoText>On sale NOW!</ecommerce:promoText> <link>http://shopping.discovery.com/servlet/Jumpzone?product=0-54369-9867454-17&ti=000454</link> <media:thumnail url="http://shopping.discovery.com/images/products/small/54369.gif" width="100" height="100" /> <ecommerce:listPrice>19.95</ecommerce:listPrice> <ecommerce:offerPrice>15.95</ecommerce:offerPrice> <ecommerce:rating possible="5" scored="3" /> <ecommerce:SKU UPC="0-543698-986745-1">986745</ecommerce:SKU> <ecommerce:stockAvailability quanity="245">available</ecommerce:stockAvailability> <ecommerce:mass unit="ounces" weight="4" /> <ecommerce:size unit="inches" width="5.25" height="7.75" depth="0.75" /> <ecommerce:manufacturer>Sony</ecommerce:manufacturer> <category>DVD</category> <pubDate>Tue, 17 Oct 2006 15:49:36 GMT</pubDate> </item> ... </channel> </rss> - A search api ERSS + MRSS + OpenSearch feed.
<?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:ecommerce="http://shopping.discovery.com/erss" xmlns:media="http://search.yahoo.com/mrss" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"> <channel> <title>Discovery Channel Store :: Search :: term term ...</title> <description>Find educational toys and other unique gift ideas at the Discovery Channel Store online.</description> <link>http://shopping.discovery.com</link> <opensearch:totalResults>25408</opensearch:totalResults> <opensearch:startIndex>1</opensearch:startIndex> <opensearch:itemsPerPage>10</opensearch:itemsPerPage> <opensearch:Query role="request" searchTerms="term+term+..." /> <pubDate>Wed, 18 Oct 2006 01:00:36 GMT</pubDate> <item> <title>Ice Age Columbus: Who Were the First Americans?</title> <description>Chart the epic journey of Stone Age hunters from their homeland in France to their ...</description> <ecommerce:promoText>On sale NOW!</ecommerce:promoText> <link>http://shopping.discovery.com/servlet/Jumpzone?product=0-54369-9867454-17&ti=000454</link> <media:thumnail url="http://shopping.discovery.com/images/products/small/54369.gif" width="100" height="100" /> <ecommerce:listPrice>19.95</ecommerce:listPrice> <ecommerce:offerPrice>15.95</ecommerce:offerPrice> <ecommerce:rating possible="5" scored="3" /> <ecommerce:SKU UPC="0-543698-986745-1">986745</ecommerce:SKU> <ecommerce:stockAvailability quanity="245">available</ecommerce:stockAvailability> <ecommerce:mass unit="ounces" weight="4" /> <ecommerce:size unit="inches" width="5.25" height="7.75" depth="0.75" /> <ecommerce:manufacturer>Sony</ecommerce:manufacturer> <category>DVD</category> <pubDate>Tue, 17 Oct 2006 15:49:36 GMT</pubDate> </item> ... </channel> </rss> - A search api ERSS + MRSS + OpenSearch auction feed.
<?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:ecommerce="http://shopping.discovery.com/erss" xmlns:media="http://search.yahoo.com/mrss" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"> <channel> <title>Discovery Channel Store :: Search :: term term ...</title> <description>Find educational toys and other unique gift ideas at the Discovery Channel Store online.</description> <link>http://shopping.discovery.com</link> <opensearch:totalResults>25408</opensearch:totalResults> <opensearch:startIndex>1</opensearch:startIndex> <opensearch:itemsPerPage>10</opensearch:itemsPerPage> <opensearch:Query role="request" searchTerms="term+term+..." /> <pubDate>Wed, 18 Oct 2006 01:00:36 GMT</pubDate> <item> <title>Ice Age Columbus: Who Were the First Americans?</title> <description>Chart the epic journey of Stone Age hunters from their homeland in France to their ...</description> <ecommerce:promoText>On sale NOW!</ecommerce:promoText> <link>http://shopping.discovery.com/servlet/Jumpzone?product=0-54369-9867454-17&ti=000454</link> <media:thumnail url="http://shopping.discovery.com/images/products/small/54369.gif" width="100" height="100" /> <ecommerce:auction bids="5" endDate="Tue, 24 Oct 2006 15:49:36 GMT" buyNowPrice="14.99" /> <ecommerce:listPrice>5.35</ecommerce:listPrice> <ecommerce:SKU UPC="0-543698-986745-1">986745</ecommerce:SKU> <ecommerce:mass unit="ounces" weight="4" /> <ecommerce:size unit="inches" width="5.25" height="7.75" depth="0.75" /> <ecommerce:manufacturer>Sony</ecommerce:manufacturer> <category>DVD</category> <pubDate>Tue, 17 Oct 2006 15:49:36 GMT</pubDate> </item> ... </channel> </rss>
Acknowledgements
Thank you to everyone who has contributed to this specification, and to all those that sent suggestions and corrections.
The base RSS version 2.0 Specification can be found within the Harvard Law Blogs.
The YAHOO! MRSS Module @ http://search.yahoo.com/mrss.
The A9.com OpenSearch Module @ http://www.opensearch.org.
