目录中的产品列表

Deprecated

Info

Console

方法适用于所有模式.

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

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

我应该使用哪种方法而不是过时的方法？

POST v2/businesses/{businessId}/offer-mappings

对于您放置在市场上的每个产品，将返回有关此产品链接到的市场卡的信息:

当前卡（marketSku）的ID，正在进行审核的卡以及最后被拒绝的卡。
市场卡上显示的产品说明。例如，包装的尺寸和产品的重量。

结果逐页返回。输出数据包含下一页的ID。

商店目录中的产品数量是如何计算的?

根据最近七天（不包括今天）的数据。

⚙️ 限制: 每分钟10,000件物品

Request

GET

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-mapping-entries

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置在左边的菜单中，选择 Api和模块:

座 运动ID;
标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

Min value: 1

Query parameters

Name	Description
availability	Type: OfferAvailabilityStatusType[] 按产品交付计划过滤: `ACTIVE` — 会有送货的。 `INACTIVE` — 不会有交付：产品有库存，但您不再计划交付。 `DELISTED` — 存档：该产品已缺货，将不再有交付。您可以在一个参数中指定多个值，用逗号分隔，也可以在几个相同的参数中指定多个值。例如: `...availability=INACTIVE,DELISTED... ...availability=INACTIVE&availability=DELISTED...` 在请求中，您可以指定参数 `shopSku`，或用于过滤产品的任何参数。共享参数 `shopSku` 和过滤选项将导致错误。
category_id	Type: integer[] 通过市场上的类别ID进行过滤。要找出产品所属类别的ID，请使用请求 POST v2/categories/tree. 您可以在一个参数中指定多个标识符（用逗号分隔），也可以在几个相同的参数中指定多个标识符。例如: `...category_id=14727164,14382343... ...category_id=14727164&category_id=14382343...` 在请求中，您可以指定参数 `shopSku`，或用于过滤产品的任何参数。共享参数 `shopSku` 和过滤选项将导致错误。
limit	Type: integer<int32> 每页的值数。 Min value: `1` Example: `20`
mapping_kind	Type: OfferMappingKindType 映射的类型。
offer_id	Type: string[] 目录中的产品ID。
page_token	Type: string 结果页面的ID。如果省略该参数，则返回第一页。我们建议传输输出参数的值 `nextPageToken`，在最后一次请求期间接收。如果设置 `page_token` 并且请求有参数 `page` 和 `pageSize` 它们被忽略了。 Example: `eyBuZXh0SWQ6IDIzNDIgfQ==`
shop_sku	Type: string[] 你的 SKU 的产物。该参数可以指定多次，例如: `...shop_sku=123&shop_sku=129&shop_sku=141...` 在请求中，您可以指定参数 `shopSku`，或用于过滤产品的任何参数。共享参数 `shopSku` 和过滤选项将导致错误。你的 SKU — 系统中的产品ID。使用规则 SKU: 对于每个产品 SKU 一定有一个。已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。阅读有关如何做到这一点。在市场对卖家的帮助. 什么是 SKU 以及如何分配它 Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
status	Type: OfferProcessingStatusType[] 按产品发布状态过滤: `READY` — 该产品已通过审核。 `IN_WORK` — 该产品正在进行适度。 `NEED_CONTENT` — 对于没有的产品 SKU 在市场上 `marketSku` 您需要自己找到一张卡或创建一张卡。 `NEED_INFO` — 由于产品描述中的错误或信息缺失，产品审核失败。 `REJECTED` — 该产品没有通过审核，因为市场不打算发布此类产品。 `SUSPENDED` — 该产品尚未通过审核，因为市场尚未放置此类产品。 `OTHER` — 由于另一个原因，该产品未能审核。您可以在一个参数中指定多个状态（以逗号分隔），也可以在多个相同的参数中指定多个状态。例如: `...status=READY,IN_WORK... ...status=READY&status=IN_WORK...` 请求可以指定shopSku参数或用于筛选产品的任何参数。同时使用shopSku参数和过滤参数将导致错误。
vendor	Type: string[] 按产品品牌过滤。您可以在一个参数中指定多个品牌，用逗号分隔，也可以在几个相同的参数中指定多个品牌。例如: `...vendor=Aqua%20Minerale,Borjomi... ...vendor=Aqua%20Minerale&vendor=Borjomi...` 为了将产品包含在过滤结果中，其品牌必须与请求中指定的品牌之一完全匹配。例如，如果指定了品牌 Schwarzkopf，那么结果中就没有产品了 Schwarzkopf Professional. 如果品牌名称包含表中未包含的字符 ASCII （包括西里尔字符），用于它们 URL-编码。例如，一个空间 — %20,撇号"'" — %27等。有关详细信息，请参阅编码 URL 俄语维基百科. 请求可以指定shopSku参数或用于筛选产品的任何参数。共享参数 `shopSku` 和过滤选项将导致错误。

