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

Способ получения сводной статистики по товарам и проблемам изменился. Функционал, ранее доступный в ресурсе accountstatuses в Content API для покупок, теперь выделен в отдельные ресурсы в Merchant API. В этом руководстве объясняется, как перевести вашу интеграцию на использование нового ресурса aggregateProductStatuses .

Примечание : В Merchant API проблемы на уровне учетной записи и агрегированные статусы товаров разделены. Также ознакомьтесь с нашим руководством по переходу от accountstatuses к проблемам учетных записей .

Ключевые отличия

Вот основные различия между функциями отображения статуса товара в Content API для покупок и Merchant API:

• Выделенные ресурсы : Ресурс accountstatuses из Content API для покупок теперь разделен. В 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 .