「今は買わない」エリアに商品を追加する

「今は買わない」エリアに商品を追加するには、Action パラメータの値として "SaveForLater" を CartModify オペレーションで指定します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
AssociateTag=[アソシエイトID]&
Operation=CartModify&
CartId=[Cart ID]&
HMAC=[HMAC]&
Item.1.CartItemId=[Cart Item ID]&
Item.1.Quantity=1
Item.1.Action=SaveForLater

このリクエストで、Item.1で示される商品がカートの「今は買わない」エリアに移動されます。Quantityパラメータを使用すると、1種類の商品の一部だけを「今は買わない」エリアに移動できます。例えば、 Saving Miss Oliver's という本がカート内に15冊ある場合、そのうちの8冊を「今は買わない」エリアに移動するには、上の例でItem.1.Quantity=8を設定します。

アクティブエリアと「今は買わない」エリアの間で商品を移動できるのは、 CartModify だけです。つまり、商品を直接「今は買わない」エリアに追加することはできません。まず、 CartCreate または CartAdd を使用して商品をカートに追加してから、「今は買わない」エリアに移動する必要があります。現在商品の在庫がない場合、商品は自動的に「今は買わない」エリアに移動されます。 CartModify では、商品が在庫ありになるまで商品をアクティブエリアに移動できません。商品が在庫ありになると、商品はアクティブエリアに自動的に移動されます。

[注]注意

Actionパラメータの値は "SaveForLater" です。レスポンスの一部である次のXMLコードに示すように、「今は買わない」エリアの商品は、XMLレスポンス内で SavedForLaterItem 要素によってタグ付けされます。

<SavedForLaterItem>
  <CartItemId>ULI7S9IYFJHX0</CartItemId>
  <ASIN>B0009GZV4A</ASIN>
  <MerchantId>ATVPDKIKX0DER</MerchantId>
  <SellerId>A2R2RITDJNW1Q6</SellerId>
  <Quantity>2</Quantity>
  <Title>Mark VII Men's Short Sleeve Golf Shirts with 
   Tri -Colored Stripe Trim</Title>
  <ItemTotal>
    <Amount>1288</Amount>
    <CurrencyCode>USD</CurrencyCode>
    <FormattedPrice>$12.88</FormattedPrice>
  </ItemTotal>
</SavedForLaterItem>

「今は買わない」エリアからアクティブエリアに商品を移動するには、"MoveToCart" をActionパラメータの値として、 CartModify オペレーションで使用します:

Item.1.CartItemId=[Cart Item ID]&
Item.1.Quantity=1
Item.1.Action=MoveToCart