燕基科斯.市场对价格的建议

方法适用于所有模式.

目前不适用于卖家Market Yandex Go.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
  • pricing — 价格管理
  • pricing:read-only — 查看价格
  • all-methods — 全面管理账户
  • all-methods:read-only — 查看所有数据

该方法返回几种类型的建议。

  1. 有吸引力的价格的门槛。
  2. 展柜中价格吸引力的评价。

这些建议告诉你为了吸引买家，你需要设定什么价格。

过滤器可以在请求中使用。 结果逐页返回。

⚙️ 限制: 每分钟100个请求

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offers/recommendations

Path parameters

Name

Description

businessId

Type: integer

内阁ID。 要找到答案，请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Query parameters

Name

Description

limit

Type: integer

每页的值数。

Min value: 1

page_token

Type: string

结果页面的ID。

如果省略该参数，则返回第一页。

我们建议传输输出参数的值 nextPageToken，在最后一次请求期间接收。

如果设置 page_token 并且请求有参数 page 和 pageSize 它们被忽略了。

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Body

application/json
{
  "offerIds": [
    "example"
  ],
  "competitivenessFilter": "OPTIMAL"
}

Name

Description

competitivenessFilter

Type: string

价格的吸引力:

  • OPTIMAL — 有吸引力。
  • AVERAGE — 适度。
  • LOW — 没有吸引力。

Enum: OPTIMAL, AVERAGE, LOW

offerIds

Type: string[] | null

需要信息的产品的Id。 ⚠️ 不要与其他过滤器在同一时间使用此字段。 如果要使用过滤器，请将字段留空。

Min items: 1

Unique items: true

Example
[
  "example"
]

Responses

200 OK

有推荐的产品列表。

Body