OfferAvailabilityStatusType

送货计划:

ACTIVE — 会有送货的。
INACTIVE — 不会有交付：产品有库存，但您不再计划交付。产品缺货60天后，此状态将更改为 DELISTED.
DELISTED — 存档：该产品已缺货，将不再有交付。如果产品退回仓库（例如，客户退回订单），则此状态将更改为 INACTIVE.

Type	Description
OfferAvailabilityStatusType	Enum: `ACTIVE`, `INACTIVE`, `DELISTED`

OfferMappingKindType

映射类型:

ALL — 所有产品。
ACTIVE — 即卖产品。

Type	Description
OfferMappingKindType	Enum: `ACTIVE`, `ALL`

OfferProcessingStatusType

产品发布状态:

UNKNOWN — 状态不明。
READY — 该产品已通过审核。要将其投放市场，请为其设定价格。
IN_WORK — 该产品正在进行适度。这需要几天的时间。
NEED_INFO — 由于产品描述中的错误或信息缺失，产品审核失败。参数中返回有关偏差原因的信息 notes.
NEED_MAPPING — 您无法为产品创建卡片。
NEED_CONTENT — 对于没有的产品 SKU 在市场上（marketSku）您需要自己找到卡（通过API或市场上的卖家帐户），或者如果产品尚未在市场上销售，则创建它。
CONTENT_PROCESSING — 该产品处于适度状态。
SUSPENDED — 该产品尚未通过审核，因为市场尚未放置此类产品。
REJECTED — 该产品没有通过审核，因为市场不打算发布此类产品。
REVIEW — 正在就产品的放置做出决定。
CREATE_ERROR — 无法创建产品配置文件。
UPDATE_ERROR — 产品卡有未使用的更改。

Type	Description
OfferProcessingStatusType	Enum: `UNKNOWN`, `READY`, `IN_WORK`, `NEED_INFO`, `NEED_MAPPING`, `NEED_CONTENT`, `CONTENT_PROCESSING`, `SUSPENDED`, `REJECTED`, `REVIEW`, `CREATE_ERROR`, `UPDATE_ERROR`

Responses

200 OK

目录中有关产品的信息。

Body

application/json

