CartAdd

説明

CartAdd オペレーションを使用すると、既存のリモートショッピングカートに商品を追加することができます。 CartAdd 新しい商品をショッピングカートに追加する場合にのみ使用できます。これを使って、カートに既に入っている商品の数を増やすことはできません。カートに既に入っている商品の数を増やすには、 CartModify オペレーションを使用する必要があります。

カートに商品を追加するには、商品のOfferListingId, または ASINおよび、 ListItemIdのいずれかを指定します。カートに入れられた商品は、CartItemIdでしか識別できなくなります。つまり、ASINやOfferListingIdを使ってカート内の商品にアクセスすることはできません。CartItemIdは、 CartCreate, CartGet および CartAddで返されます。

カートに商品を追加するには、CartIdおよび、 HMACの値を使用してカートを指定する必要があります。これらは、 CartCreate オペレーションで返されます。

関連するCartCreateリクエストで AssociateTagを指定した場合、全ての CartAdd リクエストにアソシエイトタグの値を指定する必要があります。そうしないと、リクエストが失敗します。

利用可能なサイト

全ての国のサイト

リクエストパラメータ

名前説明必須
ASIN

カート内で変更する商品を指定します。Nは 1~ 10の正の整数です。一度に商品を10個まで変更できます。商品のASINではなく、OfferListingIdを使用することをお勧めします。

タイプ: 文字列

デフォルト値: なし

有効な値: 有効なASIN

制約: OfferListingIdを指定しない場合は必須

Conditional
CartId

CartCreate によって返される、カートを識別するための半角英数字で構成された文字列。

タイプ: 文字列

デフォルト値: なし

有効な値: CartCreateによって返される値。

はい
HMAC

ハッシュメッセージ認証コードは、暗号化された半角英数字で構成された文字列で、リクエストの認証に使用されます。

タイプ: 文字列

デフォルト値: なし

有効な値: 値は、リクエストパラメータとその値、暗号関数、および関数の「キー」となる秘密鍵/ーを使って計算されます。

はい
Item ASIN または OfferListingIdおよび Quantityのコンテナ。これは SOAP 独自のパラメータです。

有効な値: ASINまたはOfferListingId が必要です。

はい (SOAP のみ)
Items 1つまたは複数のItemのコンテナ。これは SOAP 独自のパラメータです。

有効な値: Item

はい (SOAP のみ)
ListItemId

ListItemIdの値は、ListItems レスポンスグループによって返されます。このパラメータは、ほしい物リストなどのリストにある商品を示します。この商品をカートに追加するには、 CartAdd リクエストに商品の ASIN とListItemIdを指定する必要があります。ListItemIdを指定することで、リストオーナーの名前とアドレスが返されます(ASINを指定しただけでは返されません)。

タイプ: 文字列

デフォルト値: なし

有効な値: ListItems レスポンスグループによって返される半角英数字の識別情報。

いいえ
MergeCart

ブール値。True の場合、カスタマーのリモートショッピングカートの商品がカスタマーの Amazon リテールショッピングカートに追加されます。カスタマーがリモートショッピングカートの商品の購入を決定すると、True に設定されます。この値が False (デフォルト) の場合、リモートショッピングカートの中身はリテールショッピングカートに追加されません。この場合、カートの商品の購入を決定すると、カスタマーはオーダーパイプライン(購入手続き)に直接移動します。このパラメータは、USサイトでのみ有効です。ほかのすべてのサイトでは無効ですが、リクエストは、パラメータの値が True に設定されている場合のように処理されます。

タイプ: 文字列

デフォルト : False (US)

有効な値: True | False

いいえ
OfferListingId

出品IDは、Amazon も含め全てのマーチャントによって出品されている商品を一意に識別する文字列です。カートに商品を追加する際は、ASINではなくこのパラメータを使うことをおすすめします。

タイプ: 文字列

デフォルト値: なし

有効な値: 有効な出品ID

制約: ASIN を指定しない場合は必須

条件付き
Quantity

