Перенести статусы аккаунтов в агрегированные статусы продуктов

Изменился способ получения агрегированной статистики товаров и информации о проблемах. Функциональность, ранее доступная в ресурсе 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 .