Добавление нового или изменение созданного комментария

Info

Console

Метод доступен для всех моделей.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

communication — Общение с покупателями
all-methods — Полное управление кабинетом

Добавляет новый комментарий магазина или изменяет комментарий, который магазин оставлял ранее.

Для создания комментария к отзыву передайте только идентификатор отзыва feedbackId.

Чтобы добавить комментарий к другому комментарию, передайте:

feedbackId — идентификатор отзыва;
comment.parentId — идентификатор родительского комментария.

Чтобы изменить комментарий, передайте:

feedbackId— идентификатор отзыва;
comment.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>

Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом 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>

Идентификатор отзыва.

UpdateGoodsFeedbackCommentDTO

Комментарий к отзыву или другому комментарию.

Name	Description
text*	Type: string Текст комментария. Не должен содержать контакты магазина и ссылки на сайты, кроме Маркета. Min length: `1` Max length: `4096`
id	Type: integer<int64> Идентификатор комментария, который нужно изменить. Оставьте поле пустым, если хотите добавить новый комментарий.
parentId	Type: integer<int64> Идентификатор родительского комментария, на который нужно ответить.

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*	Type: integer<int64> Идентификатор комментария к отзыву.
status*	Type: GoodsFeedbackCommentStatusType Статус комментария: `PUBLISHED` — опубликован. `UNMODERATED` — не проверен. `BANNED` — заблокирован. `DELETED` — удален. Enum: `PUBLISHED`, `UNMODERATED`, `BANNED`, `DELETED`
text*	Type: string Текст комментария. Не должен содержать контакты магазина и ссылки на сайты, кроме Маркета. Min length: `1` Max length: `4096`
author	Type: GoodsFeedbackCommentAuthorDTO Информация об авторе комментария.
canModify	Type: boolean Может ли продавец изменять комментарий или удалять его.
parentId	Type: integer<int64> Идентификатор комментария к отзыву.

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

Запрос содержит неправильные данные. Подробнее об ошибке

Специфичные ошибки для метода обновления комментария:

Описание	Пояснение	Способы решения
Duplicate comment	Уже есть комментарий с таким текстом.	—
Illegal url in comment text	В тексте комментария найдены ссылки на сторонние ресурсы.	Удалите ссылки и при необходимости добавьте те, которые ведут на Маркет.

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

Была ли статья полезна?

Комментарии к отзыву

Пропуск реакции на отзывы