getItemOffersBatch - Amazon Selling Partner API (SP-API)-中文

根据 ASIN 返回一批商品的最低价格优惠。

使用计划：

速率（每秒请求次数）	突发
0.1	1

响应头 x-amzn-RateLimit-Limit 返回所请求操作适用的使用计划速率限制（如有）。上表指示了此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到高于此处显示的速率和突发值。如需更多信息，请参见 Selling Partner API 中的使用计划和速率限制。

请求参数

Body 参数application/json

与 `getItemOffersBatch` API 调用相关的请求。

requests

array[object (ItemOffersRequest) {6}]

可选

要运行的 getListingOffers 批量请求的列表。

>= 1 items<= 20 items

uri

string

必需

您在批量调用的操作的资源路径，不带任何查询参数。

如果您调用的是 getItemOffersBatch，请提供 getItemOffers 的路径。

示例： /products/pricing/v0/items/B000P6Q7MY/offers

如果您调用的是 getListingOffersBatch，请提供 getListingOffers 的路径。

示例： /products/pricing/v0/listings/B000P6Q7MY/offers

method

enum<string>

HttpMethod

必需

与批量请求中被调用的各个API相关联的HTTP方法。

枚举值:

GETPUTPATCHDELETEPOST

headers

object

HttpRequestHeaders

可选

一个用于发送/接收单个批处理请求的额外HTTP头部的映射。

MarketplaceId

string

MarketplaceId

必需

市场标识符。指定返回价格的市场。

ItemCondition

enum<string>

ItemCondition

必需

根据物品状况筛选可考虑的优惠列表。可能的值：全新、二手、收藏品、翻新、俱乐部。

枚举值:

NewUsedCollectibleRefurbishedClub

CustomerType

enum<string>

CustomerType

可选

指示是否请求消费者或商业优惠。默认是消费者。

枚举值:

ConsumerBusiness

示例

{
    "requests": [
        {
            "uri": "string",
            "method": "GET",
            "headers": {
                "property1": "string",
                "property2": "string"
            },
            "MarketplaceId": "string",
            "ItemCondition": "New",
            "CustomerType": "Consumer"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

表示请求是以批处理方式运行的。检查批处理响应状态行以获取有关批处理请求是否成功的信息。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

唯一请求参考ID。

可选

Body

与`getItemOffersBatch` API调用相关的响应。

responses

array[object (ItemOffersResponse) {4}]

可选

getItemOffers 批量响应的列表。

>= 1 items<= 20 items

headers

object

HttpResponseHeaders

可选

一个用于发送/接收单个批处理请求的额外HTTP头部的映射。

status

object

GetOffersHttpStatusLine

可选

与响应相关的HTTP状态行。有关更多信息，请查阅RFC 2616。

body

object

GetOffersResponse

必需

getListingOffers 和 getItemOffers 操作的响应模式。

request

object

ItemOffersRequestParams

必需

示例

{
    "responses": [
        {
            "headers": {
                "Date": "string",
                "x-amzn-RequestId": "string",
                "property1": "string",
                "property2": "string"
            },
            "status": {
                "statusCode": 100,
                "reasonPhrase": "string"
            },
            "body": {
                "payload": {
                    "MarketplaceID": "string",
                    "ASIN": "string",
                    "SKU": "string",
                    "ItemCondition": "New",
                    "status": "string",
                    "Identifier": {
                        "MarketplaceId": "string",
                        "ASIN": "string",
                        "SellerSKU": "string",
                        "ItemCondition": "New"
                    },
                    "Summary": {
                        "TotalOfferCount": 0,
                        "NumberOfOffers": [
                            {
                                "condition": "string",
                                "fulfillmentChannel": "Amazon",
                                "OfferCount": 0
                            }
                        ],
                        "LowestPrices": [
                            {
                                "condition": "string",
                                "fulfillmentChannel": "string",
                                "offerType": "B2C",
                                "quantityTier": 0,
                                "quantityDiscountType": "QUANTITY_DISCOUNT",
                                "LandedPrice": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "ListingPrice": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "Shipping": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "Points": {
                                    "PointsNumber": 0,
                                    "PointsMonetaryValue": {
                                        "CurrencyCode": "string",
                                        "Amount": 0
                                    }
                                }
                            }
                        ],
                        "BuyBoxPrices": [
                            {
                                "condition": "string",
                                "offerType": "B2C",
                                "quantityTier": 0,
                                "quantityDiscountType": "QUANTITY_DISCOUNT",
                                "LandedPrice": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "ListingPrice": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "Shipping": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "Points": {
                                    "PointsNumber": 0,
                                    "PointsMonetaryValue": {
                                        "CurrencyCode": "string",
                                        "Amount": 0
                                    }
                                },
                                "sellerId": "string"
                            }
                        ],
                        "ListPrice": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "CompetitivePriceThreshold": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "SuggestedLowerPricePlusShipping": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "SalesRankings": [
                            {
                                "ProductCategoryId": "string",
                                "Rank": 0
                            }
                        ],
                        "BuyBoxEligibleOffers": [
                            {
                                "condition": "string",
                                "fulfillmentChannel": "Amazon",
                                "OfferCount": 0
                            }
                        ],
                        "OffersAvailableTime": "2019-08-24T14:15:22Z"
                    },
                    "Offers": [
                        {
                            "MyOffer": true,
                            "offerType": "B2C",
                            "SubCondition": "string",
                            "SellerId": "string",
                            "ConditionNotes": "string",
                            "SellerFeedbackRating": {
                                "SellerPositiveFeedbackRating": 0,
                                "FeedbackCount": 0
                            },
                            "ShippingTime": {
                                "minimumHours": 0,
                                "maximumHours": 0,
                                "availableDate": "string",
                                "availabilityType": "NOW"
                            },
                            "ListingPrice": {
                                "CurrencyCode": "string",
                                "Amount": 0
                            },
                            "quantityDiscountPrices": [
                                {
                                    "quantityTier": 0,
                                    "quantityDiscountType": "QUANTITY_DISCOUNT",
                                    "listingPrice": {
                                        "CurrencyCode": "string",
                                        "Amount": 0
                                    }
                                }
                            ],
                            "Points": {
                                "PointsNumber": 0,
                                "PointsMonetaryValue": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                }
                            },
                            "Shipping": {
                                "CurrencyCode": "string",
                                "Amount": 0
                            },
                            "ShipsFrom": {
                                "State": "string",
                                "Country": "string"
                            },
                            "IsFulfilledByAmazon": true,
                            "PrimeInformation": {
                                "IsPrime": true,
                                "IsNationalPrime": true
                            },
                            "IsBuyBoxWinner": true,
                            "IsFeaturedMerchant": true
                        }
                    ]
                },
                "errors": [
                    {
                        "code": "string",
                        "message": "string",
                        "details": "string"
                    }
                ]
            },
            "request": {
                "MarketplaceId": "string",
                "ItemCondition": "New",
                "CustomerType": "Consumer",
                "Asin": "string"
            }
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障