CartClear

説明

CartClear オペレーションを使用すると、「今は買わない」(SavedForLater) エリアにある商品を含め、リモートショッピングカート内の商品をすべて削除することができます。カート内の商品の一部だけを削除、あるいは1つまたは複数の商品の数を減らす場合は、 CartModify を使用してください。

リモートショッピングカートから全ての商品を削除するには、CartIdおよび、 HMACの値を使用してカートを指定する必要があります。これらは、 CartCreate オペレーションで返されます。HMACに類似した値であるURLEncodedHMACも返されます。この値は、HMACをURLエンコードしたものです。+や/などの文字はURLに使えないので、URLエンコードが必要となります。自分でHMACをエンコードすることはせずに、URLEncodedHMACHMAC パラメータに使用してください。

CartClear は、カスタマーがPurchaseURLを使用して商品を購入するか、Amazon のカートに商品をマージすると使用できなくなります。

カートは空になってもそのまま存在します。カートの有効期間は、最後に操作してから7日間です。例えば6日前に作成したカートを変更した場合、有効期間は7日間にリセットされます。

利用可能なサイト

全ての国のサイト

リクエストパラメータ

名前説明必須
AssociateTag

アソシエイトを一意に識別する半角英数字の文字列。この値は、AssociateTagを使用してカートを作成した場合に限り必須です。

有効な値: 有効なAssociateTagで、関連する CartCreate リクエストで使用したもの。

状況次第
CartId

CartCreate で返される、カートを識別する半角英数字の文字列。

タイプ: 文字列

デフォルト値: なし

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

はい
HMAC

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

タイプ: 文字列

デフォルト値: なし

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

はい
MergeCart

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

タイプ: 文字列

デフォルト : False (US)

有効な値: True | False

いいえ
ResponseGroup

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

タイプ: 文字列

デフォルト: Cart

いいえ

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

レスポンス

名前説明
Cart リモートショッピングカート関連のレスポンス要素のコンテナ。
CartClearRequest のコンテナ。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>  

関連オペレーション