 | ドキュメントのフィードバック |  |
CartClear オペレーションを使用すると、「今は買わない」(SavedForLater) エリアにある商品を含め、リモートショッピングカート内の商品をすべて削除することができます。カート内の商品の一部だけを削除、あるいは1つまたは複数の商品の数を減らす場合は、
CartModify
を使用してください。
リモートショッピングカートから全ての商品を削除するには、CartIdおよび、 HMACの値を使用してカートを指定する必要があります。これらは、 CartCreate オペレーションで返されます。HMACに類似した値であるURLEncodedHMACも返されます。この値は、HMACをURLエンコードしたものです。+や/などの文字はURLに使えないので、URLエンコードが必要となります。自分でHMACをエンコードすることはせずに、URLEncodedHMACをHMAC パラメータに使用してください。
CartClear は、カスタマーがPurchaseURLを使用して商品を購入するか、Amazon のカートに商品をマージすると使用できなくなります。
カートは空になってもそのまま存在します。カートの有効期間は、最後に操作してから7日間です。例えば6日前に作成したカートを変更した場合、有効期間は7日間にリセットされます。
全ての国のサイト
| 名前 | 説明 | 必須 |
|---|---|---|
AssociateTag
|
アソシエイトを一意に識別する半角英数字の文字列。この値は、 有効な値: 有効な | 状況次第 |
CartId
|
タイプ: 文字列 デフォルト値: なし 有効な値: | はい |
HMAC
|
ハッシュメッセージ認証コードは、暗号化された半角英数字で構成された文字列で、リクエストの認証に使用されます。 タイプ: 文字列 デフォルト値: なし 有効な値: 値は、リクエストパラメータとその値、暗号関数、および関数の「キー」となる秘密鍵/キーを使って計算されます。 | はい |
MergeCart
|
ブール値。True の場合、カスタマーのリモートショッピングカートの商品がカスタマーの Amazon リテールショッピングカートに追加されます。カスタマーがリモートショッピングカートの商品の購入を決定すると、True に設定されます。この値が False（デフォルト）の場合、リモートショッピングカートの中身はリテールショッピングカートに追加されません。この場合、カートの商品の購入を決定すると、カスタマーはオーダーパイプライン(購入手続き)に直接移動します。このパラメータは、US サイトでのみ有効です。ほかの全てのサイトでは無効ですが、リクエストは、パラメータの値が True に設定されている場合のように処理されます。 タイプ: 文字列 デフォルト : False (US) 有効な値: True | False | いいえ |
ResponseGroup
|
返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。 タイプ: 文字列 デフォルト: Cart | いいえ |
CartClear には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。
| 名前 | 説明 |
|---|---|
Cart
| リモートショッピングカート関連のレスポンス要素のコンテナ。 |
| のコンテナ。CartClearおよび、 HMACのコンテナ。 |
CartId
| CartCreate で返される、カートを一意に識別する半角英数字の文字列。 |
HMAC
| CartCreate で返される、カートを識別するハッシュメッセージ認証コード。これは暗号化された半角英数字で構成された文字列で、カートオペレーションの認証に使用されます。 |
URLEncodedHMAC
| HMACをURLエンコードしたものです。+や/などの文字はURLに使えないので、URLエンコードが必要となります。 |
これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。
指定されたカートから全ての商品を削除する:
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS アクセスキー ID]& AssociateTag=[Associate Tag]& Operation=CartClear& CartId=[Cart ID]& HMAC=[URL-encoded HMAC]
このオペレーションは、指定されたカート内の全ての商品を削除します。HMACにはAssociateTagが含まれているため、AssociateTagを使用してカートを作成した場合は、このリクエストで指定する必要があります。
このリクエストに対するレスポンスをレスポンス例に示します。
次のXMLコードは、最初のリクエスト例の完全なレスポンスの一部です。
<Cart>
<Request>
<IsValid>True</IsValid>
<CartClearRequest>
<CartId>102-2689399-8023324</CartId>
<HMAC>iLYO/W0hft0Te4uXAbMiBhs36T8=</HMAC>
</CartClearRequest>
</Request>
<CartId>102-2689399-8023324</CartId>
<HMAC>iLYO/W0hft0Te4uXAbMiBhs36T8=</HMAC>
<URLEncodedHMAC>iLYO/W0hft0Te4uXAbMiBhs36T8=</URLEncodedHMAC>
</Cart> 