REST Resource: accounts.merchantReviews

Ресурс: MerchantReview

Отзыв для продавца. Дополнительную информацию см. в разделе «Введение в фиды отзывов продавцов».

JSON-представление
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
Поля
name

string

Идентификатор. Название отзыва продавца. Формат: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"

merchant Review Id

string

Необходимый. Пользователь предоставил идентификатор отзыва продавца, чтобы однозначно идентифицировать отзыв продавца.

attributes

object ( MerchantReviewAttributes )

Необязательный. Список атрибутов обзора продавца.

custom Attributes[]

object ( CustomAttribute )

Необходимый. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые API явно не предоставляет, например экспериментальных атрибутов. Максимально допустимое количество символов для каждого настраиваемого атрибута — 10 240 (представляет собой сумму символов имени и значения). Для каждого продукта можно установить максимум 2500 пользовательских атрибутов общим размером 102,4 КБ. При вставке символы подчеркивания в именах пользовательских атрибутов заменяются пробелами.

data Source

string

Только вывод. Основной источник данных обзора продавца.

merchant Review Status

object ( MerchantReviewStatus )

Только вывод. Статус отзыва продавца, вопросы проверки данных, то есть информация об отзыве продавца вычисляется асинхронно.

ПродавецОбзорАтрибуты

Атрибуты.

JSON-представление
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
Поля
merchant Id

string

Необходимый. Должен быть уникальным и стабильным для всех запросов. Другими словами, если запрос сегодня и еще 90 дней назад относится к одному и тому же продавцу, они должны иметь один и тот же идентификатор.

merchant Display Name

string

Необязательный. Понятное отображаемое имя продавца.

min Rating

string ( int64 format)

Необязательный. Минимально возможное число для рейтинга. Это должен быть наихудший возможный рейтинг, и он не должен быть значением без рейтинга.

max Rating

string ( int64 format)

Необязательный. Максимально возможное число для рейтинга. Значение максимального рейтинга должно быть больше значения минимального рейтинга.

rating

number

Необязательный. Общий рейтинг продавца по версии рецензента.

title

string

Необязательный. Название обзора.

content

string

Необходимый. Это должен быть любой текст произвольной формы, предоставленный пользователем, и его нельзя обрезать. Если предоставлено несколько ответов на разные вопросы, необходимо включить все ответы с минимальным контекстом, чтобы ответы имели смысл. Контекст не следует предоставлять, если вопросы остались без ответа.

reviewer Id

string

Необязательный. Постоянный уникальный идентификатор автора обзора в системе издателя.

reviewer Username

string

Необязательный. Отображаемое имя автора обзора.

is Anonymous

boolean

Необязательный. Установите значение true, если рецензент должен оставаться анонимным.

collection Method

enum ( CollectionMethod )

Необязательный. Метод, использованный для сбора обзора.

review Time

string ( Timestamp format)

Необходимый. Временная метка, указывающая, когда был написан отзыв.

review Language

string

Необходимый. Язык обзора определяется языковым кодом BCP-47.

review Country

string

Необязательный. Страна, в которой рецензент сделал заказ, определяется кодом страны ISO 3166-1 Alpha-2.

КоллекцияМетод

Метод, использованный для сбора обзора.

Перечисления
COLLECTION_METHOD_UNSPECIFIED Метод сбора не указан.
MERCHANT_UNSOLICITED Пользователь не ответил на конкретное предложение, когда отправлял отзыв.
POINT_OF_SALE Пользователь отправил отзыв в ответ на запрос, полученный при размещении заказа.
AFTER_FULFILLMENT Пользователь отправил отзыв в ответ на запрос после выполнения заказа пользователя.

Статус обзора продавца

Статус отзыва продавца, вопросы проверки данных, то есть информация об отзыве продавца вычисляется асинхронно.

JSON-представление
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
Поля
destination Statuses[]

object ( MerchantReviewDestinationStatus )

Только вывод. Целевые направления для проверки продавца.

item Level Issues[]

object ( MerchantReviewItemLevelIssue )

Только вывод. Список всех проблем, связанных с проверкой продавца.

create Time

string ( Timestamp format)

Только вывод. Дата создания элемента в формате ISO 8601 .

last Update Time

string ( Timestamp format)

Только вывод. Дата последнего обновления элемента в формате ISO 8601 .

ПродавецОтзывDestinationStatus

Статус назначения статуса проверки продавца.

JSON-представление
{
  "reportingContext": enum (ReportingContextEnum)
}
Поля
reporting Context

enum ( ReportingContextEnum )

Только вывод. Имя контекста отчетности.

MerchantReviewItemLevelIssue

ItemLevelIssue статуса проверки продавца.

JSON-представление
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
Поля
code

string

Только вывод. Код ошибки проблемы.

severity

enum ( Severity )

Только вывод. Как эта проблема влияет на предоставление отзывов о продавце.

resolution

string

Только вывод. Может ли проблема быть решена продавцом.

attribute

string

Только вывод. Имя атрибута, если проблема вызвана одним атрибутом.

reporting Context

enum ( ReportingContextEnum )

Только вывод. Контекст отчетности, к которому относится проблема.

description

string

Только вывод. Краткое описание проблемы на английском языке.

detail

string

Только вывод. Подробное описание проблемы на английском языке.

documentation

string

Только вывод. URL-адрес веб-страницы, которая поможет решить эту проблему.

Серьезность

Как проблема влияет на предоставление отзыва продавца.

Перечисления
SEVERITY_UNSPECIFIED Не указан.
NOT_IMPACTED Эта проблема представляет собой предупреждение и не оказывает прямого влияния на отзыв продавца.
DISAPPROVED Проблема не одобряет отзыв продавца.

Методы

delete

Удаляет отзыв продавца.

get

Получает отзыв продавца.

insert

Добавляет отзыв о вашей учетной записи Merchant Center.

list

Перечисляет отзывы продавцов.