Изменился способ получения агрегированной статистики товаров и информации о проблемах. Функциональность, ранее доступная в ресурсе accountstatuses в Content API for Shopping, теперь выделена в отдельные ресурсы в Merchant API. В этом руководстве объясняется, как перенести интеграцию для использования нового ресурса aggregateProductStatuses .
Примечание : в Merchant API проблемы на уровне аккаунта и агрегированные статусы товаров разделены. Также ознакомьтесь с нашим руководством по переходу от accountstatuses к проблемам аккаунта .
Ключевые отличия
Ниже приведены основные различия между функциями статуса продукта в Content API for Shopping и Merchant API:
- Выделенные ресурсы : ресурс
accountstatusesиз Content API for Shopping теперь разделён. В Merchant API проблемы на уровне аккаунта доступны через ресурсaccountissues, а агрегированная статистика товаров и проблемы на уровне товаров — через новый ресурсaggregateProductStatuses. - Новая структура ресурсов :
AggregateProductStatus— это новый ресурс, который представляет статистику и проблемы для определенной комбинации контекста отчетности и страны. - Механизм фильтрации : вместо использования параметров запроса, таких как
destinationsдля выбора данных, API торговца использует методlistсо строкойfilterдля запроса определенных контекстов отчетности и стран. - Удаление поля канала : Поле
channelбольше не используется. Эта информация теперь неявно является частьюreportingContext.
Запросы
API продавца использует GET запрос с параметром filter для получения агрегированных статусов продуктов.
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
Формат URL запроса
| Запросить описание | API контента для покупок | API торговца |
|---|---|---|
| Получите статистику и информацию о проблемах с продуктами | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} | GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
Идентификаторы
Для поддержки новой структуры изменился способ определения ресурсов.
Формат идентификатора
| Описание идентификатора | API контента для покупок | API торговца |
|---|---|---|
| Идентификатор ресурса | Ресурс был идентифицирован по accountId . Конкретные фрагменты данных были выбраны с помощью параметров запроса. | Имя ресурса однозначно идентифицирует данные для конкретного контекста отчетности и страны: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} . |
Методы
Метод получения статусов продуктов обновлен до метода list , поддерживающего фильтрацию.
| API контента для метода покупок | Метод API торговца | Доступность и примечания |
|---|---|---|
accountstatuses.get | aggregateProductStatuses.list | Метод accountstatuses.get вернул один ресурс, содержащий всю статистику по продуктам. Новый метод aggregateProductStatuses.list возвращает список ресурсов, по одному для каждой комбинации контекста отчётности и страны. Используйте параметр filter для получения конкретных данных. Для проблем на уровне аккаунта используйте accountissues.list . |
Подробные изменения полей
Поля для статистики и проблем с продуктами были обновлены и реструктурированы в новом ресурсе AggregateProductStatus .
| API контента для покупок | API торговца | Описание |
|---|---|---|
products | aggregate_product_statuses | Массив products заменяется повторяющимся полем aggregate_product_statuses в ответе списка. |
destination | reporting_context | Поле destination заменяется на reporting_context , которое указывает программный контекст для статистики. |
channel | (нет эквивалентного поля) | Поле channel удалено. Теперь эта информация является частью reporting_context . |
statistics | stats | Объект statistics переименован в stats . Имена полей в нём преобразуются в формат snake_case, например, activeCount теперь называется active_count . |
itemLevelIssues.servability | item_level_issues.severity | Перечисление servability заменяется перечислением severity для описания влияния проблемы. |
itemLevelIssues.attributeName | item_level_issues.attribute | Поле attributeName переименовано в attribute . |
itemLevelIssues.documentation | item_level_issues.documentation_uri | Поле documentation переименовано в documentation_uri . |
itemLevelIssues.numItems | item_level_issues.product_count | Поле numItems переименовано в product_count . |