Изменился способ получения информации о проблемах на уровне аккаунта, которые могут повлиять на ваши товары и состояние аккаунта. По сравнению с ресурсом accountstatuses
в Content API for Shopping, в Merchant API появился специальный ресурс AccountIssue
, предоставляющий более структурированную и подробную информацию.
Дополнительную информацию об использовании новой функции см. в руководстве по устранению неполадок в аккаунте .
Ключевые отличия
Ниже приведены основные улучшения и отличия в ресурсе Merchant API AccountIssue
:
- Выделенный ресурс: проблемы с аккаунтом — это отдельный ресурс. В Content API for Shopping проблемы на уровне аккаунта были вложенным полем в общем ресурсе
AccountStatus
. В Merchant API вы можете перечислить их напрямую с помощью методаaccounts.issues.list
. - Структурированные данные о влиянии: ресурс
AccountIssue
предоставляет подробное полеimpactedDestinations
. Это поле предоставляет чёткую разбивку влияния проблемы, включая пункт назначения (например, товарные объявления), конкретный регион и серьёзность проблемы в этом регионе. - Серьезность как перечисление: Поле
severity
теперь представляет собой перечисление (со значениями типаCRITICAL
,ERROR
,SUGGESTION
), что упрощает программную обработку по сравнению со строковыми значениями в Content API for Shopping. - Стандартизированные идентификаторы: каждая проблема с аккаунтом имеет уникальное полное
name
ресурса в форматеaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}
. Этот стандартизированный подход заменяет строкуid
из Content API for Shopping. - Поддержка локализации: метод
accounts.issues.list
позволяет указатьlanguage_code
для получения информации о проблеме, такой как название и описание, на предпочитаемом вами языке. В Content API for Shopping это было невозможно. - Расширенное поведение аккаунта: при вызове метода
accounts.issues.list
для расширенного аккаунта возвращаются только проблемы, относящиеся непосредственно к этому аккаунту. Метод не возвращает проблемы для каких-либо его дочерних аккаунтов. В Content API for Shopping методaccountstatuses.list
возвращает статусы всех дочерних аккаунтов. Чтобы получить информацию о проблемах для всех дочерних аккаунтов в Merchant API, необходимо вызвать методaccounts.listSubaccounts
, а затем — методaccounts.issues.list
для каждого дочернего аккаунта отдельно.
Запросы
В Merchant API вы можете составить список проблем с определенным аккаунтом Merchant Center.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues
Запросить сравнение URL
Запросить описание | API контента для покупок | API торговца |
---|---|---|
Список проблем на уровне учетной записи для одной учетной записи | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} | GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues |
Список проблем на уровне учетной записи для всех дочерних учетных записей расширенной учетной записи | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses | Недоступно. Необходимо выполнить итерацию по субсчетам. |
Идентификаторы
В Merchant API изменились идентификаторы счетов и проблем.
Сравнение идентификаторов
Описание идентификатора | API контента для покупок | API торговца |
---|---|---|
Идентификатор счета | {MERCHANT_ID} и {ACCOUNT_ID} в качестве параметров пути. | {ACCOUNT_ID} как параметр пути в формате accounts/{ACCOUNT_ID} . |
Идентификатор проблемы | поле id в теле ответа (например, "products-that-enable-dishonest-behavior-hacking-policy" ). | поле name в теле ответа, которое представляет собой полное имя ресурса (например, accounts/12345/issues/example-issue-id ). |
Методы
Методы устранения проблем со счетами были объединены и упрощены в Merchant API.
Сравнение методов
API контента для покупок | API торговца | Доступность и примечания |
---|---|---|
accountstatuses.get | accounts.issues.list | Доступно. Чтобы получить список задач по одной учётной записи, используйте метод accounts.issues.list и укажите идентификатор учётной записи. В API продавца нет метода get для одной задачи. |
accountstatuses.list | Прямого эквивалента нет. | Недоступно. Метод accounts.issues.list в Merchant API возвращает только задачи для указанного счёта, но не для его дочерних счётов. Чтобы получить задачи для всех дочерних счётов, необходимо сначала вызвать accounts.listSubaccounts , а затем — accounts.issues.list для каждого дочернего счёта. |
accountstatuses.custombatch | Прямого эквивалента нет. | Недоступно. Пакетная обработка проблем со счетами в API Merchant не поддерживается. Необходимо выполнять отдельные запросы к list для каждого счета. |
Подробные изменения полей
Поля в ресурсе по выпуску счета были обновлены для обеспечения большей структурированности и ясности.
Сравнение полей
API контента для покупок | API торговца | Описание |
---|---|---|
accountLevelIssues (массив в AccountStatus ) | accountIssues (массив в ListAccountIssuesResponse ) | Проблемы теперь представляют собой выделенный ресурс верхнего уровня, а не вложенное поле. |
id (строка) | name (строка) | Идентификатор проблемы теперь представляет собой полное имя ресурса, например accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} . |
title (строка) | title (строка) | Никаких изменений. |
detail (строка) | detail (строка) | Никаких изменений. |
documentation (строка) | documentationUri (строка) | Поле переименовано для ясности, чтобы указать, что это URL. |
severity (строка) | severity (перечисление) | Теперь уровень серьезности представляет собой структурированное перечисление ( CRITICAL , ERROR , SUGGESTION ), а не строку. |
country (строка), destination (строка) | impactedDestinations (повторяющееся сообщение) | Информация о воздействии теперь структурирована в виде списка, в котором сгруппированы пункт назначения, регион и уровень серьёзности для каждой затронутой области. Поле country в сообщении Impact заменено на regionCode . |
(Нет в наличии) | language_code , time_zone (параметры запроса) | Новые параметры в запросе list позволяют локализовать поля, удобные для чтения человеком, такие как title и detail . |