Adding a new or changing a created comment
The method is available for all models.
If you are using an API Key token, one of the accesses in the list is required to call the method
- communication — Customer communication
- all-methods — Full account management
Adds a new store comment or modifies a comment that the store left earlier.
To create a comment on a review, send only the review ID. feedbackId.
To add a comment to another comment, send:
feedbackId— the review ID.comment.parentId— ID of the parent comment.
To edit a comment, send:
feedbackId— the review ID.comment.id— ID of the comment that needs to be changed.
If you transmit at the same time comment.parentId and comment.id, an existing comment will be changed.
| , Limit: 1,000 requests per hour |
|---|
Request
POST
https://api.partner.market.yandex.ru/businesses/{businessId}/goods-feedback/comments/update
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> Cabinet ID. To find out, use the request GET campaigns. ℹ️ What is a cabinet and a store on the Market?
Min value: |
Body
application/json
{
"feedbackId": 0,
"comment": {
"id": 0,
"parentId": 0,
"text": "string"
}
}
|
Name |
Description |
|
comment* |
Type: UpdateGoodsFeedbackCommentDTO Comment parameters. |
|
feedbackId* |
Type: integer<int64> The review ID. |
UpdateGoodsFeedbackCommentDTO
A comment on a review or other comment.
|
Name |
Description |
|
text* |
Type: string The text of the comment. Min length: Max length: |
|
id |
Type: integer<int64> ID of the comment to edit. Leave the field empty if you want to add a new comment. |
|
parentId |
Type: integer<int64> ID of the parent comment to respond to. |
Responses
200 OK
Information about the added or changed comment.
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 |
|
result |
Type: GoodsFeedbackCommentDTO Comment on the review. |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
GoodsFeedbackCommentDTO
Comment on the review.
|
Name |
Description |
|
feedbackId* |
Type: integer<int64> The review ID. |
|
id* |
Type: integer<int64> ID of the review comment. |
|
status* |
Type: GoodsFeedbackCommentStatusType Comment status:
Enum: |
|
text* |
Type: string The text of the comment. Min length: Max length: |
|
author |
Type: GoodsFeedbackCommentAuthorDTO Information about the comment's author. |
|
canModify |
Type: boolean Whether the seller can edit the comment or delete it. |
|
parentId |
Type: integer<int64> ID of the review comment. |
ApiResponseStatusType
The type of response. Possible values:
OK— there are no mistakes.ERROR— an error occurred while processing the request.
|
Type |
Description |
|
Enum: |
GoodsFeedbackCommentStatusType
Comment status:
PUBLISHED— published.UNMODERATED— not verified.BANNED— blocked.DELETED— deleted.
|
Type |
Description |
|
Enum: |
GoodsFeedbackCommentAuthorDTO
Information about the comment's author.
|
Name |
Description |
|
name |
Type: string The name of the author or the name of the cabinet. |
|
type |
Type: GoodsFeedbackCommentAuthorType Type of author:
Enum: |
GoodsFeedbackCommentAuthorType
Type of author:
USER— the user.BUSINESS— an office.
|
Type |
Description |
|
Enum: |
400 Bad Request
The request contains incorrect data. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
ApiErrorDTO
The general error format.
|
Name |
Description |
|
code* |
Type: string The error code. |
|
message |
Type: string Description of the error. |
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
404 Not Found
The requested resource was not found. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
500 Internal Server Error
Internal error in Yandex. Market. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] A list of errors. Min items: |
|
status |
Type: ApiResponseStatusType The type of response. Possible values:
Enum: |
No longer supported, please use an alternative and newer version.