Commerce Webstore Cart Items

カートへの参照アクセス権を持つバイヤーは、カートで品目を追加、更新、および削除できます。

カートへの品目の追加ではバイヤーの「商品を表示」エンタイトルメントが適用され、商品データを表示する資格があるユーザのみがアクセスできます。

リソース

1/commerce/webstores/webstoreId/carts/cartStateOrId/cart-items

cartStateOrId の値は次のとおりです。

• cartId — カートの ID。
• active — 有効なカート。
• current — クローズまたは削除待機中でないカート。バージョン 50.0 以降で利用できます。

使用可能なバージョン

49.0

Chatter が必要かどうか

いいえ

HTTP メソッド

GET、POST

GET の要求パラメータ

名前	型	説明	必須か省略可能	使用可能なバージョン
effective​AccountId	String	要求が行われたバイヤー取引先またはゲストバイヤープロファイルの ID。 指定されていない場合、デフォルト値はコンテキストから決定されます。	省略可能	49.0
page	String	情報ページの表示に使用するページトークンを指定します。ページトークンは、currentPageToken または nextPageToken のように、応答の一部として返されます。値を指定しないと、最初のページが返されます。	省略可能	49.0
pageSize	Integer	ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。値を指定しない場合、デフォルトサイズは 25 です。	省略可能	49.0
productFields	String	商品項目が 5 個のカンマ区切りリスト。結果に含まれるのは、アクセス権のある項目のみです。商品項目によっては (productName や sku など)、productFields パラメータに指定されていなくても返されるものがあります。	省略可能	49.0
sort	String	カート内の品目の順序を並び替えます。値は次のとおりです。 CreatedDateAsc — 作成日の古い順に並び替えます。 CreatedDateDesc — 作成日の新しい順に並び替えます。 NameAsc — 名前がアルファベットの昇順 (A ～ Z) で並び替えられます。 NameDesc — 名前がアルファベットの降順 (Z ～ A) で並び替えられます。 SalesPriceAsc — 交渉済み価格が低い順に並び替えられます。 SalesPriceDesc — 交渉済み価格が高い順に並び替えられます。 指定されていない場合、デフォルトは CreatedDateDesc です。	省略可能	49.0

GET のレスポンスボディ

Cart Item Collection

POST のリクエストボディ

ルート XML タグ

<cartItem>

カートに品目を追加する JSON の例

1{
2   "productId":"01t000000000000000",
3   "quantity":"5",
4   "type":"Product"
5}

カートの品目を更新する JSON の例

1{
2   "quantity":"7"
3}

プロパティ

名前	型	説明	必須か省略可能	使用可能なバージョン
productId	String	商品の ID。	カートに品目を追加する場合は必須 (POST) カートの品目を更新する場合はサポート対象外 (PATCH)	49.0
quantity	String	カート品目の数量。BigDecimal に変換可能な値を使用します。	必須	49.0
type	String	カート内の品目の種別。値は Product です。	カートに品目を追加する場合は必須 (POST) カートの品目を更新する場合はサポート対象外 (PATCH)	49.0

POST の要求パラメータ

パラメータ名	型	説明	必須か省略可能	使用可能なバージョン
effective​AccountId	String	要求が行われたバイヤー取引先またはゲストバイヤープロファイルの ID。 指定されていない場合、デフォルト値はコンテキストから決定されます。	省略可能	49.0
productFields	String	商品項目が 5 個のカンマ区切りリスト。結果に含まれるのは、アクセス権のある項目のみです。	省略可能	49.0

POST のレスポンスボディ

Cart Item