CartCreate

説明

CartCreate オペレーションを実行して、リモートショッピングカートを作成することができます。ショッピングカートという言葉は、Eコマースソリューションで一般的に使われている比喩的表現です。これは、Amazon のサーバ上で一時的にデータを格納する構造のことです。ここには、カスタマーが購入したい商品が格納されています。Product Advertising API でショッピングカートがリモートショッピングカートと呼ばれるのは、Amazon のサーバがホストとしてカートを処理するためです。このようにカートは、カスタマーが購入する商品を見たり選んだりしている販売者の Web サイトから離れた場所にあります。

商品のListItemIdおよび ASIN、またはOfferListingIDを指定してカートに商品を追加すると、商品にCartItemIdが割り当てられ、その値でしかアクセスできなくなります。つまり、以降のリクエストでは、ListItemIdおよびASIN、またはOfferListingIdを使ってカート内の商品にアクセスできないということです。CartItemIdは、 CartCreate, CartGet, および CartAddで返されます。

カートの中身は、商品の在庫状況などによって変化するため、そのコピーをローカルに保持しないでください。代わりに、他のカートオペレーションを使用してカートの中身を変更してください。例えば、CartItemIdsで示されるカートの中身は、 CartGetで取得できます。

在庫があれば、カート商品として追加されます。在庫がなければ(商品が一時的に在庫切れの場合、製造中止の場合、将来リリースされる予定の場合など)、「今は買わない」エリアに追加 (SaveForLaterItems) されます。エラーは生成されません。Amazon のデータベースは定期的に更新されます。出品 ID を持つ商品が見つかっても、カートに追加するまでに在庫がなくなってしまうこともあります。オーダーパイプラインの「レジに進む」ページでは、在庫のある商品(ショッピングカートの商品)と「今は買わない」商品(カートに保存した商品、SaveForLaterItems)が分かれて表示されます。

空のショッピングカートを作成することはできません。1回の CartCreate リクエストで少なくとも1つの商品をショッピングカートに追加する必要があります。商品ごとに特定の数(最大999個)だけ追加できます。

CartCreate は、ショッピングカートの有効期間に一度しか使えません。カートの中身を変更するには、他のカートオペレーションを使用します。

カートは削除できません。ですが、7日間使用しないと自動的に期限切れになります。ただし、カートの中身を変更するたびに有効期間はリセットされます。したがって、カートは作成してから7日間を超えても存在している場合があります。例えば、6日目にカスタマーがカートを変更すると、有効期間はその時点から7日間延長されます。

商品を指定する

1回の CartCreate リクエストで商品を10種類まで追加できます。各商品の数は個別に設定します。次に例を示します。

Item.1.OfferListingId=[Offer Listing ID]&
Item.1.Quantity=3&
Item.2.OfferListingId=[Offer Listing ID]
Item.2.Quantity=1  

このコーディング例では、OfferListingIds で識別される2つの商品が、それぞれ3個と1個追加されます。

1回のリクエストで、ListItemIdおよびASINまたはOfferListingIdを自由に組み合わせてカートに追加する商品を指定できます。カートに商品を追加するには、1種類の商品 ID しか使用できません。例えば、ASINおよびOfferListingIdを同じリクエストで使用して、同じ商品をカートに追加することはできません。

カートに商品を追加する際のフォーマットの詳細については、 CartAdd をご参照ください。

利用可能なサイト

全ての国のサイト

リクエストパラメータ

名前説明必須
ASIN

商品を一意に識別する半角英数字の文字列。商品をカートに追加する際には、ASIN ではなく OfferListingId を使用することをお勧めします。

有効な値: ASIN

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

条件付き
AssociateTag

アソシエイトを一意に識別する半角英数字の文字列。この値が指定されていないと、アソシエイトはカスタマーの購入に対する紹介料を受け取ることができません。この値が指定されている場合は、このカートに関連する以降の全てのカートオペレーションでも指定する必要があります。

タイプ: 文字列

デフォルト: なし

有効な値: アソシエイトタグ

いいえ
Item

RESTの場合のASINおよび数量の接頭辞。どちらもカートに追加する商品を指定するのに使用されます。例えば、次のように指定します。item.1.ASIN=1234abcd, item.1.quantity=2.

有効な値: 値は指定しません。

タイプ: 文字列

デフォルト: なし

はい
Items 1つ以上の Item オブジェクトのコンテナ。これは SOAP 独自のパラメータです。いいえ
ListItemId

ほしい物リストの商品を一意に識別する半角英数字の文字列この値は、ListItems レスポンスグループによって返されます。ListItemIdを指定することで、リストオーナーの名前とアドレスがリクエストに添付されます (ASINだけでは添付されません)。なお、ASINまたは OfferListingId も、ListItemIdに加えて必要となります。

タイプ: 文字列

デフォルト: なし

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

いいえ
MergeCart

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

タイプ: 文字列

デフォルト : False (US)

有効な値: True | False

いいえ
OfferListingId

出品 ID は、商品を一意に識別する半角英数字の文字列です。OfferListingIdは、カートに商品を追加する際に、ASINの代わりに使用されます。

タイプ: 文字列

デフォルト: なし

有効な値: 有効な出品 ID

