CartGet

説明

CartGet オペレーションを使用すると、「今は買わない」エリアにある商品 (SavedForLater) を含む、リモートショッピングカート内の全ての商品のID、数量、価格を取得できます。

カートの中身は、商品の在庫状況などによって変化するため、そのコピーをローカルに保持しないでください。代わりに、 CartGet を使用してリモートショッピングカート内の商品を取得してください。

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

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

関連する CartCreate リクエストで、AssociateTagを指定した場合、全ての CartGet リクエストにAssociateTagの値を指定する必要があります。指定しないと、リクエストが失敗します。

利用可能なサイト

全ての国のサイト

リクエストパラメータ

名前説明必須
AssociateTag

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

タイプ: 文字列

デフォルト値: なし

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

制約: AssociateTag を使用してカートを作成した場合は、そのショッピングカートに関連する以降の全てのリクエストにも AssociateTag を含める必要があります。

条件付き
CartId

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

タイプ: 文字列

デフォルト値: なし

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

はい
CartItemId

カート内の商品を一意に識別する半角英数字の文字列。ASIN または OfferListingId で指定した商品をカートに追加したあと商品を参照するには、CartItemIdを使用する必要があります。それ以外のIDは使用できません。

タイプ: 文字列

デフォルト値: なし

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

はい
HMAC

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

タイプ: 文字列

デフォルト値: なし

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

はい
MergeCart

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

タイプ: 文字列

デフォルト : False (US)

有効な値: True | False

いいえ
ResponseGroup

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

タイプ: 文字列

デフォルト値: Cart

有効な値:CartSimilarities | CartTopSellers | CartNewReleases

いいえ

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

レスポンス

名前説明
Amount 最低通貨単位(ペニーなど)を基準とした商品価格
CartId CartCreate で返される、カートを識別する半角英数字の文字列。
CartItem CartItemId、ASIN、MerchantId、SellerId、SellerNickname、Quantity、Title、ProductGroup、Price、ItemTotal のコンテナ。
CartItems Subtotal および CartItem のコンテナ。
CurrencyCode 金額の表示形式
FormattedPrice Web サイトでの表示金額
HMAC CartCreate で返される、カートを識別するハッシュメッセージ認証コード。これは暗号化された半角英数字で構成された文字列で、カートオペレーションの認証に使用されます。
ItemTotal Amount、CurrencyCode、および FormattedPrice のコンテナ。商品の価格に注文した数量を掛けたものです。
Price Amount、CurrencyCode、および FormattedPrice のコンテナ。1つの商品の価格です。
PurchaseURL カート内の商品購入に必要な URL。URL には、アソシエイトタグと呼ばれるアソシエイトの ID が含まれています。この PurchaseURL は必ず使用してください。使用しないと、アソシエイトは商品の販売に対する紹介料を受け取ることができません。AssociateTagは、 CartCreate のオプションパラメータですが、 CartCreate リクエストで省略した場合は、アソシエイトのIDを手動でPurchaseURLに追加する必要があります。
Subtotal Amount、CurrencyCode、およびFormattedPrice のコンテナ。小計は全商品の合計金額ですが、税金と配送料は含まれていません。
URLEncodedHMAC HMAC を URL エンコードしたもの。+や/などの文字は URL に使えないので、URL エンコードが必要となります。このパラメータの値は、処理を簡単にするために用意されています。この機能を使用しない場合、HMAC を自分で URL エンコードする必要があります。

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

指定したカートから全ての商品を取得する。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=CartGet&
CartId=[Cart ID]&
HMAC=[URL-encoded HMAC]

このオペレーションにより、指定したリモートショッピングカートから全ての商品が取得されます。HMACにはAssociateTagが含まれている可能性があるため、AssociateTagを使用してカートを作成した場合は、このリクエストで指定する必要があります。

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

レスポンス例

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

<CartId>002-9918938-1696046</CartId> 
  <HMAC>b0ogzvivVYLXjSZ9WwoBRFesFYU=</HMAC> 
<URLEncodedHMAC>b0ogzvivVYLXjSZ9WwoBRFesFYU=</URLEncodedHMAC> 
<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-id=002-9918938-1696046%26associate-id=ws%26hmac=b0ogzvivVYLXjSZ9WwoBRFesFYU=%26AWSAccessKeyId=1V293857EXAMPLEFW9C02%26MergeCart=False</PurchaseURL> 
  <SubTotal>
    <Amount>1994</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$19.94</FormattedPrice> 
  </SubTotal>
  <CartItems>
    <SubTotal>
      <Amount>1994</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$19.94</FormattedPrice> 
    </SubTotal>
    <CartItem>
      <CartItemId>U3KYV0C66V3PAA</CartItemId> 
      <ASIN>B000062TU1</ASIN> 
      <MerchantId>ATVPDKIKX0DER</MerchantId> 
      <SellerId>A2R2RITDJNW1Q6</SellerId> 
      <SellerNickname>Amazon.com, LLC</SellerNickname> 
      <Quantity>2</Quantity> 
      <Title>Harry Potter and the Sorcerer's Stone (Full Screen Edition) (Harry Potter 1)</Title> 
      <ProductGroup>DVD</ProductGroup> 
      <Price>
        <Amount>997</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$9.97</FormattedPrice> 
      </Price>
      <ItemTotal>
        <Amount>1994</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$19.94</FormattedPrice> 
      </ItemTotal>
    </CartItem>
  </CartItems>
</Cart>

このレスポンスには、指定したカート内の全ての商品が含まれます。

関連オペレーション