亚马逊电商数据自动化管理接口平台ProductType格式展示
重要说明
- 本文章为亚马逊系列其中的一篇,具体详见 主页 中亚马逊分类
- 该系列项目均为【CSDN轻夏】原创,未经允许禁止转载
- 如有疑问请添加qq群聊302493982学习咨询
1、ProductType大类别
根据上篇文章,获得了ProductType类型,下面来展示具体类型的结构
2、ProductType获取详细信息
下面以 “ PRODUCT ” 为例,注意PRODUCT不可作为类型
返回详细信息,下面是返回结果
放入json查看器(https://www.bejson.com/jsonviewernew/)可以看到结构
{
"$schema": "https://schemas.amazon.com/selling-partners/definitions/product-types/meta-schema/v1",
"$id": "https://schemas.amazon.com/selling-partners/definitions/product-types/schema/v1/PRODUCT",
"$comment": "Amazon product type definition for PRODUCT product type",
"$defs": {...},
"type": "object",
"required": [...],
"properties": {...},
"additionalProperties": false,
"allOf": [...]
}
3、ProductType内部结构
$defs
"$defs": {
"marketplace_id": {
"default": "ATVPDKIKX0DER",
"editable": false,
"hidden": true,
"examples": [
"Amazon.com"
],
"type": "string",
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"enum": [
"ATVPDKIKX0DER"
],
"enumNames": [
"Amazon.com"
]
}
]
},
"language_tag": {
"default": "en_US",
"editable": false,
"hidden": true,
"examples": [
"English (United States)"
],
"type": "string",
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"enum": [
"ar_SA",
"ar_AE",
"zh_CN",
"zh_TW",
"en_US",
"fr_FR",
"de_DE",
"he_IL",
"ko_KR",
"pt_BR",
"es_ES",
"es_US"
],
"enumNames": [
"Arabic (Saudi Arabia)",
"Arabic (United Arab Emirates)",
"Chinese (China)",
"Chinese (Taiwan)",
"English (United States)",
"French (France)",
"German (Germany)",
"Hebrew (Israel)",
"Korean (South Korea)",
"Portuguese (Brazil)",
"Spanish (Spain)",
"Spanish (United States)"
]
}
]
}
}
required
"required": [
"brand",
"bullet_point",
"color",
"country_of_origin",
"item_name",
"item_type_keyword",
"product_description",
"supplier_declared_dg_hz_regulation"
]
properties
由于篇幅下面给出一部分列举
item_name
"item_name": {
"$comment": "This attribute is used to generate the title of the product which is displayed on the website",
"title": "Title",
"description": "Provide a title for the item that may be customer facing",
"examples": [
"Adidas Blue Sneakers"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id",
"language_tag"
],
"items": {
"type": "object",
"required": [
"language_tag",
"marketplace_id",
"value"
],
"properties": {
"value": {
"title": "Item Name",
"description": "Provide a title for the item that may be customer facing",
"editable": true,
"hidden": false,
"examples": [
"Adidas Blue Sneakers"
],
"type": "string",
"minLength": 0,
"maxLength": 66654
},
"language_tag": {
"$ref": "#/$defs/language_tag"
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
}
brand
"brand": {
"$comment": "This attribute provides the product's brand name",
"title": "Brand Name",
"description": "Provide the brand name of the product",
"examples": [
"Sony"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id",
"language_tag"
],
"items": {
"type": "object",
"required": [
"language_tag",
"marketplace_id",
"value"
],
"properties": {
"value": {
"title": "Brand Name",
"description": "Provide the brand name of the product",
"editable": false,
"hidden": false,
"examples": [
"Sony"
],
"type": "string",
"minLength": 1,
"maxLength": 100
},
"language_tag": {
"$ref": "#/$defs/language_tag"
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
},
"externally_assigned_product_identifier": {
"$comment": "This attribute indicates the type of external ID (barcode) and corresponding value that is being used to identify the product",
"title": "External Product ID",
"description": "Provide the external ID (barcode) type and corresponding value that is being used to identify the product",
"examples": [
"714532191586"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id",
"type"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"type",
"value"
],
"properties": {
"value": {
"title": "External Product ID",
"description": "Provide the corresponding external product id value based on the type that was selected",
"editable": false,
"hidden": false,
"examples": [
"714532191586"
],
"type": "string"
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
},
"type": {
"title": "External Product ID Type",
"description": "Select the type of external ID (barcode) that is being used to identify this product",
"editable": false,
"hidden": false,
"examples": [
"UPC"
],
"type": "string",
"enum": [
"ean",
"gtin",
"minsan_code",
"upc"
],
"enumNames": [
"EAN",
"GTIN",
"MINSAN",
"UPC"
]
}
},
"additionalProperties": false
}
}
merchant_suggested_asin
"merchant_suggested_asin": {
"$comment": "This attribute represents the merchants suggested ASIN",
"title": "Merchant Suggested Asin",
"description": "If you believe that an ASIN already exists for your product, then please provide it here. Otherwise leave blank and the system will look for a match based on the External Product ID that you provided",
"examples": [
"B007KQBXN0"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id",
"value"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"value"
],
"properties": {
"value": {
"title": "Merchant Suggested Asin",
"description": "If you believe that an ASIN already exists for your product, then please provide it here. Otherwise leave blank and the system will look for a match based on the External Product ID that you provided",
"editable": false,
"hidden": false,
"examples": [
"B007KQBXN0"
],
"type": "string",
"minLength": 10,
"maxLength": 10,
"maxUtf8ByteLength": 40
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
}
supplier_declared_has_product_identifier_exemption
"supplier_declared_has_product_identifier_exemption": {
"$comment": "This attribute specifies when a product is exempt from a supplier declared external product identifiers such as UPC, GTIN, ISBN, etc",
"title": "Is exempt from a supplier declared external identifier",
"description": "Please specify if the product is exempt from supplier declared external product identifiers.",
"examples": [
"Y, N"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"value"
],
"properties": {
"value": {
"title": "Is exempt from supplier declared external product identifier",
"description": "Please specify if the product is exempt from supplier declared external product identifiers.",
"editable": true,
"hidden": false,
"examples": [
"Yes, No"
],
"type": "boolean",
"enum": [
true,
false
],
"enumNames": [
"Yes",
"No"
]
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
}
item_type_keyword
"item_type_keyword": {
"$comment": "Enter the item that you are selling",
"title": "Item Type Keyword",
"description": "Use the provided system to determine the category which best describes your product. This information is used to determine where your product will be displayed. By selecting the most relevant term, you increase the chance that buyers will find this product.",
"examples": [
"Carry on luggage"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"value"
],
"properties": {
"value": {
"$comment": "Enter the item that you are selling",
"title": "Item Type Keyword",
"description": "Use the provided system to determine the category which best describes your product. This information is used to determine where your product will be displayed. By selecting the most relevant term, you increase the chance that buyers will find this product.",
"editable": false,
"hidden": false,
"examples": [
"Carry on luggage"
],
"type": "string",
"maxLength": 20090
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
}
skip_offer
"skip_offer": {
"$comment": "This attribute indicates whether or not a buyable offer should be created. This attribute will drive conditional logic for the set of offer attributes - if a value is not provided (i.e. absent) or if = false, then the offer attributes (fulfillment, condition etc., except price) will be required. If the value = true; offer attributes will be optional.",
"title": "Skip Offer",
"description": "Please indicate whether the offer should be skipped and a buyable offer should not be created. A value of \"true\", means no offer will be created.",
"examples": [
"True"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"value"
],
"properties": {
"value": {
"title": "Skip Offer",
"description": "Please indicate whether the offer should be skipped and a buyable offer should not be created. A value of \"true\", means no offer will be created.",
"editable": true,
"hidden": false,
"examples": [
"True"
],
"type": "boolean",
"enum": [
true,
false
],
"enumNames": [
"Yes",
"No"
]
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
}
},
"additionalProperties": false
}
}
other_offer_image_locator_1
"other_offer_image_locator_1": {
"$comment": "Offer-specific images enable buyers to inspect the physical condition of the item being sold, such as for used items. Other offer images are displayed in order after the main offer image. These images are unique to the SKU",
"title": "Other Offer Image Locator",
"description": "Provide the location of the image",
"examples": [
"Feed"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"marketplace_id"
],
"items": {
"type": "object",
"required": [
"marketplace_id",
"media_location"
],
"properties": {
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
},
"media_location": {
"$comment": "The URL for additional images of your product. These images will be shown on the detail page when the customer clicks through to see other views associated with the product.",
"title": "Other Image Location",
"description": "The URL for additional images of your product. These images will be shown on the detail page when the customer clicks through to see other views associated with the product.",
"editable": true,
"hidden": false,
"examples": [
"http://www.companyname.com/images/1250.other1.jpg"
],
"type": "string"
}
},
"additionalProperties": false
}
}
allOf
由于篇幅下面给出一部分列举
1 merchant_suggested_asin
{
"if": {
"allOf": [
{
"allOf": [
{
"required": [
"merchant_suggested_asin"
],
"properties": {
"merchant_suggested_asin": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
},
{
"required": [
"supplier_declared_has_product_identifier_exemption"
],
"properties": {
"supplier_declared_has_product_identifier_exemption": {
"contains": {
"required": [
"value"
],
"properties": {
"value": {
"enum": [
false
],
"enumNames": [
"eq::false"
]
}
}
}
}
}
}
]
},
{
"allOf": [
{
"properties": {
"merchant_suggested_asin": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
},
{
"properties": {
"supplier_declared_has_product_identifier_exemption": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
}
]
}
]
},
"then": {
"required": [
"externally_assigned_product_identifier"
]
}
},
2 externally_assigned_product_identifier
{
"if": {
"allOf": [
{
"allOf": [
{
"required": [
"externally_assigned_product_identifier"
],
"properties": {
"externally_assigned_product_identifier": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
},
{
"required": [
"supplier_declared_has_product_identifier_exemption"
],
"properties": {
"supplier_declared_has_product_identifier_exemption": {
"contains": {
"required": [
"value"
],
"properties": {
"value": {
"enum": [
false
],
"enumNames": [
"eq::false"
]
}
}
}
}
}
}
]
},
{
"allOf": [
{
"properties": {
"externally_assigned_product_identifier": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
},
{
"properties": {
"supplier_declared_has_product_identifier_exemption": {
"items": {
"not": {
"required": [
"value"
]
}
}
}
}
}
]
}
]
},
"then": {
"required": [
"merchant_suggested_asin"
]
}
},
3 quantity
{
"properties": {
"fulfillment_availability": {
"items": {
"if": {
"allOf": [
{
"not": {
"required": [
"quantity"
]
}
},
{
"properties": {
"fulfillment_channel_code": {
"enum": [
"{external_context:fulfillment_channel.values[ruleset=mfn].value}"
],
"enumNames": [
"{external_context:fulfillment_channel.values[ruleset=mfn].value}"
]
}
}
}
]
},
"then": {
"required": [
"is_inventory_available"
]
}
}
}
}
},
10 cell_composition
{
"if": {
"required": [
"battery"
],
"properties": {
"battery": {
"contains": {
"required": [
"cell_composition"
],
"properties": {
"cell_composition": {
"contains": {
"required": [
"value"
],
"properties": {
"value": {
"enum": [
"lithium",
"lithium_metal",
"lithium_manganese_dioxide",
"lithium_thionyl_chloride"
],
"enumNames": [
"lithium",
"lithium_metal",
"lithium_manganese_dioxide",
"lithium_thionyl_chloride"
]
}
}
}
}
}
}
}
}
},
"then": {
"required": [
"lithium_battery"
],
"properties": {
"lithium_battery": {
"items": {
"required": [
"weight"
]
}
}
}
}
},