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

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/<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: 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](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> — 对于项目符号列表。 <李> — 创建列表项（必须在<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

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

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

这篇文章是否有用？

推荐卡片

价格表