Переход из раздела «Состояния аккаунтов» в раздел «Проблемы с аккаунтами»

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