REST Resource: accounts.productReviews

Ресурс: Обзор продукта

Обзор продукта. Дополнительную информацию см. в разделе Знакомство с фидами обзоров продуктов.

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

string

Идентификатор. Название обзора продукта. Формат: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

product Review Id

string

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

attributes

object ( ProductReviewAttributes )

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

custom Attributes[]

object ( CustomAttribute )

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

data Source

string

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

product Review Status

object ( ProductReviewStatus )

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

Обзор продуктаАтрибуты

Атрибуты.

JSON-представление
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Поля
review Time

string ( Timestamp format)

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

pros[]

string

Необязательный. Содержит преимущества, основанные на мнении рецензента. Опустите шаблонный текст, например «pro:», если он не был написан рецензентом.

cons[]

string

Необязательный. Содержит недостатки, основанные на мнении рецензента. Опустите шаблонный текст, например «con:», если он не был написан рецензентом.

product Names[]

string

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

asins[]

string

Необязательный. Содержит ASIN (стандартные идентификационные номера Amazon), связанные с продуктом.

gtins[]

string

Необязательный. Содержит GTIN (глобальные номера торговых позиций), связанные с продуктом. Поддерживаются подтипы GTIN (например, UPC, EAN, ISBN, JAN).

mpns[]

string

Необязательный. Содержит MPN (номера деталей производителя), связанные с продуктом.

skus[]

string

Необязательный. Содержит SKU (единицы хранения), связанные с продуктом. Часто это соответствует идентификатору предложения продукта в фиде продуктов.

brands[]

string

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

collection Method

enum ( CollectionMethod )

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

transaction Id

string

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

aggregator Name

string

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

Издатель может использовать агрегатор обзоров для управления отзывами и предоставления каналов. Этот элемент указывает на использование агрегатора и содержит информацию об агрегаторе.

subclient Name

string

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

Субклиент — идентификатор источника обзора продукта. Он должен быть эквивалентен каталогу, указанному в пути к источнику данных файла.

publisher Name

string

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

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

publisher Favicon

string

Необязательный. Ссылка на фавиконку компании издателя. Размеры изображения должны соответствовать размеру значка: 16x16 пикселей. Формат изображения должен быть GIF, JPG или PNG.

reviewer Id

string

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

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

reviewer Is Anonymous

boolean

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

reviewer Username

string

Необязательный. Имя рецензента обзора продукта.

review Language

string

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

review Country

string

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

title

string

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

content

string

Необходимый. Содержание обзора.

min Rating

string ( int64 format)

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

max Rating

string ( int64 format)

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

rating

number

Необязательный. Общая оценка продукта рецензентом.

is Spam

boolean

Необязательный. Указывает, помечен ли отзыв как спам в системе издателя.

Тип

Тип URI проверки.

Перечисления
TYPE_UNSPECIFIED Тип не указан.
SINGLETON Страница обзора содержит только этот единственный отзыв.
GROUP Страница обзора содержит группу отзывов, включая этот обзор.

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

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

Перечисления
COLLECTION_METHOD_UNSPECIFIED Способ сбора не указан.
UNSOLICITED Пользователь не ответил на конкретное предложение, когда отправлял отзыв.
POST_FULFILLMENT Пользователь отправил отзыв в ответ на запрос после выполнения заказа пользователя.

Статус обзора продукта

Статус обзора продукта.

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

object ( ProductReviewDestinationStatus )

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

item Level Issues[]

object ( ProductReviewItemLevelIssue )

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

create Time

string ( Timestamp format)

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

last Update Time

string ( Timestamp format)

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

Обзор продуктаНазначениеСтатус

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

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

enum ( ReportingContextEnum )

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

Обзор продуктаУровень элементаПроблема

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

Вставляет обзор продукта.

list

Содержит обзоры продуктов.
,

Ресурс: Обзор продукта

Обзор продукта. Дополнительную информацию см. в разделе Знакомство с фидами обзоров продуктов.

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

string

Идентификатор. Название обзора продукта. Формат: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

product Review Id

string

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

attributes

object ( ProductReviewAttributes )

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

custom Attributes[]

object ( CustomAttribute )

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

data Source

string

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

product Review Status

object ( ProductReviewStatus )

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

Обзор продуктаАтрибуты

Атрибуты.

JSON-представление
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
Поля
review Time

string ( Timestamp format)

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

pros[]

string

Необязательный. Содержит преимущества, основанные на мнении рецензента. Опустите шаблонный текст, например «pro:», если он не был написан рецензентом.

cons[]

string

Необязательный. Содержит недостатки, основанные на мнении рецензента. Опустите шаблонный текст, например «con:», если он не был написан рецензентом.

product Names[]

string

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

asins[]

string

Необязательный. Содержит ASIN (стандартные идентификационные номера Amazon), связанные с продуктом.

gtins[]

string

Необязательный. Содержит GTIN (глобальные номера торговых позиций), связанные с продуктом. Поддерживаются подтипы GTIN (например, UPC, EAN, ISBN, JAN).

mpns[]

string

Необязательный. Содержит MPN (номера деталей производителя), связанные с продуктом.

skus[]

string

Необязательный. Содержит SKU (единицы хранения), связанные с продуктом. Часто это соответствует идентификатору предложения продукта в фиде продуктов.

brands[]

string

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

collection Method

enum ( CollectionMethod )

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

transaction Id

string

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

aggregator Name

string

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

Издатель может использовать агрегатор обзоров для управления отзывами и предоставления каналов. Этот элемент указывает на использование агрегатора и содержит информацию об агрегаторе.

subclient Name

string

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

Субклиент — идентификатор источника обзора продукта. Он должен быть эквивалентен каталогу, указанному в пути к источнику данных файла.

publisher Name

string

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

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

publisher Favicon

string

Необязательный. Ссылка на фавиконку компании издателя. Размеры изображения должны соответствовать размеру значка: 16x16 пикселей. Формат изображения должен быть GIF, JPG или PNG.

reviewer Id

string

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

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

reviewer Is Anonymous

boolean

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

reviewer Username

string

Необязательный. Имя рецензента обзора продукта.

review Language

string

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

review Country

string

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

title

string

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

content

string

Необходимый. Содержание обзора.

min Rating

string ( int64 format)

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

max Rating

string ( int64 format)

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

rating

number

Необязательный. Общая оценка продукта рецензентом.

is Spam

boolean

Необязательный. Указывает, помечен ли отзыв как спам в системе издателя.

Тип

Тип URI проверки.

Перечисления
TYPE_UNSPECIFIED Тип не указан.
SINGLETON Страница обзора содержит только этот единственный отзыв.
GROUP Страница обзора содержит группу отзывов, включая этот обзор.

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

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

Перечисления
COLLECTION_METHOD_UNSPECIFIED Способ сбора не указан.
UNSOLICITED Пользователь не ответил на конкретное предложение, когда отправлял отзыв.
POST_FULFILLMENT Пользователь отправил отзыв в ответ на запрос после выполнения заказа пользователя.

Статус обзора продукта

Статус обзора продукта.

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

object ( ProductReviewDestinationStatus )

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

item Level Issues[]

object ( ProductReviewItemLevelIssue )

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

create Time

string ( Timestamp format)

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

last Update Time

string ( Timestamp format)

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

Обзор продуктаНазначениеСтатус

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

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

enum ( ReportingContextEnum )

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

Обзор продуктаУровень элементаПроблема

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

Вставляет обзор продукта.

list

Содержит обзоры продуктов.