PromotionDetails レスポンスグループ

[重要] 重要

利用率低下により、このレスポンスグループは2010年07月25日をもってサポート終了となっておりますので、ご利用にならないようご注意ください。

PromotionDetails レスポンスグループは、レスポンス中で、商品に関するプロモーションについての詳細情報を返します(情報が存在する場合)。これには、プロモーションを提供しているマーチャントに関する情報、プロモーションの要求コード、許可されるプロモーションの組み合わせ、プロモーションタイプ、プロモーションの開始日と終了日、プロモーションID、資格条件、プロモーションの詳細を表すテキストが含まれます。この情報の一部はPromotionSummary レスポンスグループで返されます。

PromotionDetails を使用するリクエストは、以下のレスポンスグループのいずれかを含んでいる必要があります。

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

関連オペレーション

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

  • ItemLookup

  • ItemSearch

  • ListLookup

  • SimilarityLookup

レスポンス要素

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

Promotions、Promotion、Details 以外のすべての要素は、Promotions/Promotion/Details の子要素です。

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

親レスポンスグループ

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

  • なし

子レスポンスグループ

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

  • なし

REST利用例

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

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

レスポンス例

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

<Promotions>
  <Promotion>
    <Details>
      <MerchantId>ATVPDKIKX0DER</MerchantId> 
      <OwningMerchantId>ATVPDKIKX0DER</OwningMerchantId> 
      <PromotionId>A2QIQTNOFYRK5N</PromotionId> 
      <PromotionCategory>BuyAmountXGetAmountOffX</PromotionCategory> 
      <GroupClaimCode>AUGSAVER</GroupClaimCode> 
      <CouponCombinationType>Unrestricted</CouponCombinationType> 
      <StartDate>2006 08 01 07:00:00 GMT</StartDate> 
      <EndDate>2006 09 01 06:59:59 GMT</EndDate> 
      <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>購入手続きを行う際、プロモーションコードを入力して <STRONG>適用</STRONG> ボタンをクリックしてください。 <LI>Best Value savings ($25) の値が、購入手続きの最終ページに反映されます。 お客様がショッピングカートからプロモーション参加商品のいずれかを削除した場合、またはお客様が以下に示す利用規約のいずれかを侵害した場合、プロモーションは無効になり、割引は注文から削除されます。お客様がプロモーション対象商品のいずれかをご返品になる場合、前もって適用されている割引は、払い戻し金額から差し引かれます。</LI></OL><BR><STRONG>利用条件:</STRONG> <UL> <LI>プロモーションは、限定された期間内においてのみ有効です。 夜間にショッピングカートに入れられた商品は、レジでの精算の時点でプロモーションの対象外になっていることがあります。プロモーションが適用されるのは、商品情報ページに申し込みメッセージが表示されている対象商品のみです。申し込みメッセージが表示されない商品は、商品の性質に関係なくプロモーションの対象外です。全ての 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, および KitchenAid Proline の商品は、このプロモーション対象外となります。<LI>全ての家具&インテリア、およびアウトドアリビング商品についても、このプロモーション対象外となります。プロモーションは、プロモーション申し込みメッセージに示された出品者が販売する商品のみに適用されます。Amazon.com Web サイトで他の出品者が販売する商品には適用されません。たとえば、Amazon.comが提供する商品にプロモーション申し込みが適用される場合、Amazon.com Web サイトの他の出品者(たとえばLand's End、Targetなど)が提供する商品は対象外となります。Amazon.com の他のサイト(Amazon.co.uk、Amazon.de、Amazon.fr、Amazon.co.jp など)や、マーケットプレイスで購入された商品はすべて対象外です。<LI>申し込みメッセージに例外が示されない限り、プロモーションの申し込みは、最も価格が低い対象商品に適用されます。<LI>プロモーションの特典の対象になる商品がすべて1回の注文で購入された場合のみ、プロモーションが適用されます。<LI>プロモーションのその他の条件をすべて満たし、1つのお届け先に発送される完了した注文にのみ、プロモーションが適用されます。<LI>申し込みは、商品に在庫がある限り有効です。<LI>代用品の提供や売り切れ後の後日販売はありません。<LI>プロモーションの申し込みはショッピングカートを通じて行う必要があります。1-Clickで行われた注文は対象になりません。<LI>配送料と手数料は、ボーナス商品を含むすべての商品に対して請求されます。<LI>プロモーションの申し込みは、プロモーション用Amazonギフト券の利用を含めて、他の申し込みと組み合わせることができない場合があります。<LI>禁止条項に該当する場合、プロモーションは無効となります。</LI></UL></TermsAndConditions> 
        <EligibilityRequirements>
          <EligibilityRequirement>
            <EligibilityRequirementType>MinPurchase</EligibilityRequirementType> 
            <CurrencyAmount>
              <Amount>12500</Amount> 
              <CurrencyCode>USD</CurrencyCode> 
              <FormattedPrice>$125.00</FormattedPrice> 
            </CurrencyAmount>
          </EligibilityRequirement>
        </EligibilityRequirements>
      <Benefits>
        <Benefit>
          <BenefitType>FixedAmountOff</BenefitType> 
          <ComponentType>ItemPrice</ComponentType> 
          <FixedAmount>
            <Amount>2500</Amount> 
            <CurrencyCode>USD</CurrencyCode> 
            <FormattedPrice>$25.00</FormattedPrice> 
          </FixedAmount>
        </Benefit>
      </Benefits>
      <ItemApplicability>
        <ASIN>B000AQSMPO</ASIN> 
        <IsInBenefitSet>true</IsInBenefitSet> 
        <IsInEligibilityRequirementSet>true</IsInEligibilityRequirementSet> 
      </ItemApplicability>
    </Details>
  </Promotion>
</Promotions>