Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
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データタイプ要素を示しています。
名前 | 説明 |
---|---|
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データタイプの要素を示したものです。
名前 | 説明 | 必須 | 有効な値 |
---|---|---|---|
RecommendationCategory | 取得する推奨情報のカテゴリーを指定します。
タイプ:xs:string |
はい | RecommendationCategory値:
注: ListRecommendationsオペレーションをリクエストするRecommendationCategoryリクエストパラメーターに指定されていないRecommendationCategoryの値をここで指定すると、この値は無視されます。
|
FilterOptions | カテゴリー固有のフィルタを指定して、各カテゴリーに返される推奨情報のタイプを絞り込むことができます。 フィルターは FilterName=FilterValue のペアのリストとして指定します。 詳しくは、ListRecommendationsオペレーションの 例 をご覧ください。 |
はい | ListingQuality 推奨情報のためのFilterOptions値:
Selection、Fulfillment、GlobalSelling、Advertising の推奨情報のFilterOptions値:
Selection推奨情報のFilterOptions値:
|
DimensionMeasureデータタイプは、以下のオペレーションのレスポンス要素で使用されます。
以下の表は、DimensionMeasureデータタイプの要素を示したものです。
名前 | 説明 |
---|---|
Value | 寸法の値。 タイプ:xs:decimal |
Unit | 寸法の単位。 タイプ:xs:string |
売れ筋商品の出荷に、フルフィルメント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データタイプ要素を示しています。
名前 | 説明 |
---|---|
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データタイプの要素を示したものです。
名前 | 説明 |
---|---|
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値:
任意 タイプ: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データタイプの要素を示したものです。
名前 | 説明 |
---|---|
Height | 商品の高さ。 タイプ: DimensionMeasure |
Width | 商品の幅。 タイプ: DimensionMeasure |
Length | 商品の長さ。 タイプ: DimensionMeasure |
Weight | 商品の重量。 タイプ: WeightMeasure |
現在のリストにある不備の修正を推奨する推奨情報。
ListingQualityRecommendationデータタイプは、以下のオペレーションのレスポンス要素で使用されます。
以下の表は、PricingRecommendationデータタイプの要素を示したものです。
名前 | 説明 |
---|---|
RecommendationId | 固有の推奨情報ID。形式は、{Category}-{RecommendationReason}-{ASIN}-{SKU}-{UPC}-{ItemName}。これらの値のいずれかがnull値である場合、値は空になります。
タイプ:xs:string |
RecommendationReason | 推奨情報の詳細な説明。
タイプ:xs:string |
QualitySet | QualitySet values:
タイプ:xs:string |
DefectGroup | Defect QualitySetに示されている不具合のある出品情報の詳細。例: 画像がないなど。
任意 タイプ:xs:string |
DefectAttribute | Defect QualitySetにある商品固有の情報が不足している出品情報。例: 服のサイズなど。 |
ItemIdentifier | 商品のASIN、SKU、UPC。 タイプ: ProductIdentifier |
ItemName | 商品名。
任意 タイプ:xs:string |
通貨の種類と金額。
以下の表は、Priceデータタイプの要素を示したものです。
名前 | 説明 |
---|---|
CurrencyCode | 3桁の通貨コード。ISO 4217形式。 タイプ:xs:string |
Amount | 通貨の金額。 タイプ:xs:decimal |
最低価格に設定されていない在庫商品の価格の見直しを推奨。
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値:
任意 タイプ: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 |
商品のASIN、SKU、UPC
PricingIdentifierデータタイプは、以下のオペレーションのレスポンス要素で使用されます。
以下の表は、ProductIdentifierデータタイプの要素を示したものです。
名前 | 説明 |
---|---|
ASIN | 商品のASIN。 タイプ:xs:string |
sku | 商品のSKU。 タイプ:xs:string |
JAN | 商品のUPC。 タイプ:xs:string |
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データタイプの要素を示したものです。
名前 | 説明 |
---|---|
Value | 寸法の値。 タイプ:xs:decimal |
Unit | 寸法の単位。 タイプ:xs:string |