Отзывы о продуктах — важная часть покупательского опыта. Эти рейтинги и обзоры помогают клиентам исследовать продукцию и принимать решения о покупке. Положительные отзывы о товарах могут привлечь больше квалифицированных клиентов на страницы товаров продавца. Источниками являются продавцы, агрегаторы обзоров, сайты обзоров и пользователи Google.
На этой странице объясняется, как управлять отзывами о продуктах с помощью Merchant API.
Предварительные условия
Google требует, чтобы вы предоставили конкретную информацию. У вас должно быть следующее:
- Активный фид обзоров продуктов в Google Merchant Center.
- Ваша учетная запись должна быть зарегистрирована в программе рейтингов продуктов. Если вы не уверены, зарегистрированы ли вы уже, проверьте Merchant Center. Если вы еще не зарегистрированы, узнайте больше о регистрации в программе рейтингов продуктов .
- Чтобы просмотреть продукты с помощью Merchant API, отправьте запрос, используя эту форму .
Создать источник данных
Используйте API datasource.create для создания фида отзывов о продуктах. Если доступен существующий фид отзывов о продуктах, используйте accounts.dataSources.get для получения accounts.dataSources.name . Форма запроса следующая:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources/{datasource}
Пример
В примере показаны типичные запрос и ответ.
Запрос
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "productReviewDataSource":{} }
Ответ
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"productReviewDataSource": {},
"input": "API"
}
Создать обзор продукта
Вы можете использовать метод accounts.productreviews.insert для создания или обновления обзора продукта. accounts.productreviews.insert принимает в качестве входных данных ресурс productreview и имя источника данных. В случае успеха он возвращает новый или обновленный productreview . Чтобы создать обзор продукта, вам необходимо иметь datasource.name .
Форма запроса:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}/}productReviews:insert
Следующий образец запроса иллюстрирует, как можно создать обзор продукта.
POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{accountId}/productReviews:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}
productReviewId = 'my_product_review'
attributes {
aggregatorName = 'aggregator_name'
subclientName = 'subclient_name'
publisherName = 'publisher_name'
publisherFavicon = 'https://www.google.com/favicon.ico'
reviewerId = 'reviewer_id'
reviewerIsAnonymous = false
reviewerUsername = 'reviewer_username'
reviewLanguage = 'en'
reviewCountry = 'US'
reviewTime = '2024-04-01T00:00:00Z'
title = 'Incredible product'
content = 'This is an incredible product.'
pros = ['pro1', 'pro2']
cons = ['con1', 'con2']
reviewLink = {
type = 'SINGLETON'
link = 'https://www.google.com'
}
reviewerImageLink = 'https://www.google.com/reviewer.png'
minRating = 1
maxRating = 10
rating = 8.5
productName = 'product_name'
productLink = 'https://www.google.com/product'
asins = ['asin1', 'asin2']
gtins = ['gtin1', 'gtin2']
mpns = ['mpn1', 'mpn2']
skus = ['sku1', 'sku2']
brands = ['brand1', 'brand2']
isSpam = false
collectionMethod = 'POST_FULFILLMENT'
transactionId = 'transaction_id'
}
После создания отзыва о продукте его распространение может занять несколько минут.
Посмотреть обзоры продуктов
Чтобы просмотреть обзор продукта, используйте accounts.productreviews.get . Это доступно только для чтения. Для этого требуется ваш accountId и идентификатор обзора продукта как часть поля имени. Метод GET возвращает соответствующий ресурс обзора продукта.
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{accountId}/productReviews/*}
Список отзывов о продуктах
Вы можете использовать метод productreviews.list для просмотра всех созданных обзоров продуктов.
GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}}/productReviews
Удаление отзывов о товарах
Чтобы удалить обзор продукта, accounts.productreviews.delete . Подобно методу GET , для этого метода требуется поле имени отзыва о продукте, возвращенного во время создания.
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{accountId}/productReviews/*}
Статус обзора продукта
Ресурс обзора продукта содержит статус, аналогичный другим API, который является неотъемлемой частью ресурса и имеет ту же структуру проблем и назначений.