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

Изменился способ получения информации о проблемах на уровне учетной записи, которые могут повлиять на ваши товары и состояние учетной записи. По сравнению с ресурсом accountstatuses в Content API для покупок, Merchant API представляет специальный ресурс AccountIssue , который предоставляет более структурированную и подробную информацию.

Для получения более подробной информации о том, как использовать новую функцию, см. руководство по просмотру проблем с учетной записью .

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

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

Вот основные улучшения и отличия ресурса AccountIssue в API продавца:

• Выделенный ресурс: Проблемы с учетными записями представляют собой отдельный ресурс. В Content API для покупок проблемы на уровне учетной записи были вложенным полем в общем ресурсе AccountStatus . С помощью Merchant API вы можете перечислить их напрямую, используя метод accounts.issues.list .
• Структурированные данные о влиянии: ресурс AccountIssue предоставляет подробное поле impactedDestinations . Это поле дает четкое представление о влиянии проблемы, включая целевой объект (например, товарные объявления), конкретный регион и серьезность проблемы в этом регионе.
• Уровень серьезности в виде перечисления: Поле severity теперь представляет собой перечисление (со значениями, такими как CRITICAL , ERROR , SUGGESTION ), что упрощает его программную обработку по сравнению со строковыми значениями в Content API для покупок.
• Стандартизированные идентификаторы: Каждая задача по учетным записям имеет уникальное полное name ресурса в формате accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} . Этот стандартизированный подход заменяет строку id из Content API для покупок.
• Поддержка локализации: метод accounts.issues.list позволяет указать language_code для получения сведений о задаче, таких как заголовок и описание, на предпочитаемом вами языке. В Content API для покупок это было невозможно.
• Поведение расширенной учетной записи: При вызове метода accounts.issues.list для расширенной учетной записи возвращаются только те проблемы, которые относятся непосредственно к этой учетной записи. Метод не возвращает проблемы для каких-либо ее дочерних учетных записей. В Content API для покупок метод accountstatuses.list возвращает статусы для всех дочерних учетных записей. Чтобы получить проблемы для всех дочерних учетных записей в Merchant API, необходимо вызвать accounts.listSubaccounts , а затем accounts.issues.list для каждой дочерней учетной записи по отдельности.

Запросы

В Merchant API можно просмотреть список проблем с учетной записью для конкретного аккаунта Merchant Center.

GET https://merchantapi.googleapis.com/accounts/v1/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/v1/accounts/{ACCOUNT_ID}/issues
Перечислите проблемы на уровне учетной записи для всех подотчетных записей расширенной учетной записи.	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Недоступно. Необходимо перебрать все дочерние учетные записи.

Идентификаторы

В 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 ).

Методы

В 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 продавца. Необходимо выполнять отдельные запросы list для каждой учетной записи.

Подробные изменения полей

Поля в ресурсе, описывающем проблему с учетной записью, были обновлены для обеспечения большей структурированности и ясности.

Полевое сравнение

API контента для покупок	API для продавцов	Описание
accountLevelIssues (массив в AccountStatus )	accountIssues (массив в ListAccountIssuesResponse )	Теперь раздел "Проблемы" является отдельным ресурсом верхнего уровня, а не вложенной областью.
id (строка)	name (строка)	Идентификатор задачи теперь представляет собой полное имя ресурса, например accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} .
title (строка)	title (строка)	Без изменений.
detail (строка)	detail (строка)	Без изменений.
documentation (строка)	documentationUri (string)	Для большей ясности поле переименовано, чтобы указать, что это URL-адрес.
severity (строка)	severity (перечисление)	Теперь уровень серьезности представляет собой структурированное перечисление ( CRITICAL , ERROR , SUGGESTION ) вместо строки.
country (строка), destination (строка)	impactedDestinations (повторяющееся сообщение)	Теперь информация о последствиях представлена ​​в виде списка, в котором для каждой затронутой области указаны место назначения, регион и степень серьезности. Поле country в сообщении Impact заменено на regionCode .
(Нет в наличии)	language_code , time_zone (параметры запроса)	Новые параметры в запросе list позволяют локализовать удобочитаемые поля, такие как title и detail .