Отзывы продавцов помогают людям находить компании, которые предлагают высококачественное обслуживание клиентов, помогают укрепить доверие и позволяют принимать более обоснованные решения о покупке. В результате рейтинги магазинов могут помочь компаниям повысить эффективность рекламы и органических списков и привлечь на целевые страницы более квалифицированных клиентов.
На этой странице объясняется, как управлять отзывами продавцов с помощью Merchant API.
Предварительные условия
Google требует, чтобы вы предоставили конкретную информацию. У вас должно быть следующее:
- Активный источник данных отзывов продавцов в Google Merchant Center.
- Ваша учетная запись должна быть зарегистрирована в программе рейтингов магазинов . Если вы не уверены, зарегистрированы ли вы уже, проверьте Merchant Center. Если вы не зарегистрированы, отправьте форму запроса .
Создать источник данных
Используйте API datasource.create для создания рекламного канала. Если существующий фид рекламной акции доступен, используйте datasource.get для получения datasource.name .
Форма запроса следующая:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{accountId}/dataSources/{dataSourceId}
Пример
В примере показаны типичные запрос и ответ.
Запрос
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }
Ответ
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"merchantReviewDataSource": {},
"input": "API"
}
Создать отзыв о продавце
Вы можете использовать метод accounts.merchantreviews.insert для создания или обновления отзыва о продавце. accounts.merchantreviews.insert принимает в качестве входных данных ресурс merchantreview и имя источника данных. В случае успеха он возвращает новый или обновленный обзор продавца. Для создания обзора продавца требуется datasource.name .
Форма запроса:
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert
Для справки изучите следующий образец обзора продавца.
POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{accountId}/merchantReviews:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}
merchantReviewId = 'my_own_review'
attributes {
merchantId = 'merchant_id'
merchantDisplayName = 'merchant_display_name'
merchantLink = 'publisher_name'
merchantRatingLink = 'https://www.google.com'
minRating = 1
maxRating = 10
rating = 7.9
title = 'Amazing Merchant'
content = 'This is an incredible merchant'
reviewerId = 'reviewer_id'
reviewerUsername = 'reviewer_username'
isAnonymous = false
collectionMethod = 'AFTER_FULFILLMENT'
reviewTime = '2024-04-01T00:00:00Z'
reviewLanguage = 'en'
reviewCountry = 'US'
}
После создания отзыва о продавце его распространение может занять несколько минут.
Посмотреть отзывы о продавцах
Чтобы просмотреть обзор продавца, используйте accounts.merchantreviews.get . Это доступно только для чтения. Для этого требуется ваш merchantId и идентификатор отзыва продавца как часть поля имени. Метод get возвращает соответствующий ресурс обзора продавца.
Например:
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Получение списка отзывов о продавцах
Вы можете использовать метод merchantreviews.list для просмотра всех созданных обзоров продавцов.
GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*}/merchantReviews
Удаление отзывов о продавцах
Чтобы удалить accounts.merchantreviews.delete продавца, используйтеaccounts.merchantreviews.delete. Подобно методу get, для него требуется поле имени отзыва продавца, возвращенного во время создания.
Например:
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
Статус проверки продавца
Ресурс обзора продавца содержит статус, аналогичный другим API, который является неотъемлемой частью ресурса и имеет ту же структуру проблем и мест назначения.