推奨情報のデータタイプ

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データタイプは、以下のオペレーションのリクエスト・パラメーターで使用されます。

ListRecommendations

データタイプコンテンツ

以下の表は、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` – 停止中の商品のみをフィルターします。停止中のステータスになっている商品を在庫の中から返します。 `Selection`、`Fulfillment`、`GlobalSelling`、`Advertising` の推奨情報のFilterOptions値： `BrandName=<BrandName>` - 特定のブランド名の推奨情報をフィルター。 `ProductCategory=<ProductCategory>` - 特定の商品カテゴリーの推奨情報をフィルター。 `Selection`推奨情報のFilterOptions値： `IncludeCommonRecommendations=true` - 限定した出品者の推奨情報に加え、全出品者に共通する`Selection`推奨情報を含む。 `IncludeCommonRecommendations=false` - 全出品者に共通した`Selection`推奨情報を含めないでください。限定した出品者の推奨情報のみを含めます。

名前

説明

必須

有効な値

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 – 停止中の商品のみをフィルターします。停止中のステータスになっている商品を在庫の中から返します。

Selection、Fulfillment、GlobalSelling、Advertising の推奨情報の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

Deprecation Notice:

推奨情報のデータタイプ

AdvertisingRecommendation

オペレーション

データタイプ

CategoryQuery

オペレーション

データタイプコンテンツ

DimensionMeasure

オペレーション

データタイプ

FulfillmentRecommendation

オペレーション

データタイプ コンテンツ

GlobalSellingRecommendation

オペレーション

データタイプ

InventoryRecommendation

オペレーション

データタイプ コンテンツ

ItemDimensions

オペレーション

データタイプ コンテンツ

ListingQualityRecommendation

オペレーション

データタイプ コンテンツ

Price

オペレーション

データタイプ コンテンツ

PricingRecommendation

オペレーション

データタイプ コンテンツ

ProductIdentifier

オペレーション

データタイプ

SelectionRecommendations

オペレーション

データタイプ コンテンツ

WeightMeasure

オペレーション

データタイプ

関連トピック

データタイプコンテンツ

データタイプコンテンツ

データタイプコンテンツ

データタイプコンテンツ

データタイプコンテンツ

データタイプコンテンツ

データタイプコンテンツ