一般に使われるレスポンス要素

プロモーションレスポンスグループは、特定の商品に関するさまざまな情報を提供します。一般的には、プロモーションレスポンスグループのいずれかまたは両方を、商品情報の問い合わせリクエストに指定することをお勧めします。PromotionSummary で返されるレスポンス要素のうち、通常は、以下のものがプロモーション情報を表示するために使われます。

レスポンス要素	説明
BenefitDescription	ボーナス(プロモーションの結果としてカスタマーが受け取る商品)の説明です。この要素は、商品がプロモーションボーナスの一部でない場合は存在しません。
EligibilityDescription	カスタマーがプロモーションの資格を取得するために購入する必要のある商品の説明です。対象商品を購入してもプロモーションボーナスを受け取れない場合、この要素は存在しません。
TermsAndConditions	プロモーションの利用規約。

次のレスポンス例には、これらの要素の値が示されています。

<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. …
</TermsAndConditions>

これら3つの要素は、人間が読んで理解できるようになっています。そのため、HTML で返されます。

PromotionDetails の他のレスポンス要素は、プロモーションの詳細な処理のためにあります。PromotionDetails の次の要素は便利なものです。

レスポンス要素	説明
ComponentType	プロモーションの適用対象 (Shipping、ItemPrice、Subtotalなど) を示します。
CouponCombinationType	組み合わせ可能なプロモーション用クーポンの種類 (Unrestricted、Preferential、Exclusive)。それぞれの種類の意味は次の通りです。 `Unrestricted`—他のどのプロモーションとも組み合わせることができます。 `Preferential`—他の一部のプロモーションと組み合わせることができます。 `Exclusive`—他のどのプロモーションとも組み合わせることはできません。
FormattedPrice	表示用に書式設定された価格。
`IsInBenefitSet`	ブール値。True の場合、関連付けられている ASIN は、プロモーションの一部としてカスタマーが獲得できる商品です。
`IsInEligibilityRequirementSet`	ブール値。True の場合、プロモーションの資格を取得するために、カスタマーは関連付けられている ASIN を購入する必要があります。

次のレスポンス例には、これらの要素の値が示されています。

<ComponentType>ItemPrice</ComponentType> 
<CouponCombinationType>Unrestricted</CouponCombinationType>
<IsInBenefitSet>true</IsInBenefitSet>
<IsInEligibilityRequirementSet>true</IsInEligibilityRequirementSet>

これらの値は、プロモーションが商品価格の割引に基づいており("ItemPrice")、プロモーションをほかのどのプロモーションとも組み合わせることが可能で("Unrestricted")、商品は購入が必要で特典が付与されるものであることを示します("True")。

レスポンスの詳細については、PromotionDetails および PromotionSummary レスポンスグループをご参照ください。

関連するトピック