 | ドキュメントのフィードバック |  |
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ではなく、 タイプ: 文字列 デフォルト値: なし 有効な値: 有効なASIN 制約: OfferListingIdを指定しない場合は必須 | Conditional |
CartId
|
CartCreate によって返される、カートを識別するための半角英数字で構成された文字列。 タイプ: 文字列 デフォルト値: なし 有効な値: | はい |
HMAC
|
ハッシュメッセージ認証コードは、暗号化された半角英数字で構成された文字列で、リクエストの認証に使用されます。 タイプ: 文字列 デフォルト値: なし 有効な値: 値は、リクエストパラメータとその値、暗号関数、および関数の「キー」となる秘密鍵/ーを使って計算されます。 | はい |
Item
| ASIN または OfferListingIdおよび Quantityのコンテナ。これは SOAP 独自のパラメータです。有効な値: | はい (SOAP のみ) |
Items
| 1つまたは複数のItemのコンテナ。これは SOAP 独自のパラメータです。有効な値: Item | はい (SOAP のみ) |
ListItemId
|
タイプ: 文字列 デフォルト値: なし 有効な値: 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 | いいえ |
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に追加されます。もしAssociateTagを CartCreate で指定せず、あとで追加したい場合は、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>