Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント
Amazon MWS ドキュメント

推奨情報のデータタイプ

AmazonマーケットプレイスWebサービス(Amazon MWS)レコメンドAPIセクションのリクエストパラメーターおよびレスポンス要素では、以下のデータタイプが使用されます。

データタイプ 説明
AdvertisingRecommendation スポンサー プロダクト プログラムを利用して商品の広告掲載を推奨。
CategoryQuery カテゴリー固有のフィルタを指定して、各カテゴリーに返される推奨情報のタイプを絞り込むことができます。
DimensionMeasure 寸法の単位と値
FulfillmentRecommendation 売れ筋商品の出荷に、フルフィルメントby Amazon(FBA)の利用を推奨。
GlobalSellingRecommendation 海外のマーケットプレイスへ商品を出品することを推奨。
InventoryRecommendation 在庫数少、または在庫切れの商品の補充を推奨。
ItemDimensions 商品の寸法。
ListingQualityRecommendation 現在のリストにある不備の修正を推奨する推奨情報。
Price 通貨の種類と金額。
PricingRecommendation 最低価格に設定されていない在庫商品の価格の見直しを推奨。
ProductIdentifier 商品のASIN、SKU、UPC
SelectionRecommendations Amazon.co.jpへ新規商品の出品を推奨。
WeightMeasure 重さの単位と値

AdvertisingRecommendation

スポンサー プロダクト プログラムを利用して商品の広告掲載を推奨。

オペレーション

AdvertisingRecommendation データタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ

以下の表は、AdvertisingRecommendationデータタイプ要素を示しています。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

BrandName 商品のブランド名。

任意

タイプ:xs:string

ProductCategory 商品の商品カテゴリ。

任意

タイプ:xs:string

SalesRank 指定した商品カテゴリにおける商品の販売ランク。

任意

タイプ:xs:int

YourPricePlusShipping 商品に設定した価格(配送料を含む)。

任意

タイプ: Price

LowestPricePlusShipping 同じConditionおよびSubConditionの商品に対する、配送料を含む最低価格。

任意

タイプ: Price

AvailableQuantity 在庫がある商品の総数。

任意

タイプ:xs:int

SalesForTheLast30Days 過去30日間の商品の販売数。

任意

タイプ:xs:int

CategoryQuery

カテゴリー固有のフィルタを指定して、各カテゴリーに返される推奨情報のタイプを絞り込むことができます。

オペレーション

CategoryQueryデータタイプは、以下のオペレーションのリクエスト・パラメーターで使用されます。

データタイプコンテンツ

以下の表は、CategoryQueryデータタイプの要素を示したものです。

名前 説明 必須 有効な値
RecommendationCategory 取得する推奨情報のカテゴリーを指定します。

タイプ:xs:string

はい RecommendationCategory値:
  • Selection
  • Fulfillment
  • ListingQuality
  • GlobalSelling
  • Advertising
注: ListRecommendationsオペレーションをリクエストするRecommendationCategoryリクエストパラメーターに指定されていないRecommendationCategoryの値をここで指定すると、この値は無視されます。
FilterOptions カテゴリー固有のフィルタを指定して、各カテゴリーに返される推奨情報のタイプを絞り込むことができます。

フィルターは FilterName=FilterValue のペアのリストとして指定します。 詳しくは、ListRecommendationsオペレーションの をご覧ください。

はい ListingQuality 推奨情報のためのFilterOptions値:
  • QualitySet=Defect – 改善が必要ですが、出品情報としては有効な情報をフィルターします。例えば、このクエリは詳細な商品説明がない出品情報を返します。
  • QualitySet=Quarantine – Amazonの規約に順守していないため、出品を取り下げられた出品情報をフィルターします。例えば、このクエリはメイン画像がない出品情報を返します。
  • ListingStatus=Active – 出品中の商品のみをフィルターします。 出品中のステータスになっている商品を在庫の中から返します。
  • ListingStatus=Inactive – 停止中の商品のみをフィルターします。 停止中のステータスになっている商品を在庫の中から返します。

SelectionFulfillmentGlobalSellingAdvertising の推奨情報のFilterOptions値:

  • BrandName=<BrandName> - 特定のブランド名の推奨情報をフィルター。
  • ProductCategory=<ProductCategory> - 特定の商品カテゴリーの推奨情報をフィルター。

Selection推奨情報のFilterOptions値:

  • IncludeCommonRecommendations=true - 限定した出品者の推奨情報に加え、全出品者に共通するSelection推奨情報を含む。
  • IncludeCommonRecommendations=false - 全出品者に共通したSelection推奨情報を含めないでください。 限定した出品者の推奨情報のみを含めます。

