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

返回与请求体中定义的最多40个请求的批处理列表对应的响应集。每个成功（HTTP状态码200）请求的响应包括计算出的上市价格，在此价格或更低的情况下，卖家可以期望成为特色报价（在适用促销之前）。这被称为特色报价预期价格（FOEP）。特色报价并不保证，因为竞争报价可能会变化，并且根据其他因素（包括对特定客户的履行能力）可能会突出显示不同的报价。对不成功请求的响应包括可用的错误文本。

使用计划：

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

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

请求参数

Body 参数application/json

`getFeaturedOfferExpectedPriceBatch` 操作的请求主体。

requests

array[object (FeaturedOfferExpectedPriceRequest) {6}]

可选

一批精选优惠预期价格请求的列表。

>= 1 items

uri

string

必需

与批处理中单个请求相关联的 URI。对于 FeaturedOfferExpectedPrice，应为 /products/pricing/2022-05-01/offer/featuredOfferExpectedPrice。

method

enum<string>

HttpMethod

必需

与批处理中的单个请求相关联的HTTP方法。

枚举值:

GETPUTPATCHDELETEPOST

body

HttpBody

可选

与批处理中的单个请求相关联的附加 HTTP 请求体信息。

headers

object

HttpHeaders

可选

针对批量中单个请求发送/接收的额外HTTP头的映射。

marketplaceId

string

MarketplaceId

必需

市场标识符。指定返回数据的市场。

sku

string

Sku

必需

该商品的卖家SKU。

示例

示例代码

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

可选

唯一请求参考标识符。

Body

`getFeaturedOfferExpectedPriceBatch` 操作的响应模式。

responses

array[object (FeaturedOfferExpectedPriceResponse) {4}]

可选

一批精选优惠预计价格响应的列表。

>= 1 items

headers

object

HttpHeaders

必需

针对批量中单个请求发送/接收的额外HTTP头的映射。

status

object

HttpStatusLine

必需

与批量中单个请求的响应相关联的HTTP状态行。有关更多信息，请参见RFC 2616。

request

object

FeaturedOfferExpectedPriceRequestParams

必需

单个请求的参数。

body

object

FeaturedOfferExpectedPriceResponseBody

可选

所请求SKU的预期价格响应数据的特色优惠。

示例

{
  "responses": [
    {
      "request": {
        "marketplaceId": "MARKETPLACE_ID",
        "sku": "MY_SKU"
      },
      "status": {
        "statusCode": 200,
        "reasonPhrase": "Success"
      },
      "headers": [],
      "body": {
        "offerIdentifier": {
          "asin": "ASIN",
          "sku": "MY_SKU",
          "marketplaceId": "MARKETPLACE_ID",
          "fulfillmentType": "AFN",
          "sellerId": "MY_SELLER_ID"
        },
        "featuredOfferExpectedPriceResults": [
          {
            "featuredOfferExpectedPrice": {
              "listingPrice": {
                "amount": 10,
                "currencyCode": "USD"
              },
              "points": {
                "pointsNumber": 3,
                "pointsMonetaryValue": {
                  "amount": 0.03,
                  "currencyCode": "USD"
                }
              }
            },
            "resultStatus": "VALID_FOEP",
            "competingFeaturedOffer": {
              "offerIdentifier": {
                "asin": "ASIN",
                "marketplaceId": "MARKETPLACE_ID",
                "fulfillmentType": "AFN",
                "sellerId": "OTHER_SELLER_ID"
              },
              "condition": "New",
              "price": {
                "listingPrice": {
                  "amount": 12,
                  "currencyCode": "USD"
                },
                "shippingPrice": {
                  "amount": 0,
                  "currencyCode": "USD"
                },
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                }
              }
            },
            "currentFeaturedOffer": {
              "offerIdentifier": {
                "asin": "ASIN",
                "marketplaceId": "MARKETPLACE_ID",
                "fulfillmentType": "AFN",
                "sellerId": "OTHER_SELLER_ID"
              },
              "condition": "New",
              "price": {
                "listingPrice": {
                  "amount": 12,
                  "currencyCode": "USD"
                },
                "shippingPrice": {
                  "amount": 0,
                  "currencyCode": "USD"
                },
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                }
              }
            }
          }
        ]
      }
    },
    {
      "request": {
        "marketplaceId": "MARKETPLACE_ID",
        "sku": "MY_UNIQUE_SKU"
      },
      "status": {
        "statusCode": 200,
        "reasonPhrase": "Success"
      },
      "headers": [],
      "body": {
        "offerIdentifier": {
          "asin": "ASIN",
          "sku": "MY_UNIQUE_SKU",
          "marketplaceId": "MARKETPLACE_ID",
          "fulfillmentType": "AFN",
          "sellerId": "MY_SELLER_ID"
        },
        "featuredOfferExpectedPriceResults": [
          {
            "resultStatus": "NO_COMPETING_OFFERS",
            "currentFeaturedOffer": {
              "offerIdentifier": {
                "asin": "ASIN",
                "marketplaceId": "MARKETPLACE_ID",
                "fulfillmentType": "AFN",
                "sellerId": "MY_SELLER_ID"
              },
              "condition": "New",
              "price": {
                "listingPrice": {
                  "amount": 12,
                  "currencyCode": "USD"
                },
                "shippingPrice": {
                  "amount": 0,
                  "currencyCode": "USD"
                },
                "points": {
                  "pointsNumber": 3,
                  "pointsMonetaryValue": {
                    "amount": 0.03,
                    "currencyCode": "USD"
                  }
                }
              }
            }
          }
        ]
      }
    },
    {
      "request": {
        "marketplaceId": "MARKETPLACE_ID",
        "sku": "MY_NONEXISTENT_SKU"
      },
      "status": {
        "statusCode": 400,
        "reasonPhrase": "Client Error"
      },
      "headers": [],
      "body": {
        "errors": [
          {
            "code": "INVALID_SKU",
            "message": "The requested SKU does not exist for the seller in the requested marketplace."
          }
        ]
      }
    }
  ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障