制約: ASINを使用しない場合は必須。

条件付き
Quantity

Itemとともに使用してカートに追加する商品の個数を指定する接尾辞。次に例を示します。

Item.1.ASIN=0976925524

Item.1.Quantity=2.

詳細については、Itemをご参照ください。

タイプ: 文字列

デフォルト: なし

有効な値: 正の整数

いいえ
ResponseGroup

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

タイプ: 文字列

デフォルト : Cart

有効な値:CartSimilarities | CartTopSellers | CartNewReleases

いいえ

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

レスポンス

名前説明
Amount 最低通貨単位(ペニーなど)を基準とした商品価格。
ASIN 商品を一意に識別する半角英数字の文字列。
Cart カート内の全ての要素のコンテナ。
CartCreateRequest 要求された全ての要素のコンテナ。
CartId カートを一意に識別する半角英数字の文字列。この値は、このカートに関連する以降の全てのカートオペレーションに指定する必要があります。
CartItems カート内の各商品の購入に関連する情報のコンテナ。
CurrencyCode 価格の表示形式を指定するコード。
FormattedPrice カスタマーに表示する商品の価格。
HMAC リクエストの認証に使われるエンコードされた値。の値は、このカートに関連する以降の全てのカートオペレーションに指定する必要があります。
ItemTotal 1種類の商品の小計。
PurchaseURL カスタマーが商品の購入時に使用するURL。URL にAssociateTagが含まれていると、アソシエイトはカスタマーの商品の購入額に応じて紹介料を受け取ることができます。
Quantity 注文した個々の商品数。
SavedForLaterItems カートに追加されているが、現在在庫がない商品のコンテナオブジェクト。
SubTotal カート内の全ての商品に税金と配送料を加算する前の小計。
URLEncodedHMAC HMAC を URL エンコードしたもの。HMAC は URL に設定する必要があるため、URL互換であることが必須です。このカートに関連する以降の全てのリクエストでは、HMAC の代わりにこの値を使用してください。

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

リモートショッピングカートを作成し、数量の異なる複数の商品をカートに追加する。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=CartCreate&
Item.1.ASIN=[ASIN]&
Item.1.Quantity=2&
Item.2.ASIN=[ASIN]&
Item.2.Quantity=7&
Item.3.ASIN=[ASIN]&
Item.3.Quantity=5

このリクエストではリモートショッピングカートを作成し、3種類の商品を追加しています。商品の数量は、それぞれ2、7、5個です。このリクエストに対するレスポンスをレスポンス例に示します。

Amazon が出品していない可能性がある商品を追加して、ショッピングカートを作成する。

http:// ecs.amazonaws.com/onca/xml
?Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=CartCreate&
Item.1.OfferListingId=[Offer Listing ID]&
Item.1.Quantity=2&
Item.2.OfferListingId=[Offer Listing ID]&
Item.2.Quantity=7&
Item.3.OfferListingId=[Offer Listing ID]&
Item.3.Quantity=5

このリクエストではリモートショッピングカートを作成し、Amazon 以外が出品している3種類の商品を追加しています。商品の数量は、それぞれ2、7、5個です。OfferListingId は、Amazon を含む全ての出品者およびマーチャントが出品している商品を返します。

レスポンス例

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

<Cart>
  <Request>
    <IsValid>True</IsValid> 
    <CartCreateRequest>
      <Items>
        <Item>
          <ASIN>B000062TU1</ASIN> 
          <Quantity>2</Quantity> 
        </Item>
      </Items>
    </CartCreateRequest>
  </Request>
  <CartId>102-5014548-4857758</CartId> 
  <HMAC>O2p9hhZwJShnp6ZDWvZDO6FhpAI=</HMAC> 
  <URLEncodedHMAC>O2p9hhZwJShnp6ZDWvZDO6FhpAI=</URLEncodedHMAC> 

<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-id=102-5014548-4857758%26associate-id=ws%26hmac=O2p9hhZwJShnp6ZDWvZDO6FhpAI=%26AWSAccessKeyId=1VMEXAMPLEW9C02%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>U31XY1DHZEGCTB</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>

SavedForLaterItem のレスポンス例

次に示すレスポンス例は、現在在庫がない商品のカートへの追加を示します。リテール Web サイトでは、これらの商品は「今は買わない」として表示されます。

<SavedForLaterItems>
  <SubTotal>
    <Amount>1288</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$12.88</FormattedPrice> 
  </SubTotal>
  <SavedForLaterItem>
    <CartItemId>ULI7S9IYFJHX0</CartItemId> 
    <ASIN>B0009GZV4A</ASIN> 
    <MerchantId>ATVPDKIKX0DER</MerchantId> 
    <SellerId>A2R2RITDJNW1Q6</SellerId> 
    <Quantity>2</Quantity> 
    <Title>Mark VII Men's Short Sleeve Golf Shirts with Tri -Colored Stripe Trim</Title> 
    <ProductGroup>Apparel</ProductGroup> 
    <Price>
      <Amount>644</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$6.44</FormattedPrice> 
    </Price>
    <ItemTotal>
      <Amount>1288</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$12.88</FormattedPrice> 
    </ItemTotal>
  </SavedForLaterItem>
</SavedForLaterItems>

関連オペレーション