DimensionMeasure

オペレーション

DimensionMeasureデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ

以下の表は、DimensionMeasureデータタイプの要素を示したものです。

名前 説明
Value 寸法の値。

タイプ:xs:decimal

Unit 寸法の単位。

タイプ:xs:string

FulfillmentRecommendation

売れ筋商品の出荷に、フルフィルメントby Amazon(FBA)の利用を推奨。

オペレーション

FulfillmentRecommendationデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、FulfillmentRecommendationデータタイプの要素を示したものです。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

BrandName 商品のブランド名。

任意

タイプ:xs:string

ProductCategory 商品の商品カテゴリ。

任意

タイプ:xs:string

SalesRank 指定した商品カテゴリにおける商品の販売ランク。

任意

タイプ:xs:int

BuyboxPrice ショッピングカートボックスに表示される商品の価格。

任意

タイプ: Price

NumberOfOffers 商品に対する現在の出品数。

任意

タイプ:xs:int

NumberOfOffersFulfilledByAmazon Amazon.co.jpが発送するFBA商品に対する現在の出品数。

任意

タイプ:xs:int

AverageCustomerReview 商品の平均カスタマーレビュー。

任意

タイプ:xs:decimal

NumberOfCustomerReviews 商品に対するカスタマーレビュー数。

任意

タイプ:xs:int

ItemDimensions 商品の寸法。

任意

タイプ: ItemDimensions

GlobalSellingRecommendation

海外のマーケットプレイスへ商品を出品することを推奨。

オペレーション

GlobalSellingRecommendation データタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ

以下の表は、GlobalSellingRecommendationデータタイプ要素を示しています。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

BrandName 商品のブランド名。

任意

タイプ:xs:string

ProductCategory 商品の商品カテゴリ。

任意

タイプ:xs:string

SalesRank 指定した商品カテゴリにおける商品の販売ランク。

任意

タイプ:xs:int

BuyboxPrice ショッピングカートボックスに表示される商品の価格。

任意

タイプ: Price

NumberOfOffers 商品に対する現在の出品数。

任意

タイプ:xs:int

NumberOfOffersFulfilledByAmazon Amazon.co.jpが発送するFBA商品に対する現在の出品数。

任意

タイプ:xs:int

AverageCustomerReview 商品の平均カスタマーレビュー。

任意

タイプ:xs:decimal

NumberOfCustomerReviews 商品に対するカスタマーレビュー数。

任意

タイプ:xs:int

ItemDimensions 商品の寸法。

任意

タイプ: ItemDimensions

InventoryRecommendation

在庫数少、または在庫切れの商品の補充を推奨。

オペレーション

InventoryRecommendationデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、InventoryRecommendationデータタイプの要素を示したものです。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

FulfillmentChannel FulfillmentChannel値:
  • MFN - 出品者が商品を発送することを示します。
  • AFN - Amazon.co.jpが商品を発送することを示します。

任意

タイプ:xs:string

SalesForTheLast14Days 過去14日間の商品の販売数。

任意

タイプ:xs:int

SalesForTheLast30Days 過去30日間の商品の販売数。

任意

タイプ:xs:int

AvailableQuantity 在庫がある商品の総数。

任意

タイプ:xs:int

DaysUntilStockRunsOut 現在の販売数に基づく、商品の在庫がなくなるまでの推定日数。

任意

タイプ:xs:int

InboundQuantity 出品者が発送し、Amazonフルフィルメントセンターへ納品する商品の数(Amazon.co.jpが商品を発送する場合)。

任意

タイプ:xs:int

RecommendedInboundQuantity 出品者がAmazon.co.jpフルフィルメントセンターに発送する推奨情報の商品数(Amazon.co.jpが商品を発送する場合)。

任意

タイプ:xs:int

DaysOutOfStockLast30Days 過去30日間で商品の在庫が切れていた日数。

任意

タイプ:xs:int

LostSalesInLast30Days 在庫切れだったために失った推定販売数。

任意

タイプ:xs:int

ItemDimensions

商品の寸法。

オペレーション

ItemDimensionsデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、ItemDimensionsデータタイプの要素を示したものです。

名前 説明
Height 商品の高さ。

タイプ: DimensionMeasure

Width 商品の幅。

タイプ: DimensionMeasure

Length 商品の長さ。

タイプ: DimensionMeasure

Weight 商品の重量。

タイプ: WeightMeasure

ListingQualityRecommendation

現在のリストにある不備の修正を推奨する推奨情報。

オペレーション

ListingQualityRecommendationデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、PricingRecommendationデータタイプの要素を示したものです。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

