查看市场上与您的产品相匹配的卡片

Deprecated

Info

Console

方法适用于所有模式.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

offers-and-cards-management — 商品和卡片管理
offers-and-cards-management:read-only — 查看商品和卡片
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

返回市场上与具有指定参数的产品相对应的卡的Id。

您不需要使用此查询：它只是有助于提前确保市场根据您提供的数据正确识别卡片。

如何使用请求

将需要检查的产品列表发送到Yandex。市场。
作为回应，您将收到一份清单 SKU 在市场上有一个描述：名称，型号ID，类别。
如果没有足够的解密，您可以打开卡。要做到这一点，请按照表单中的链接 ：没有-翻译[https://market.yandex.ru/product/<市场模型>?sku=<市场模型>].
如果卡与产品匹配，则可以将其添加到包含您指定的数据的目录中。如果卡识别错误，请检查产品信息。它们可能需要澄清或补充。此外，在添加产品的阶段，您可以指定 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。要找到答案，请使用请求 :no-translate[GET v2/campaigns].

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

Min value: 1

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: SuggestedOfferDTO[]

的产品清单。
产品信息。

Min items: 1

Max items: 500

SuggestedOfferDTO

产品信息。

Name	Description
barcodes	Type: string[] 条形码。将其指定为数字序列。密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN. 对于产品某些类别和品牌条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN. 什么是 GTIN Example: `46012300000000` Min items: `1` Unique items
basicPrice	Type: BasePriceDTO 品的价格。
category ⦸	Type: string 相反，使用 `marketCategoryId`. 您商店中的产品类别。
description	Type: string 详细的产品说明：例如，它的优点和特点。说明中不提供安装和装配说明。不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。不要提供任何联系信息或链接。您可以使用HTML标记来格式化文本: <h>、<h1>、<h2>等-用于标题; <br>和<p>-用于换行符。 <ol>-用于编号列表。 <ul>-用于项目符号列表。 <li>-创建列表项（必须在<ol>或<ul>内）; <div>—支持，但不影响文本显示。最佳长度为400-600个字符。建议和规则 Max length: `6000`
name	Type: string 根据方案组成名称：类型+品牌或制造商+型号+功能，如果有的话（例如，颜色，尺寸或重量）和数量在包装中。不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词，除了品牌和型号的既定名称。最佳长度为50-60个字符。建议和规则 Example: `Ударная дрель Makita HP1630, 710 Вт` Max length: `256`
offerId	Type: string 你的 SKU -系统中的产品ID。使用规则 SKU: 对于每个产品 SKU 一定有一个。已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。阅读如何做到这一点。在市场对卖家的帮助. 什么是 SKU 以及如何分配它 Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
vendor	Type: string 品牌或制造商的名称。它应该按照品牌本身的方式来写。 Example: `LEVENHUK`
vendorCode	Type: string 从制造商的产品的文章。 Example: `VNDR-0005A`

BasePriceDTO

品的价格。

Name

Description

currencyId*

Type: CurrencyType

Валюта.

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 (exclusive): 0

CurrencyType

货币代码:

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

Type

Description

CurrencyType

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: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

result

市场上精选的卡片。

ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

GetSuggestedOfferMappingsResultDTO

市场上精选的卡片。

Name

Description

offers*

Type: SuggestedOfferMappingDTO[]

的产品清单。
有相应卡的产品上市。

SuggestedOfferMappingDTO

有相应卡的产品上市。

Name

Description

mapping

Type: GetMappingDTO

Информация о карточке на Маркете.
Идентификатор карточки на Маркете. Показывает текущую привязку товара к карточке.

Может отсутствовать в ответе, если товар еще не привязан к карточке. Проверьте статус карточки или исправьте ошибки.

offer

Type: SuggestedOfferDTO

产品信息。

GetMappingDTO

目录中有关产品的信息。

Name

Description

marketCategoryId

Type: integer<int64>

品所属的市场上的类别的ID。

如果市场尚未确定产品类别，则可能会在响应中遗漏。

marketCategoryName

Type: string

卡在市场上的类别的名称。

如果市场尚未确定产品类别，则可能会在响应中遗漏。

marketModelId

⦸

Type: integer<int64>

市场上模型的ID。

如果产品尚未链接到卡，则可能不会包含在响应中。

marketModelName

⦸

Type: string

市场上型号的名称。

如果产品尚未链接到卡，则可能不会包含在响应中。

marketSku

Type: integer<int64>

Идентификатор карточки на Маркете.

Min value: 1

marketSkuName

Type: string

产品卡的名称。

如果产品尚未链接到卡，则可能不会包含在响应中。

400 Bad Request

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

403 Forbidden

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

404 Not Found

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

420 Method Failure

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

500 Internal Server Error

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

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

这篇文章是否有用？

推荐卡片

价格表