Package google.shopping.merchant.reviews.v1beta

Индекс

ТорговецОтзывыСервис

Сервис для управления отзывами продавцов.

Удалитьобзор продавца

rpc DeleteMerchantReview( DeleteMerchantReviewRequest ) returns ( Empty )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

GetMerchantReview

rpc GetMerchantReview( GetMerchantReviewRequest ) returns ( MerchantReview )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Вставитьобзор продавца

rpc InsertMerchantReview( InsertMerchantReviewRequest ) returns ( MerchantReview )

Добавляет отзыв о вашей учетной записи Merchant Center. Если отзыв уже существует, он заменяется новым экземпляром.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

СписокторговцевОтзывы

rpc ListMerchantReviews( ListMerchantReviewsRequest ) returns ( ListMerchantReviewsResponse )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

ПродуктОтзывыСервис

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

Удалить обзор продукта

rpc DeleteProductReview( DeleteProductReviewRequest ) returns ( Empty )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Получить обзор продукта

rpc GetProductReview( GetProductReviewRequest ) returns ( ProductReview )

Получает обзор продукта.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

ВставитьОбзорПродукта

rpc InsertProductReview( InsertProductReviewRequest ) returns ( ProductReview )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

СписокОтзывыПродуктов

rpc ListProductReviews( ListProductReviewsRequest ) returns ( ListProductReviewsResponse )

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

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Удалить запрос продавца на обзор

Сообщение запроса для метода DeleteMerchantReview .

Поля
name

string

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

Удалитьпродуктревьюреквест

Сообщение запроса для метода DeleteProductReview .

Поля
name

string

Необходимый. Идентификатор обзора продукта. Формат: account/{account}/productReviews/{productReview}.

GetMerchantReviewRequest

Сообщение запроса для метода GetMerchantReview .

Поля
name

string

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

Получить запрос на обзор продукта

Сообщение запроса для метода GetProductReview.

Поля
name

string

Необходимый. Идентификатор отзыва продавца. Формат: account/{account}/productReviews/{productReview}.

Вставить запрос продавца на обзор

Сообщение запроса для метода InsertMerchantReview .

Поля
parent

string

Необходимый. Аккаунт, в который будет добавлен отзыв о продавце. Формат: аккаунты/{аккаунт}

merchant_ review

MerchantReview

Необходимый. Отзыв продавца, который нужно вставить.

data_ source

string

Необходимый. Источник данных формата MerchantReview : accounts/{account}/dataSources/{datasource} .

Вставкапродуктревьюреквест

Сообщение запроса для метода InsertProductReview .

Поля
parent

string

Необходимый. Аккаунт, в который будет добавлен обзор продукта. Формат: аккаунты/{аккаунт}

product_ review

ProductReview

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

data_ source

string

Необходимый. Формат: accounts/{account}/dataSources/{datasource} .

СписокПродавецОтзывыЗапрос

Сообщение запроса для метода ListMerchantsReview .

Поля
parent

string

Необходимый. Аккаунт, для которого нужно разместить отзывы о продавцах. Формат: аккаунты/{аккаунт}

page_ size

int32

Необязательный. Максимальное количество отзывов о продавце для возврата. Служба может возвращать меньшее значение, чем это значение. Максимальное значение — 1000; значения выше 1000 приводятся к 1000. Если не указано, возвращается максимальное количество отзывов.

page_ token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListMerchantReviews . Предоставьте это, чтобы получить следующую страницу.

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

ListMerchantReviewsResponse

Ответное сообщение для метода ListMerchantsReview .

Поля
merchant_ reviews[]

MerchantReview

Обзор торговца.

next_ page_ token

string

Токен для получения следующей страницы результатов.

СписокПродуктОтзывыЗапрос

Сообщение запроса для метода ListProductReviews.

Поля
parent

string

Необходимый. Аккаунт, для которого будут публиковаться обзоры продуктов. Формат: аккаунты/{аккаунт}

page_ size

int32

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

page_ token

string

Необязательный. Токен страницы, полученный в результате предыдущего вызова ListProductReviews . Предоставьте это, чтобы получить следующую страницу.

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

СписокПродуктовОтзывыОтвет

ответное сообщение для метода ListProductReviews.

Поля
product_ reviews[]

ProductReview

Обзор продукта.

next_ page_ token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют.

Обзор продавца

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

Поля
name

string

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

merchant_ review_ id

string

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

attributes

MerchantReviewAttributes

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

custom_ attributes[]

CustomAttribute

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

data_ source

string

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

merchant_ review_ status

MerchantReviewStatus

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

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

Атрибуты.

Поля
merchant_ id

string

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

merchant_ display_ name

string

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

min_ rating

int64

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

max_ rating

int64

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

rating

double

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

title

string

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

content

string

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

reviewer_ id

string

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

reviewer_ username

string

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

is_ anonymous

bool

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

collection_ method

CollectionMethod

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

review_ time

Timestamp

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

review_ language

string

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

review_ country

string

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

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

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

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

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

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

Поля
destination_ statuses[]

MerchantReviewDestinationStatus

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

item_ level_ issues[]

MerchantReviewItemLevelIssue

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

create_ time

Timestamp

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

last_ update_ time

Timestamp

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

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

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

Поля
reporting_ context

ReportingContextEnum

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

MerchantReviewItemLevelIssue

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

Поля
code

string

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

severity

Severity

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

resolution

string

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

attribute

string

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

reporting_ context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

Серьезность

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

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

Обзор продукта

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

Поля
name

string

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

product_ review_ id

string

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

attributes

ProductReviewAttributes

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

custom_ attributes[]

CustomAttribute

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

data_ source

string

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

product_ review_ status

ProductReviewStatus

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

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

Атрибуты.

Поля
review_ time

Timestamp

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

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

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

bool

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

reviewer_ username

string

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

review_ language

string

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

review_ country

string

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

title

string

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

content

string

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

min_ rating

int64

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

max_ rating

int64

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

rating

double

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

is_ spam

bool

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

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

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

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

Тип

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

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

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

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

Поля
destination_ statuses[]

ProductReviewDestinationStatus

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

item_ level_ issues[]

ProductReviewItemLevelIssue

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

create_ time

Timestamp

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

last_ update_ time

Timestamp

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

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

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

Поля
reporting_ context

ReportingContextEnum

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

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

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

Поля
code

string

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

severity

Severity

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

resolution

string

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

attribute

string

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

reporting_ context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

Серьезность

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

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