application/json
{
  "status": "OK",
  "result": {
    "paging": {
      "nextPageToken": "example",
      "prevPageToken": "example"
    },
    "offerRecommendations": [
      {
        "offer": {},
        "recommendation": {}
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

    • OK — 没有错误。
    • ERROR — 处理请求时出错。

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
  "status": "OK"
}
  • Type: object

    result
    Type: object

    offerRecommendations
    Type: object[]

    offer
    Type: object

    competitiveness

    Type: string

    价格的吸引力:

    • OPTIMAL — 有吸引力。
    • AVERAGE — 适度。
    • LOW — 没有吸引力。

    Enum: OPTIMAL, AVERAGE, LOW

    offerId

    Type: string

    你的 SKU — 系统中的产品ID。

    使用规则 SKU:

    • 对于每个产品 SKU 一定有一个。

    • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

    SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    price
    Type: object

    currencyId

    Type: string

    货币代码:

    • RUR — 俄罗斯卢布。
    • UAH — 乌克兰格里夫纳。
    • BYR — 白俄罗斯卢布。
    • KZT — 哈萨克斯坦坚戈。
    • UZS — 乌兹别克总和。

    Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

    value

    Type: number

    品的价格。

    Min value: 0

    Exclusive min: true

    品的价格。

    Example
    {
  "value": 0,
  "currencyId": "RUR"
}

    shows

    Type: integer

    最近7天的产品卡展示次数。

    品的价格状态的信息。

    Example
    {
  "offerId": "example",
  "price": {
    "value": 0,
    "currencyId": "RUR"
  },
  "competitiveness": "OPTIMAL",
  "shows": 0
}

    recommendation
    Type: object

    competitivenessThresholds
    Type: object

    averagePrice
    Type: object

    currencyId

    Type: string

    货币代码:

    • RUR — 俄罗斯卢布。
    • UAH — 乌克兰格里夫纳。
    • BYR — 白俄罗斯卢布。
    • KZT — 哈萨克斯坦坚戈。
    • UZS — 乌兹别克总和。

    Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

    value

    Type: number

    品的价格。

    Min value: 0

    Exclusive min: true

    品的价格。

    Example
    {
  "value": 0,
  "currencyId": "RUR"
}

    optimalPrice
    Type: object

    currencyId

    Type: string

    货币代码:

    • RUR — 俄罗斯卢布。
    • UAH — 乌克兰格里夫纳。
    • BYR — 白俄罗斯卢布。
    • KZT — 哈萨克斯坦坚戈。
    • UZS — 乌兹别克总和。

    Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

    value

    Type: number

    品的价格。

    Min value: 0

    Exclusive min: true

    品的价格。

    Example
    {
  "value": 0,
  "currencyId": "RUR"
}

    它具有吸引力或适中的最高价格值。

    Example
    {
  "optimalPrice": {
    "value": 0,
    "currencyId": "RUR"
  },
  "averagePrice": {
    "value": 0,
    "currencyId": "RUR"
  }
}

    offerId

    Type: string

    你的 SKU — 系统中的产品ID。

    使用规则 SKU:

    • 对于每个产品 SKU 一定有一个。

    • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

    SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 " 和 "SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    关于产品价格的建议。

    Example
    {
  "offerId": "example",
  "competitivenessThresholds": {
    "optimalPrice": {
      "value": 0,
      "currencyId": "RUR"
    },
    "averagePrice": {
      "value": 0,
      "currencyId": "RUR"
    }
  }
}

    产品列表页。

    Example
    [
  {
    "offer": {
      "offerId": "example",
      "price": {
        "value": 0,
        "currencyId": "RUR"
      },
      "competitiveness": "OPTIMAL",
      "shows": 0
    },
    "recommendation": {
      "offerId": "example",
      "competitivenessThresholds": {
        "optimalPrice": {
          "value": 0,
          "currencyId": "RUR"
        },
        "averagePrice": {
          "value": 0,
          "currencyId": "RUR"
        }
      }
    }
  }
]

    paging

    Type: object

    All of 2 types

    • Type: object

      nextPageToken

      Type: string

      下一个结果页面的ID。

      Example: example

      下一页的ID。

      Example
      {
  "nextPageToken": "example"
}

    • Type: object

      prevPageToken

      Type: string

      上一个结果页面的ID。

      Example: example
      Example
      {
  "prevPageToken": "example"
}

    有关结果页的信息。

    Example
    {
  "nextPageToken": "example",
  "prevPageToken": "example"
}

    有推荐的产品列表。

    Example
    {
  "paging": {
    "nextPageToken": "example",
    "prevPageToken": "example"
  },
  "offerRecommendations": [
    {
      "offer": {
        "offerId": "example",
        "price": {
          "value": 0,
          "currencyId": "RUR"
        },
        "competitiveness": "OPTIMAL",
        "shows": 0
      },
      "recommendation": {
        "offerId": "example",
        "competitivenessThresholds": {
          "optimalPrice": {},
          "averagePrice": {}
        }
      }
    }
  ]
}
    Example
    {
  "result": {
    "paging": {
      "nextPageToken": "example",
      "prevPageToken": "example"
    },
    "offerRecommendations": [
      {
        "offer": {
          "offerId": "example",
          "price": {},
          "competitiveness": "OPTIMAL",
          "shows": 0
        },
        "recommendation": {
          "offerId": "example",
          "competitivenessThresholds": {}
        }
      }
    ]
  }
}

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

Yandex中的内部错误。 市场。 有关错误的更多信息

Body

application/json
{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

  • Type: object

    All of 2 types

    • Type: object

      status

      Type: string

      响应的类型。 可能的值:

      • OK — 没有错误。
      • ERROR — 处理请求时出错。

      Enum: OK, ERROR

      服务器响应的标准包装器。

      Example
      {
  "status": "OK"
}

    • Type: object

      errors
      Type: object[]

      code

      Type: string

      的错误代码。

      Example: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
  {
    "code": "example",
    "message": "example"
  }
]
      Example
      {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

    服务器错误的标准包装器。

    Example
    {
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

No longer supported, please use an alternative and newer version.

如果你有这样的价格设置或更低，它被认为是有吸引力的。

上一篇
在商店里
下一篇
以柜内价格查看检疫