QualitySet QualitySet values:
  • Defect – 出品情報は有効ではあるものの、不具合がある出品情報を示しています。例: 詳細な商品の説明がない出品情報など。
  • Quarantine – Amazonの規約を順守していないため、出品が取り下げられたことを示しています。 例: メイン画像がない出品情報など。

タイプ:xs:string

DefectGroup Defect QualitySetに示されている不具合のある出品情報の詳細。例: 画像がないなど。

任意

タイプ:xs:string

DefectAttribute Defect QualitySetにある商品固有の情報が不足している出品情報。例: 服のサイズなど。
ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

Price

通貨の種類と金額。

オペレーション

Priceデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、Priceデータタイプの要素を示したものです。

名前 説明
CurrencyCode 3桁の通貨コード。ISO 4217形式。

タイプ:xs:string

Amount 通貨の金額。

タイプ:xs:decimal

PricingRecommendation

最低価格に設定されていない在庫商品の価格の見直しを推奨。

オペレーション

PricingRecommendationデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、PricingRecommendationデータタイプの要素を示したものです。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

Condition 商品のコンディション。

任意

タイプ:xs:string

SubCondition 商品のサブコンディション。

任意

タイプ:xs:string

FulfillmentChannel FulfillmentChannel値:
  • MFN - 出品者が商品を発送することを示します。
  • AFN - Amazon.co.jpが商品を発送することを示します。

任意

タイプ:xs:string
YourPricePlusShipping 商品に設定した価格(配送料を含む)。

任意

タイプ: Price

LowestPricePlusShipping 同じConditionおよびSubConditionの商品に対する、配送料を含む最低価格。

任意

タイプ: Price

PriceDifferenceToLowPrice 同じConditionおよびSubConditionの商品に対する設定価格と最低価格との差。

任意

タイプ: Price

MedianPricePlusShipping 同じConditionおよびSubConditionの商品に対する、配送料を含む中間価格。

任意

タイプ: Price

LowestMerchantFulfilledOfferPrice 出品者が発送する、同じConditionおよびSubConditionの商品に対する最低価格。

任意

タイプ: Price

LowestAmazonFulfilledOfferPrice Amazon.co.jpが発送する、同じConditionおよびSubConditionの商品に対する最低価格。

任意

タイプ: Price

NumberOfOffers 商品に対する出品総数。

任意

タイプ:xs:int

NumberOfMerchantFulfilledOffers 出品者が発送する商品の出品総数。

任意

タイプ:xs:int

NumberOfAmazonFulfilledOffers Amazon.co.jpが発送する商品の出品総数。

任意

タイプ:xs:int

ProductIdentifier

商品のASIN、SKU、UPC

オペレーション

PricingIdentifierデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ

以下の表は、ProductIdentifierデータタイプの要素を示したものです。

名前 説明
ASIN 商品のASIN。

タイプ:xs:string

sku 商品のSKU。

タイプ:xs:string

JAN 商品のUPC。

タイプ:xs:string

SelectionRecommendations

Amazon.co.jpへ新規商品の出品を推奨。

オペレーション

SelectionRecommendationsデータタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ コンテンツ

以下の表は、SelectionRecommendationsデータタイプの要素を示したものです。

名前 説明
RecommendationId 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。

タイプ:xs:string

RecommendationReason 推奨情報の詳細な説明。

タイプ:xs:string

LastUpdated 推奨情報が生成された、または最後に更新された日時。ISO 8601形式。

タイプ:xs:dateTime

ItemIdentifier 商品のASIN、SKU、UPC。

タイプ: ProductIdentifier

ItemName 商品名。

任意

タイプ:xs:string

BrandName 商品のブランド名。

任意

タイプ:xs:string

ProductCategory 商品の商品カテゴリ。

任意

タイプ:xs:string

SalesRank 指定した商品カテゴリにおける商品の販売ランク。

任意

タイプ:xs:string

BuyboxPrice ショッピングカートボックスに表示される商品の価格。

任意

タイプ: Price

NumberOfOffers 商品に対する現在の出品数。

任意

タイプ:xs:int

AverageCustomerReview 商品の平均カスタマーレビュー。

任意

タイプ:xs:decimal

NumberOfCustomerReviews 商品に対するカスタマーレビュー数。

任意

タイプ:xs:int

WeightMeasure

重さの単位と値

オペレーション

WeightMeasure データタイプは、以下のオペレーションのレスポンス要素で使用されます。

データタイプ

以下の表は、WeightMeasureデータタイプの要素を示したものです。

名前 説明
Value 寸法の値。

タイプ:xs:decimal

Unit 寸法の単位。

タイプ:xs:string