Update Catalog Items API v2022

This commit is contained in:
lisa-delaney 2024-05-22 10:49:37 -07:00
parent 368f916efe
commit f15a5da356
1 changed files with 141 additions and 3 deletions

View File

@ -29,7 +29,7 @@
"tags": [
"catalog"
],
"description": "Search for and return a list of Amazon catalog items and associated information either by identifier or by keywords.\n\n**Usage Plans:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may observe higher rate and burst values than those shown here. For more information, refer to the [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description": "Search for and return a list of Amazon catalog items and associated information either by identifier or by keywords.\n\n**Usage Plans:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may observe higher rate and burst values than those shown here. For more information, refer to the [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "searchCatalogItems",
"consumes": [
"application/json"
@ -125,6 +125,7 @@
"items": {
"enum": [
"attributes",
"classifications",
"dimensions",
"identifiers",
"images",
@ -140,6 +141,10 @@
"value": "attributes",
"description": "A JSON object containing structured item attribute data keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions available in the Selling Partner API for Product Type Definitions."
},
{
"value": "classifications",
"description": "Classifications (browse nodes) for an item in the Amazon catalog."
},
{
"value": "dimensions",
"description": "Dimensions for an item in the Amazon catalog."
@ -797,6 +802,29 @@
}
]
},
"classifications": [
{
"marketplaceId": "ATVPDKIKX0DER",
"classifications": [
{
"displayName": "QLED TVs",
"classificationId": "21489946011",
"parent": {
"displayName": "Televisions",
"classificationId": "172659",
"parent": {
"displayName": "Television & Video",
"classificationId": "1266092011",
"parent": {
"displayName": "Electronics",
"classificationId": "172282"
}
}
}
}
]
}
],
"dimensions": [
{
"marketplaceId": "ATVPDKIKX0DER",
@ -1140,6 +1168,7 @@
},
"includedData": {
"value": [
"classifications",
"dimensions",
"identifiers",
"images",
@ -1176,6 +1205,29 @@
"items": [
{
"asin": "B07N4M94X4",
"classifications": [
{
"marketplaceId": "ATVPDKIKX0DER",
"classifications": [
{
"displayName": "QLED TVs",
"classificationId": "21489946011",
"parent": {
"displayName": "Televisions",
"classificationId": "172659",
"parent": {
"displayName": "Television & Video",
"classificationId": "1266092011",
"parent": {
"displayName": "Electronics",
"classificationId": "172282"
}
}
}
}
]
}
],
"dimensions": [
{
"marketplaceId": "ATVPDKIKX0DER",
@ -1616,7 +1668,7 @@
"tags": [
"catalog"
],
"description": "Retrieves details for an item in the Amazon catalog.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may observe higher rate and burst values than those shown here. For more information, refer to the [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description": "Retrieves details for an item in the Amazon catalog.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may observe higher rate and burst values than those shown here. For more information, refer to the [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getCatalogItem",
"consumes": [
"application/json"
@ -1653,6 +1705,7 @@
"items": {
"enum": [
"attributes",
"classifications",
"dimensions",
"identifiers",
"images",
@ -1668,6 +1721,10 @@
"value": "attributes",
"description": "A JSON object containing structured item attribute data keyed by attribute name. Catalog item attributes conform to the related Amazon product type definitions available in the Selling Partner API for Product Type Definitions."
},
{
"value": "classifications",
"description": "Classifications (browse nodes) for an item in the Amazon catalog."
},
{
"value": "dimensions",
"description": "Dimensions for an item in the Amazon catalog."
@ -2233,6 +2290,29 @@
}
]
},
"classifications": [
{
"marketplaceId": "ATVPDKIKX0DER",
"classifications": [
{
"displayName": "QLED TVs",
"classificationId": "21489946011",
"parent": {
"displayName": "Televisions",
"classificationId": "172659",
"parent": {
"displayName": "Television & Video",
"classificationId": "1266092011",
"parent": {
"displayName": "Electronics",
"classificationId": "172282"
}
}
}
}
]
}
],
"dimensions": [
{
"marketplaceId": "ATVPDKIKX0DER",
@ -2571,6 +2651,7 @@
},
"includedData": {
"value": [
"classifications",
"dimensions",
"identifiers",
"images",
@ -2585,6 +2666,29 @@
},
"response": {
"asin": "B07N4M94X4",
"classifications": [
{
"marketplaceId": "ATVPDKIKX0DER",
"classifications": [
{
"displayName": "QLED TVs",
"classificationId": "21489946011",
"parent": {
"displayName": "Televisions",
"classificationId": "172659",
"parent": {
"displayName": "Television & Video",
"classificationId": "1266092011",
"parent": {
"displayName": "Electronics",
"classificationId": "172282"
}
}
}
}
]
}
],
"dimensions": [
{
"marketplaceId": "ATVPDKIKX0DER",
@ -3066,6 +3170,9 @@
"attributes": {
"$ref": "#/definitions/ItemAttributes"
},
"classifications": {
"$ref": "#/definitions/ItemBrowseClassifications"
},
"dimensions": {
"$ref": "#/definitions/ItemDimensions"
},
@ -3109,12 +3216,16 @@
"description": "Classification (browse node) associated with an Amazon catalog item.",
"properties": {
"displayName": {
"description": "Display name for the classification.",
"description": "Display name for the classification (browse node).",
"type": "string"
},
"classificationId": {
"description": "Identifier of the classification (browse node identifier).",
"type": "string"
},
"parent": {
"description": "Parent classification (browse node) of the current classification.",
"$ref": "#/definitions/ItemBrowseClassification"
}
},
"required": [
@ -3157,6 +3268,33 @@
],
"type": "object"
},
"ItemBrowseClassifications": {
"description": "Array of classifications (browse nodes) associated with the item in the Amazon catalog by Amazon marketplace.",
"items": {
"$ref": "#/definitions/ItemBrowseClassificationsByMarketplace"
},
"type": "array"
},
"ItemBrowseClassificationsByMarketplace": {
"description": "Classifications (browse nodes) associated with the item in the Amazon catalog for the indicated Amazon marketplace.",
"properties": {
"marketplaceId": {
"description": "Amazon marketplace identifier.",
"type": "string"
},
"classifications": {
"description": "Classifications (browse nodes) associated with the item in the Amazon catalog for the indicated Amazon marketplace.",
"items": {
"$ref": "#/definitions/ItemBrowseClassification"
},
"type": "array"
}
},
"required": [
"marketplaceId"
],
"type": "object"
},
"Dimension": {
"description": "Individual dimension value of an Amazon catalog item or item package.",
"properties": {