Новые и обновленные отзывы о магазине
Этот метод устарел. Не используйте его.
Возвращает новые и обновленные отзывы о магазине на Маркете.
Результаты возвращаются постранично, одна страница содержит не более 20 отзывов. Выходные данные содержат идентификатор следующей страницы.
⚙️ Лимит: 100 запросов в час |
---|
Request
GET
https://api.partner.market.yandex.ru/campaigns/{campaignId}/feedback/updates
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Query parameters
Name |
Description |
from_date |
Type: string<date> Начальная дата обновления отзывов. Если параметр указан, возвращаются отзывы, которые были написаны или обновлены с этой даты. Формат даты: |
limit |
Type: integer<int32> Количество значений на одной странице.
|
page_token |
Type: string Идентификатор страницы c результатами. Если параметр не указан, возвращается первая страница. Рекомендуется передавать значение выходного параметра Если задан |
Responses
200 OK
Список отзывов для магазина.
Body
application/json
{
"status": "OK",
"result": {
"paging": {
"nextPageToken": "string",
"prevPageToken": "string"
},
"feedbackList": [
{
"id": 0,
"createdAt": "2022-12-29T18:02:01Z",
"text": "string",
"state": "LAST",
"author": {
"name": "string",
"region": {
"id": 0,
"name": "string",
"type": "OTHER",
"parent": {
"id": 0,
"name": "string",
"type": "OTHER",
"children": [
{
"id": 0,
"name": "string",
"type": "OTHER",
"children": [
null
]
}
]
},
"children": [
{
"id": 0,
"name": "string",
"type": "OTHER",
"parent": {
"id": 0,
"name": "string",
"type": "OTHER",
"children": [
null
]
},
"children": [
null
]
}
]
}
},
"pro": "string",
"contra": "string",
"comments": [
{
"id": 0,
"parentId": 0,
"body": "string",
"createdAt": "2022-12-29T18:02:01Z",
"updatedAt": "2022-12-29T18:02:01Z",
"author": {
"type": "USER",
"name": "string"
},
"children": [
null
]
}
],
"shop": {
"name": "string"
},
"resolved": false,
"verified": false,
"recommend": false,
"grades": {
"average": 0,
"agreeCount": 0,
"rejectCount": 0,
"factors": [
{
"id": 0,
"title": "string",
"description": "string",
"value": 0
}
]
},
"order": {
"shopOrderId": "string",
"delivery": "DELIVERY"
}
}
]
}
}
Name |
Description |
result |
Type: FeedbackListDTO Отзывы пользователей Яндекс Маркета об указанном магазине. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
FeedbackListDTO
Отзывы пользователей Яндекс Маркета об указанном магазине.
Name |
Description |
feedbackList |
Type: FeedbackDTO[] Список отзывов. Содержит не более 20 отзывов.
|
paging |
Type: ScrollingPagerDTO Информация о страницах результатов. |
FeedbackDTO
Отзыв пользователя Яндекс Маркета об указанном магазине.
Name |
Description |
author |
Type: FeedbackAuthorDTO Информация об авторе отзыва. Если отзыв оставлен анонимно, параметр не возвращается. |
comments |
Type: FeedbackCommentDTO[] Переписка автора отзыва с магазином. |
contra |
Type: string Недостатки магазина, описанные в отзыве. |
createdAt |
Type: string<date-time> Дата и время создания отзыва. Формат даты: ISO 8601 со смещением относительно UTC. Например, |
grades |
Type: FeedbackGradesDTO Информация об оценках, которые поставил автор отзыва магазину, и об оценках полезности отзыва от других пользователей Маркета. |
id |
Type: integer<int64> Идентификатор отзыва. |
order |
Type: FeedbackOrderDTO Информация о заказе, указанная в отзыве. |
pro |
Type: string Достоинства магазина, описанные в отзыве. |
recommend |
Type: boolean Купил бы автор отзыва в магазине снова:
|
resolved |
Type: boolean Решена ли проблема автора отзыва:
Если проблема решена, около отзыва на странице магазина появляется соответствующая надпись. |
shop |
Type: FeedbackShopDTO Информация о магазине. |
state |
Type: FeedbackStateType Статус отзыва:
Enum: |
text |
Type: string Комментарий автора отзыва. |
verified |
Type: boolean Этот параметр устарел. Не используйте его. Является ли отзыв рекомендованным:
|
ScrollingPagerDTO
Информация о страницах результатов.
Name |
Description |
nextPageToken |
Type: string Идентификатор следующей страницы результатов. |
prevPageToken |
Type: string Идентификатор предыдущей страницы результатов. |
FeedbackAuthorDTO
Информация об авторе отзыва.
Если отзыв оставлен анонимно, параметр не возвращается.
Name |
Description |
name |
Type: string Имя автора отзыва. |
region |
Type: RegionDTO Информация о регионе автора отзыва. |
FeedbackCommentDTO
Комментарий к отзыву на магазин.
Name |
Description |
author |
Type: FeedbackCommentAuthorDTO Информация об авторе комментария. |
body |
Type: string Текст ответа. |
children |
Type: FeedbackCommentDTO[] Дочерние ответы. |
createdAt |
Type: string<date-time> Дата и время создания ответа. Формат даты: ISO 8601 со смещением относительно UTC. Например, |
id |
Type: integer<int64> Идентификатор ответа. |
parentId |
Type: integer<int64> Идентификатор родительского ответа. |
updatedAt |
Type: string<date-time> Дата и время изменения ответа. Формат даты: ISO 8601 со смещением относительно UTC. Например, |
FeedbackGradesDTO
Информация об оценках, которые поставил автор отзыва магазину, и об оценках полезности отзыва от других пользователей Маркета.
Name |
Description |
agreeCount |
Type: integer<int64> Количество пользователей, считающих отзыв полезным. |
average |
Type: number Общая оценка, указанная в отзыве: от |
factors |
Type: FeedbackFactorDTO[] Информация об оценках по параметрам, указанных в отзыве. При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр |
rejectCount |
Type: integer<int64> Количество пользователей, считающих отзыв бесполезным. |
FeedbackOrderDTO
Информация о заказе, указанная в отзыве.
Name |
Description |
delivery |
Type: FeedbackDeliveryType Способ покупки, указанный в отзыве. Enum: |
shopOrderId |
Type: string Номер заказа, указанный в отзыве. |
FeedbackShopDTO
Информация о магазине.
Name |
Description |
name |
Type: string Название магазина. |
FeedbackStateType
Статус отзыва:
LAST
— актуален.PREVIOUS
— устарел.DELETED
— удален.
Type |
Description |
Enum: |
RegionDTO
Регион доставки.
Name |
Description |
name* |
Type: string Название региона. |
type* |
Type: RegionType Тип региона. Enum: |
children |
Type: RegionDTO[] Дочерние регионы. |
id |
Type: integer<int64> Идентификатор региона. |
parent |
Type: RegionDTO Информация о родительском регионе. Указываются родительские регионы до уровня страны. |
FeedbackCommentAuthorDTO
Информация об авторе комментария.
Name |
Description |
name |
Type: string Имя автора отзыва или название магазина. |
type |
Type: FeedbackCommentAuthorType Тип автора:
Enum: |
FeedbackFactorDTO
Информация об оценках по параметрам, указанных в отзыве.
При создании отзыва автору предлагается поставить оценки магазину по нескольким параметрам: например, за скорость обработки заказа или удобство самовывоза. Набор параметров зависит от того, какой способ покупки (параметр delivery
) указал автор.
Name |
Description |
description |
Type: string Описание параметра. Например, |
id |
Type: integer<int64> Идентификатор параметра. |
title |
Type: string Название параметра. Например, |
value |
Type: integer<int32> Оценка по параметру, указанная в отзыве: от |
FeedbackDeliveryType
Способ покупки, указанный в отзыве:
DELIVERY
— доставка.PICKUP
— самовывоз.INSTORE
— в магазине.
Type |
Description |
Enum: |
RegionType
Тип региона.
Возможные значения:
-
CITY_DISTRICT
— район города. -
CITY
— крупный город. -
CONTINENT
— континент. -
COUNTRY_DISTRICT
— область. -
COUNTRY
— страна. -
REGION
— регион. -
REPUBLIC_AREA
— район субъекта федерации. -
REPUBLIC
— субъект федерации. -
SUBWAY_STATION
— станция метро. -
VILLAGE
— город. -
OTHER
— неизвестный регион.
Type |
Description |
Enum: |
FeedbackCommentAuthorType
Тип автора:
USER
— пользователь.SHOP
— магазин.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
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[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
404 Not Found
Запрашиваемый ресурс не найден.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |