添加新的或更改创建的注释

Info

Console

方法适用于所有模式.

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

communication — 与买家沟通
all-methods — 全面管理账户

添加新的商店注释或修改商店之前留下的注释。

要创建评论，请仅发送评论ID。 feedbackId.

要将注释添加到另一个注释，请发送:

feedbackId — 的审查ID。
comment.parentId — 父注释的ID。

要编辑评论，请发送:

feedbackId— 的审查ID。
comment.id — 要编辑的注释的id。

如果你在同一时间传送 comment.parentId 和 comment.id，现有的注释将被更改。

⚙️ 限制: 每小时1,000个请求

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/goods-feedback/comments/update

Path parameters

Name

Description

businessId*

Type: integer<int64>

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

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

Min value: 1

Body

application/json

{
    "feedbackId": 0,
    "comment": {
        "id": 0,
        "parentId": 0,
        "text": "string"
    }
}

Name

Description

comment*

Type: UpdateGoodsFeedbackCommentDTO

Параметры комментария.

feedbackId*

Type: integer<int64>

的审查ID。

UpdateGoodsFeedbackCommentDTO

评论或其他评论的评论。

Name	Description
text*	Type: string 注释的文本。它不得包含商店的联系人或指向Yandex以外的网站的链接。市场。 Min length: `1` Max length: `4096`
id	Type: integer<int64> Идентификатор комментария, который нужно изменить. Оставьте поле пустым, если хотите добавить новый комментарий.
parentId	Type: integer<int64> 要响应的父注释的ID。

Responses

200 OK

有关添加或更改的注释的信息。

Body

application/json

{
    "status": "OK",
    "result": {
        "id": 0,
        "text": "string",
        "canModify": false,
        "parentId": 0,
        "author": {
            "type": "USER",
            "name": "string"
        },
        "status": "PUBLISHED",
        "feedbackId": 0
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: GoodsFeedbackCommentDTO

评论评论.

ApiResponseStatusType

响应的类型。可能的值:

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

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

GoodsFeedbackCommentDTO

评论评论.

Name	Description
feedbackId*	Type: integer<int64> 的审查ID。
id*	Type: integer<int64> 评论评论的ID。
status*	Type: GoodsFeedbackCommentStatusType 评论状态: `PUBLISHED` — 出版。 `UNMODERATED` — 未核实。 `BANNED` — 堵住了。 `DELETED` — 删除。 Enum: `PUBLISHED`, `UNMODERATED`, `BANNED`, `DELETED`
text*	Type: string 注释的文本。它不得包含商店的联系人或指向Yandex以外的网站的链接。市场。 Min length: `1` Max length: `4096`
author	Type: GoodsFeedbackCommentAuthorDTO 关于评论作者的信息。
canModify	Type: boolean 卖家是否可以编辑评论或删除评论。
parentId	Type: integer<int64> 父注释的ID。

GoodsFeedbackCommentStatusType

评论状态:

PUBLISHED — 出版。
UNMODERATED — 未核实。
BANNED — 堵住了。
DELETED — 删除。

Type	Description
GoodsFeedbackCommentStatusType	Enum: `PUBLISHED`, `UNMODERATED`, `BANNED`, `DELETED`

GoodsFeedbackCommentAuthorDTO

关于评论作者的信息。

Name

Description

name

Type: string

作者的名字或内阁的名字。

type

Type: GoodsFeedbackCommentAuthorType

作者类型:

USER — 用户。
BUSINESS — 办公室。

Enum: USER, BUSINESS

GoodsFeedbackCommentAuthorType

作者类型:

USER — 用户。
BUSINESS — 办公室。

Type	Description
GoodsFeedbackCommentAuthorType	Enum: `USER`, `BUSINESS`

400 Bad Request

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

注释更新方法的特定错误:

资料描述	解释说明	解决方法
重复评论	已经有这个文本的评论。	—
评论文本中的非法url	评论文本中找到了指向第三方资源的链接。	删除链接，如有必要，添加那些通向市场的链接。

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

这篇文章是否有用？

检讨的意见

跳过对评论的反应