查看市场上与您的产品相匹配的卡片
方法适用于所有模式.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
返回市场上与具有指定参数的产品相对应的卡的Id。
您不需要使用此查询：它只是有助于提前确保市场根据您提供的数据正确识别卡片。
如何使用请求
- 将需要检查的产品列表发送到Yandex。市场。
- 作为回应，您将收到一份清单 SKU 在市场上有一个描述：名称，型号ID，类别。
- 如果没有足够的解密，您可以打开卡。 要做到这一点，请按照表单中的链接
：没有-翻译[https://market.yandex.ru/product/<marketModelId>?sku=<marketSku>]. - 如果卡与产品匹配，则可以将其添加到目录中，并使用您指定的数据。 如果卡识别错误 — 检查产品信息。 它们可能需要澄清或补充。 此外，在添加产品的阶段，您可以指定
marketSKU你认为哪一个适合他。
如何确定 marketSku 市场上发现的产品？
它位于产品页面的地址中。 — 位于后 sku=.
例如, ：没有-翻译[https://market.yandex.ru/product--yandex-kniga/484830016?sku=484830016]
| ⚙️ 限制: 每小时100,000种产品 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings/suggestions
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> 内阁ID。 要找到答案，请使用请求 GET v2/campaigns. Min value: |
Body
application/json
{
"offers": [
{
"offerId": "string",
"name": "Ударная дрель Makita HP1630, 710 Вт",
"category": "string",
"vendor": "LEVENHUK",
"barcodes": [
"46012300000000"
],
"description": "string",
"vendorCode": "VNDR-0005A",
"basicPrice": {
"value": 0,
"currencyId": "RUR"
}
}
]
}
|
Name |
Description |
|
offers |
Type: object[] 的产品清单。 Min items: Max items: |
Responses
200 OK
市场上精选的卡片。
根据产品验证的结果，通过此请求接收的卡可以用另一个替换。
Body
application/json
{
"status": "OK",
"result": {
"offers": [
{
"offer": {
"offerId": "string",
"name": "Ударная дрель Makita HP1630, 710 Вт",
"category": "string",
"vendor": "LEVENHUK",
"barcodes": [
"46012300000000"
],
"description": "string",
"vendorCode": "VNDR-0005A",
"basicPrice": {
"value": 0,
"currencyId": "RUR"
}
},
"mapping": {
"marketSku": 0,
"marketSkuName": "string",
"marketModelId": 0,
"marketModelName": "string",
"marketCategoryId": 0,
"marketCategoryName": "string"
}
}
]
}
}
|
Name |
Description |
||
|
status* |
Type: string 响应的类型。 可能的值:
Enum: |
||
|
result |
Type: object
市场上精选的卡片。 |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
什么是GTIN？
[医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 GS1. 此编号生成EAN、UPC或ISBN条形码。
如何确保产品在数据库中
你可以在 验证页面 在GS1协会的网站上。 如果未找到产品，请向供应商索取GTIN代码。
如何为您的产品获取GTIN
要接收GTIN代码，制造商需要加入GS1协会并注册产品。