编辑产品类别特征

Info

Console

方法适用于模式：FBY, FBS, Express 和 DBS.

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

offers-and-cards-management — 商品和卡片管理
all-methods — 全面管理账户

编辑特定于其所属类别的产品特征。

这里只是属于特定类别的内容。

如果您需要更改产品的主要参数（名称，描述，图像，视频，制造商，条形码），请使用请求 POST v2/businesses/{businessId}/offer-mappings/update.

若要删除类型的参数中设置的特征 string，传递一个空值。

目录中的数据不会立即更新

最多需要几分钟。

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

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-cards/update

Path parameters

Name

Description

businessId*

Type: integer<int64>

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

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

Min value: 1

Body

application/json

{
    "offersContent": [
        {
            "offerId": "string",
            "categoryId": 0,
            "parameterValues": [
                {
                    "parameterId": 0,
                    "unitId": 0,
                    "valueId": 0,
                    "value": "string"
                }
            ]
        }
    ]
}

Name

Description

offersContent*

Type: OfferContentDTO[]

具有指定特性的产品列表。
规定的特性的物品。

Min items: 1

Max items: 100

OfferContentDTO

规定的特性的物品。

Name	Description
categoryId*	Type: integer<int32> 市场上的类别的ID。更改类别时，请确保参数中的产品特性及其值 `parameterValues` 您正在提交一个新的类别. 您可以使用请求获取市场类别列表。 POST v2/categories/tree. Min value (exclusive): `0`
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}$`
parameterValues*	Type: ParameterValueDTO[] 具有其值的特征列表。当改变特性时，仅传送其值需要更新的那些。如果在 `categoryId` 您正在更改类别，新旧类别的共同特征的值将保留，并且您不需要转移它们。要删除给定特性的值，传递它 `parameterId` 与一个空 `value`. 特性的值。您可以为同一特性指定多个值，前提是: 特征类型 — `ENUM`. 响应请求 POST v2/category/{categoryId}/parameters 这个特性有一个领域 `multivalue` 这很重要 `true`. 要做到这一点，在 `parameterValues` 分别传递每个值 — 带参数的多个对象 `parameterId`, `valueId` 和 `value`. 参数 `parameterId` 它必须是相同的。 Min items: `1` Max items: `300`

ParameterValueDTO

特性的值。

您可以为同一特性指定多个值，前提是:

特征类型 — ENUM.
响应请求 POST v2/category/{categoryId}/parameters 这个特性有一个领域 multivalue 这很重要 true.

要做到这一点，在 parameterValues 分别传递每个值 — 带参数的多个对象 parameterId, valueId 和 value. 参数 parameterId 它必须是相同的。

Name	Description
parameterId*	Type: integer<int64> 特性的标识符。 Min value: `1`
unitId	Type: integer<int64> 测量单位的ID。如果没有传递参数 `unitId`，使用默认的测量单位。
value	Type: string 意义。对于类型特征 `ENUM` 与...... `valueId`.
valueId	Type: integer<int64> 值的ID。如果要从从市场接收的可接受值列表中传输值，请务必指定标识符。与...... `value`. 仅针对类型特征 `ENUM`.

Responses

200 OK

请求已正确执行，并且数据已被处理。

回答 200 就其本身而言，它并不意味着传递的值是正确的。

请务必查看响应的详细信息。: status 和错误列表，如果有的话。

即使仅在一个产品的特性中出现错误，也不会在目录中包含来自请求的任何更改。

如果在 status 回来了 ERROR，确保:

所有要求的规格都填写完毕。
特征实际存在于指定的类别中;
值对应于特征;
您自己的值具有所需的数据类型。

字段将帮助您发现问题。 errors 和 warnings.

Body

application/json

{
    "status": "OK",
    "results": [
        {
            "offerId": "string",
            "errors": [
                {
                    "type": "OFFER_NOT_FOUND",
                    "parameterId": 0,
                    "message": "string"
                }
            ],
            "warnings": [
                {
                    "type": "OFFER_NOT_FOUND",
                    "parameterId": 0,
                    "message": "string"
                }
            ]
        }
    ]
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

results

Type: UpdateOfferContentResultDTO[]

处理传输值时出现的错误和警告。列表中的每个项目对应一个产品。

如果没有错误或警告，则不传递该字段。
传输的特性而出现的错误和警告。

Min items: 1

ApiResponseStatusType

响应的类型。可能的值:

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

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

UpdateOfferContentResultDTO

传输的特性而出现的错误和警告。

Name	Description
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}$`
errors	Type: OfferContentErrorDTO[] 错误。如果至少有一个产品出现错误，目录中的信息将不会更新所有传输的产品。错误或警告的文本。 Min items: `1`
warnings	Type: OfferContentErrorDTO[] 警告。目录中的信息将被更新。错误或警告的文本。 Min items: `1`

OfferContentErrorDTO

错误或警告的文本。

Name	Description
message*	Type: string 错误或警告的文本。
type*	Type: OfferContentErrorType 错误和警告的类型: `OFFER_NOT_FOUND` — 目录中没有这样的产品。 `UNKNOWN_CATEGORY` — 指定未知类别。 `INVALID_CATEGORY` — 指定了非叶类别。指定没有子类别的类别。 `UNKNOWN_PARAMETER` — 已经传输了不属于该类别特征的特征。 `UNEXPECTED_BOOLEAN_VALUE` — 传递其他内容而不是布尔值。 `NUMBER_FORMAT` — 传递的字符串不代表数字，而不是数字。 `INVALID_UNIT_ID` — 特性不可接受的测量单位已经通过。 `INVALID_GROUP_ID_LENGTH` — 名称中超过允许的字符值 — 255. `INVALID_GROUP_ID_CHARACTERS` — 通过无效字符. 您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 POST v2/category/{categoryId}/parameters. Enum: `OFFER_NOT_FOUND`, `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`
parameterId	Type: integer<int64> 与错误或警告相关联的功能的ID。

OfferContentErrorType

错误和警告的类型:

OFFER_NOT_FOUND — 目录中没有这样的产品。
UNKNOWN_CATEGORY — 指定未知类别。
INVALID_CATEGORY — 指定了非叶类别。指定没有子类别的类别。
UNKNOWN_PARAMETER — 已经传输了不属于该类别特征的特征。
UNEXPECTED_BOOLEAN_VALUE — 传递其他内容而不是布尔值。
NUMBER_FORMAT — 传递的字符串不代表数字，而不是数字。
INVALID_UNIT_ID — 特性不可接受的测量单位已经通过。
INVALID_GROUP_ID_LENGTH — 名称中超过允许的字符值 — 255.
INVALID_GROUP_ID_CHARACTERS — 通过无效字符.

您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 POST v2/category/{categoryId}/parameters.

Type	Description
OfferContentErrorType	Enum: `OFFER_NOT_FOUND`, `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`

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

423 Locked

指定的方法不能应用于资源。有关错误的更多信息

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

这篇文章是否有用？

有关卡占用的信息

内阁中