カートに追加する商品の数を指定します。N は正の整数です。Quantity の値は、インデックスナンバー N によって Item.N.CartItemId の値に対応付けられます。例えば、 Item.1.CartItemId は Item.1.Quantity に対応します。

タイプ: 文字列

デフォルト値: なし

有効な値: 1~ 999までの整数

REST では条件付きで必須

条件付き
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

タイプ: 文字列

デフォルト: Cart

有効な値:CartSimilarities | CartTopSellers | CartNewReleases

いいえ

CartAdd には、すべてのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

レスポンス

名前説明
Amount 最低通貨単位(ペニーなど)を基準とした商品価格
ASIN Amazon によって出品される商品を一意に識別する英数字の文字列。
CartAddRequest CartId, HMAC および 商品のコンテナ。
CartId CartCreate で返される、カートを識別する半角英数字の文字列。
CurrencyCode 金額の表示形式
FormattedPrice Web サイトでの表示金額
HMAC CartCreate で返される、カートを識別するハッシュメッセージ認証コード。これは暗号化された半角英数字で構成された文字列で、カートオペレーションの認証に使用されます。
Item ASIN または OfferListingId, および Quantityのコンテナ。
Items 1つまたは複数の商品のコンテナ。
PurchaseURL カート内の商品購入に必要な URL。ここにはアソシエイト ID が含まれています。この URL は必ず使用してください。使用しないと、アソシエイトとしての商品の紹介料を受け取ることができません。AssociateTagパラメータを CartCreateリクエストで指定するかどうかは任意です。 CartCreate リクエストで指定すると、AssociateTagが自動的にPurchaseURLに追加されます。もしAssociateTagCartCreate で指定せず、あとで追加したい場合は、PurchaseURLの値に手動でパラメータを追加する必要があります。
Quantity カートに追加された商品の数。
Subtotal Amount、CurrencyCode、および FormattedPrice のコンテナ。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。

カートに1つの商品を追加する:

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
CartId=[CartId]&
HMAC=[HMAC]&
Operation=CartAdd&
Item.1.OfferListingId=[Offer Listing ID]&

Item.1.Quantity=1

このリクエストに対するレスポンスをレスポンス例に示します。

複数の商品をカートに追加する。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
CartId=[CartId]&
HMAC=[HMAC]&
Operation=CartAdd&
Item.1.OfferListingId=[Offer Listing ID]&
Item.1.Quantity=1&
Item.2.OfferListingId=[Offer Listing ID]&
Item.2.Quantity=3&
Item.3.OfferListingId=[Offer Listing ID]&
Item.3.Quantity=1

このリクエストは、3つの違った商品をカートに入れます。1つのカートは、50までの違った商品を格納でき、それぞれ最大のQuantity値として99個格納できます。

リストから商品をカートに追加。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
CartId=[CartId]&
HMAC=[HMAC]&
Operation=CartAdd&
Item.1.ASIN=[ASIN]&
Item.1.Quantity=3&
Item.1.ListItemId=[List item ID]

このリクエストでは、3種類の商品をカートに追加します。

レスポンス例

次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。

<CartAddRequest>
  <CartId>102-6666665-5792105</CartId> 
  <HMAC>oRqNBTpiRBugxEKEJ+FyUZkVbEg=</HMAC> 
  <Items>
    <Item>
      <ASIN>1400042127</ASIN> 
      <Quantity>1</Quantity> 
    </Item>
  </Items>
</CartAddRequest>
</Request>
  <CartId>102-6666665-5792105</CartId> 
  <HMAC>oRqNBTpiRBugxEKEJ+FyUZkVbEg=</HMAC> 
  <URLEncodedHMAC>oRqNBTpiRBugxEKEJ%2BFyUZkVbEg=</URLEncodedHMAC> 
<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-id=102-5929035-5792105%26associate-id=ws%26hmac=oRqNBTpiRBugxEKEJ%2BFyUZkVbEg=%26AWSAccessKeyId=[AWS アクセスキー ID]%26MergeCart=False</PurchaseURL> 
  <SubTotal>
    <Amount>3432</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$34.32</FormattedPrice> 
  </SubTotal>

関連オペレーション