编辑产品类别特征
方法适用于模式: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: |
Body
application/json
{
"offersContent": [
{
"offerId": "string",
"categoryId": 0,
"parameterValues": [
{
"parameterId": 0,
"unitId": 0,
"valueId": 0,
"value": "string"
}
]
}
]
}
|
Name |
Description |
|
offersContent* |
Type: object[] 具有指定特性的产品列表。 Min items: Max items: |
Responses
200 OK
请求已正确执行,并且数据已被处理。
回答 200 就其本身而言,它并不意味着传递的值是正确的。
请务必查看响应的详细信息。: status,以及错误列表(results.errors)和评论(results.warnings),如果有的话。
- 如果至少有一个产品返回错误(
results.errors),场status=ERROR. 不会应用对所有转移项目的更改。 - 如果没有错误,但至少有一个产品返回了注释(
results.warnings),场status=OK,并将应用更改。
如果在 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: string 响应的类型。 可能的值:
Enum: |
|
results |
Type: object[] 处理传输值时出现的错误和警告。 列表中的每个项目对应一个产品。 如果没有错误或警告,则不传递该字段。
Min items: |
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: |
423 Locked
指定的方法不能应用于资源。 有关错误的更多信息
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.
ASCII字符0到31(9除外)和127被禁止。 从表.