{
    "status": "OK",
    "result": {
        "paging": {
            "nextPageToken": "string",
            "prevPageToken": "string"
        },
        "offerMappingEntries": [
            {
                "offer": {
                    "name": "Ударная дрель Makita HP1630, 710 Вт",
                    "shopSku": "string",
                    "category": "string",
                    "vendor": "LEVENHUK",
                    "vendorCode": "VNDR-0005A",
                    "description": "string",
                    "id": "string",
                    "feedId": 0,
                    "barcodes": [
                        "46012300000000"
                    ],
                    "urls": [
                        "string"
                    ],
                    "pictures": [
                        "string"
                    ],
                    "manufacturer": "string",
                    "manufacturerCountries": [
                        "string"
                    ],
                    "minShipment": 0,
                    "transportUnitSize": 0,
                    "quantumOfSupply": 0,
                    "deliveryDurationDays": 0,
                    "boxCount": 0,
                    "customsCommodityCodes": [
                        "string"
                    ],
                    "weightDimensions": {
                        "length": 65.55,
                        "width": 50.7,
                        "height": 20,
                        "weight": 1.001
                    },
                    "supplyScheduleDays": [
                        "MONDAY"
                    ],
                    "shelfLifeDays": 0,
                    "lifeTimeDays": 0,
                    "guaranteePeriodDays": 0,
                    "processingState": {
                        "status": "UNKNOWN",
                        "notes": [
                            {
                                "type": "ASSORTMENT",
                                "payload": "string"
                            }
                        ]
                    },
                    "availability": "ACTIVE",
                    "shelfLife": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "lifeTime": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "guaranteePeriod": {
                        "timePeriod": 0,
                        "timeUnit": "HOUR",
                        "comment": "string"
                    },
                    "certificate": "string",
                    "price": 0
                },
                "mapping": {
                    "marketSku": 0,
                    "modelId": 0,
                    "categoryId": 0
                },
                "awaitingModerationMapping": {
                    "marketSku": 0,
                    "modelId": 0,
                    "categoryId": 0
                },
                "rejectedMapping": {
                    "marketSku": 0,
                    "modelId": 0,
                    "categoryId": 0
                }
            }
        ]
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: OfferMappingEntriesDTO

目录中有关产品的信息。

ApiResponseStatusType

响应的类型。可能的值:

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

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

OfferMappingEntriesDTO

目录中有关产品的信息。

Name

Description

offerMappingEntries*

Type: OfferMappingEntryDTO[]

目录中有关产品的信息。
的产品清单。
品卡的信息。

paging

Type: ScrollingPagerDTO

有关结果页的信息。
下一页的ID。

OfferMappingEntryDTO

的产品清单。

Name	Description
awaitingModerationMapping	Type: OfferMappingDTO Информация о карточке товара на Маркете, проходящей модерацию для данного товара
mapping	Type: OfferMappingDTO Информация о карточке товара на Маркете. Если параметр не указан, сотрудники Маркета сами подберут или создадут подходящую карточку товара, либо у него появится статус `NEED_CONTENT` (нужно найти карточку или создать ее самостоятельно) в выходных данных запроса POST v2/businesses/{businessId}/offer-mappings.
offer	Type: MappingsOfferDTO Информация о товаре из каталога. 目录中有关产品的基本信息。
rejectedMapping	Type: OfferMappingDTO Информация о последней карточке товара на Маркете, отклоненной на модерации для данного товара

ScrollingPagerDTO

有关结果页的信息。

Name

Description

nextPageToken

Type: string

下一个结果页面的ID。

prevPageToken

Type: string

上一个结果页面的ID。

OfferMappingDTO

有关市场上当前产品简介的信息。

Name	Description
categoryId	Type: integer<int64> 市场上当前产品配置文件的类别ID。
marketSku	Type: integer<int64> SKU на Маркете — идентификатор карточки товара на Маркете. При первом запросе `marketSku` привязывает товар к карточке Маркета. В дальнейшем изменить SKU через отправку запроса нельзя, для этого нужно обратиться в службу поддержки. Min value: `1`
modelId	Type: integer<int64> 市场上当前产品配置文件的型号ID。例如，两个不同颜色的刀片具有不同的 SKU 在市场上（参数 `marketSku`），但相同的产品型号标识符。

MappingsOfferDTO

目录中有关产品的信息。

Name

Description

availability

Type: OfferAvailabilityStatusType

送货计划:

ACTIVE — 会有送货的。
INACTIVE — 不会有交付：产品有库存，但您不再计划交付。产品缺货60天后，此状态将更改为 DELISTED.
DELISTED — 存档：该产品已缺货，将不再有交付。如果产品退回仓库（例如，客户退回订单），则此状态将更改为 INACTIVE.

Enum: ACTIVE, INACTIVE, DELISTED

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

boxCount

Type: integer<int32>

产品占用多少个座位（如果超过一个）。

仅当产品占据多于一个位置（例如，空调占据两个位置：两个盒子中的外部和内部单元）时才指定该参数。如果产品占据一个位置，请不要指定此参数。

TimePeriodDTO

带有注释的时间段。注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。

Name	Description
timePeriod*	Type: integer 指定单位的持续时间。
timeUnit*	Type: TimeUnitType Единица измерения. Enum: `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`
comment	Type: string 评论。 Max length: `500`

OfferProcessingStateDTO

品在市场上的发布状态的信息。

Name

Description

notes

Type: OfferProcessingNoteDTO[]

产品审核失败的原因。
产品审核失败的原因。

Min items: 1

status

Type: OfferProcessingStatusType

产品发布状态:

UNKNOWN — 状态不明。
READY — 该产品已通过审核。要将其投放市场，请为其设定价格。
IN_WORK — 该产品正在进行适度。这需要几天的时间。
NEED_INFO — 由于产品描述中的错误或信息缺失，产品审核失败。参数中返回有关偏差原因的信息 notes.
NEED_MAPPING — 您无法为产品创建卡片。
NEED_CONTENT — 对于没有的产品 SKU 在市场上（marketSku）您需要自己找到卡（通过API或市场上的卖家帐户），或者如果产品尚未在市场上销售，则创建它。
CONTENT_PROCESSING — 该产品处于适度状态。
SUSPENDED — 该产品尚未通过审核，因为市场尚未放置此类产品。
REJECTED — 该产品没有通过审核，因为市场不打算发布此类产品。
REVIEW — 正在就产品的放置做出决定。
CREATE_ERROR — 无法创建产品配置文件。
UPDATE_ERROR — 产品卡有未使用的更改。

Enum: UNKNOWN, READY, IN_WORK, NEED_INFO, NEED_MAPPING, NEED_CONTENT, CONTENT_PROCESSING, SUSPENDED, REJECTED, REVIEW, CREATE_ERROR, UPDATE_ERROR

DayOfWeekType

星期几:

MONDAY — 星期一。
TUESDAY — 星期二。
WEDNESDAY — 星期三。
THURSDAY — 星期四。
FRIDAY — 星期五。
SATURDAY — 星期六。
SUNDAY — 星期天。

Type	Description
DayOfWeekType	Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`

OfferWeightDimensionsDTO

包装的尺寸和产品的重量。

如果产品占用几个盒子，在测量尺寸之前将它们紧凑地折叠起来。

多座位货物测量方案

Name	Description
height*	Type: number 包装高度以厘米为单位。 Example: `20` Min value: `0`
length*	Type: number 包装长度以厘米为单位。 Example: `65.55` Min value: `0`
weight*	Type: number 以公斤为单位的产品重量，包括包装（毛）。 Example: `1.001` Min value: `0`
width*	Type: number 包装宽度以厘米为单位。 Example: `50.7` Min value: `0`

TimeUnitType

时间测量单元:

HOUR — 小时。
DAY — 一天。
WEEK — 一个星期。
MONTH — 月份。
YEAR — 年。

Type	Description
TimeUnitType	Enum: `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR`

OfferProcessingNoteDTO

产品审核失败的原因。

Name

Description

payload

Type: string

有关产品拒绝原因的其他信息。

type

Type: OfferProcessingNoteType

Тип причины, по которой товар не прошел модерацию.

Enum: ASSORTMENT, CANCELLED, CONFLICTING_INFORMATION, OTHER, DEPARTMENT_FROZEN, INCORRECT_INFORMATION, LEGAL_CONFLICT, NEED_CLASSIFICATION_INFORMATION, NEED_INFORMATION, NEED_PICTURES, NEED_VENDOR, NO_CATEGORY, NO_KNOWLEDGE, NO_PARAMETERS_IN_SHOP_TITLE, NO_SIZE_MEASURE, SAMPLE_LINE

OfferProcessingNoteType

产品审核失败的原因类型:

ASSORTMENT — 该产品以不同的版本生产。他们每个人都应该被描述为一个单独的产品（参数 offerMappings 在请求 POST v2/businesses/{businessId}/offer-mappings/update 或目录中的一行，如果您通过市场上的卖家帐户上传产品）。
CANCELLED — 该产品是在你的主动下退出的.
CONFLICTING_INFORMATION （以前错误地 CONFLICTING) — 您提供了有关产品的冲突信息。需要修复的参数在参数中指定 payload.
OTHER — 由于另一个原因，该产品未能审核。联系客户支持或您的经理。
DEPARTMENT_FROZEN — 在此类别中放置产品的规则正在处理中，因此该产品还不能通过审核。
INCORRECT_INFORMATION — 您提供的产品信息与制造商的描述相矛盾。需要修复的参数在参数中指定 payload.
LEGAL_CONFLICT — 由于法律原因，该产品未通过审核。例如，它没有在俄罗斯正式销售，或者你没有许可证出售它。
NEED_CLASSIFICATION_INFORMATION — 您提供的有关产品的信息不足以对其进行分类。确保您已正确指定产品的名称，类别，制造商和制造国家，以及 URL 带有可用于识别产品的描述的图像或页面。
NEED_INFORMATION — 该产品之前尚未在俄罗斯销售，目前尚未上市。你可以为它创建一张卡片。有关更多信息，请参阅部分使用产品卡燕基科斯. 卖家的市场帮助。
NEED_PICTURES — 要识别产品，您需要其图像。发送出去 URL 请求中的产品图像 POST v2/businesses/{businessId}/offer-mappings/update 或者通过市场上的卖家账户下载更新的目录。
NEED_VENDOR — 产品制造商指定不正确。
NO_CATEGORY, NO_KNOWLEDGE — 该类别的产品尚未投放市场。如果出现类别，产品将再次发送审核。
NO_PARAMETERS_IN_SHOP_TITLE — 该产品以不同的版本生产，并且从名称中不清楚它是关于哪一个。要添加到产品名称的参数在参数中指定 payload.
NO_SIZE_MEASURE — 您需要此产品的尺寸网格。将其发送给支持服务或您的经理。尺寸网格要求在参数中指定 payload.
SAMPLE_LINE — 由于多了一条线,该产品没有通过审核.

Type	Description
OfferProcessingNoteType	Enum: `ASSORTMENT`, `CANCELLED`, `CONFLICTING_INFORMATION`, `OTHER`, `DEPARTMENT_FROZEN`, `INCORRECT_INFORMATION`, `LEGAL_CONFLICT`, `NEED_CLASSIFICATION_INFORMATION`, `NEED_INFORMATION`, `NEED_PICTURES`, `NEED_VENDOR`, `NO_CATEGORY`, `NO_KNOWLEDGE`, `NO_PARAMETERS_IN_SHOP_TITLE`, `NO_SIZE_MEASURE`, `SAMPLE_LINE`

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

这篇文章是否有用？

添加和编辑产品

设定货物数量和最低数量的限制