PromotionSummary レスポンスグループ

PromotionSummary レスポンスグループは、プロモーションに関する要約情報(種類、開始および終了日付、プロモーションID、資格要件、プロモーションの特長に関する説明)を返します。これは、PromotionDetails レスポンスグループで返される情報のサブセットです。

PromotionSummary は、以下のいずれかのレスポンスグループとともに使用する必要があります。

PromotionDetails を指定したリクエストにこれらのレスポンスグループが指定されていない場合、エラーが返されます。

プロモーションタイプ

プロモーションタイプは Category 要素によって返され、次の情報を含んでいます。

  • ForEachQuantityXGetQuantityFreeX —指定された数量の商品を購入すると、いくつかの同じ商品が無料で提供されるプロモーションです。例えば、6ダースの卵を購入するごとに、1ダースの卵が無料になるといったものです。

  • BuyAmountXGetSimpleShippingFreeX—商品が無料で配送されるプロモーションです。

  • BuyAmountXGetAmountOffX—指定された金額分の商品を購入すると、他の商品が割引になるプロモーションです。例えば、3つのボールを購入すると、野球のグローブが 25% 引きになるといったものです。

関連オペレーション

このレスポンスグループを使用できるオペレーションは以下の通りです:

  • ItemLookup

  • ItemSearch

  • ListLookup

  • SimilarityLookup

レスポンス要素

次の表では PromotionSummary によって返される要素の親子関係について説明します

この表で Promotions、Promotion、Summary以外のすべての要素の親は、Offers/Offer/Promotions/Promotion/Summary です。

PromotionSummary は、全てのレスポンスグループに共通のレスポンス要素に示されている、全てのレスポンスグループが返す要素も返します。

親レスポンスグループ

次のレスポンスグループは、PromotionSummary の親レスポンスグループです。

  • なし

子レスポンスグループ

次のレスポンスグループは、PromotionSummary の子レスポンスグループです。

  • なし

REST 利用例

次のリクエストを使用して、PromotionSummary によって返される XML レスポンス要素を説明しています。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
Operation=ItemLookup&
ContentType=text/xml&
AWSAccessKeyId=[AWS アクセスキー ID]&
ItemId=B000AQSMPO&
IdType=ASIN&
ResponseGroup=Offers,PromotionSummary&
Version=2008-08-19

レスポンス例

次のレスポンス例は、PromotionSummary で返される要素をまとめたものです。

<Promotions>
  <Promotion>
  <Summary>
    <PromotionId>A2QIQTNOFYRK5N</PromotionId> 
    <Category>BuyAmountXGetAmountOffX</Category> 
    <StartDate>2006 08 01 07:00:00 GMT</StartDate> 
    <EndDate>2006 09 06 06:59:59 GMT</EndDate> 
    <EligibilityRequirementDescription>Save $25.00 when you spend $125.00 or more on Kitchen & Housewares or Bed & Bath products offered by Amazon.com. Enter code AUGSAVER at checkout.</BenefitDescription>Save $25.00 when you spend $125.00 or more on Kitchen & Housewares or Bed & Bath products offered by Amazon.com. Enter code AUGSAVER at checkout.</BenefitDescription>
<TermsAndConditions><STRONG>To receive the Best Value discount:</STRONG> <OL> <LI>Add $125 of qualifying Kitchen & Housewares or Bed & Bath products to your Shopping Cart via the <STRONG>Add to Shopping Cart</STRONG> button on each respective product information page. <LI>At checkout, enter the promotional code and click the <STRONG>Apply</STRONG> button. <LI>The amount of the Best Value savings ($25) will be reflected on the final order checkout page. <LI>If you remove any of the participating promotion items from your Shopping Cart or violate any of the terms and conditions listed below, the promotion will be invalid, and the discount will be removed from the order. <LI>If you return any of the items involved in the promotion, the discount previously applied to the order will be subtracted from the return credit. </LI></OL><BR><STRONG>Terms and Conditions:</STRONG> <UL> <LI>Promotional offer valid for a limited time only. Items placed in Shopping Cart overnight may not be eligible for promotion at time of checkout. <LI>Promotion applies only to qualifying items displaying the offer message on their product information pages. Items that do not display the offer message do not qualify, regardless of the nature of the item.&nbsp; All All Clad, Calphalon, Capresso, Emerilware, Le Creuset, Orrefors, Kosta Boda, J.A. Henckels, Wusthof, Riedel, Marquis, Shun, Komachi, Waterford, Weber, Tassimo, Margaritaville, DKNY, Tommy Hilfiger, Nautica, Oscar by Oscar de Larenta, Cath Kidston, Raymond Waites, and KitchenAid Proline&nbsp;products are excluded from this offer.&nbsp; <LI>All Furniture & Decor and Outdoor Living products are excluded from this offer. <LI>Applies only to products sold by the merchant indicated in the promotional offer message. Does not apply to items sold by other merchants on the Amazon.com Web site. For example, where the promotional offer applies to items offered by Amazon.com, items offered by other merchants on the Amazon.com Web site (e.g. Land's End, Target, etc.) do not qualify. <LI>Does not apply to any products purchased in Amazon.com's other sites, including Amazon.co.uk, Amazon.de, Amazon.fr, or Amazon.co.jp, or in Marketplace, zShops, or Auctions. <LI>Unless the offer message indicates otherwise, the promotional offer applies to the lowest priced qualifying item(s) <LI>Applies only when all qualifying and benefit products in the promotion are purchased in one order. <LI>Applies only to complete orders shipping to a single address that meet all other promotional requirements. <LI>Offer good while supplies last. <LI>No substitutions or rain checks. <LI>Offer must be redeemed through the Shopping Cart. Does not apply to orders placed with 1 Click. <LI>Shipping and handling charges apply to all products, including bonus items. <LI>Offer may not be combined with other offers, including promotional certificates. <LI>Void where prohibited. </LI></UL></TermsAndConditions> 
    </Summary>
  </Promotion>
</Promotions>