Вы можете использовать ресурс accountstatuses
чтобы просмотреть состояние вашей учетной записи Merchant Center или MCA (многоклиентской учетной записи) и всех связанных с ней дочерних учетных записей.
Продавцы, у которых есть несколько интернет-магазинов или бренды, которые продаются на отдельных веб-сайтах, могут выбрать субаккаунты в рамках MCA.
Продавцы несут ответственность за соблюдение правил в отношении товарных объявлений и бесплатных объявлений . Google Shopping оставляет за собой право обеспечивать соблюдение этих правил и соответствующим образом реагировать, если мы обнаружим контент или поведение, нарушающие эти правила.
Подробную информацию о распространенных проблемах с учетной записью см. в разделе «Проблемы с учетной записью».
accountstatuses.get
Вы можете использовать accountstatuses.get
для просмотра информации о состоянии счета для одного торгового счета.
Вы можете использовать параметр destination
чтобы контролировать, какие проблемы с продуктом будут возвращены. Если пункт назначения не указан, ответ по умолчанию включает статусы destination: Shopping
.
Ниже приведен пример запроса, где merchantId
— это идентификатор учетной записи MCA, а accountId
— это дочерняя учетная запись этого MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Чтобы получить информацию о статусе отдельной учетной записи, вызовите accountstatuses.get
с тем же идентификатором учетной записи для merchantId
и accountId
.
Этот метод возвращает проблемы на уровне учетной записи и элемента. Вы можете использовать ресурсы «Товарные объявления» и «Бесплатные предложения» , чтобы исправить accountLevelIssues
, возвращаемые в ответе от accountstatuses.get
.
Ниже приведен пример ответа для дочернего аккаунта, который был заблокирован из-за нарушения "целевая страница не работает".
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"numItems": "5"
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"numItems": "3"
}
]
}
]
}
accountstatuses.list
Вы можете использовать accountstatuses.list
для просмотра информации о состоянии учетной записи на всех суб-аккаунтах вашего MCA.
Вы можете использовать фильтры с accountstatuses.list
для фильтрации проблем с продуктом по месту назначения. Если пункт назначения не указан, в ответе будут указаны статусы destination: Shopping
.
Ниже приведен пример запроса на получение информации о состоянии учетной записи для всех дочерних учетных записей с merchantId
MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Вот пример ответа:
{
"kind": "content#accountstatusesListResponse",
"resources": [
{
"kind": "content#accountStatus",
"accountId": "1234567",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
},
{
"kind": "content#accountStatus",
"accountId": "123456789",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
]
}
Вызов accountstatuses.list
для учетной записи, не относящейся к MCA (например, отдельной учетной записи Merchant Center), возвращает ошибку 403
.
Вот пример ответа на вызов accountstatuses.list
для отдельной учетной записи:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "forbidden",
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
],
"code": 403,
"message": "111111111 is not a multi-client account (MCA). The only account
service operations allowed on non-MCAs are 'get', 'update',
'authinfo' and 'claimwebsite'."
}
}
Пакетный режим
accountstatuses.custombatch
с методом GET
возвращает информацию о состоянии учетной записи для нескольких дочерних учетных записей в многоклиентской учетной записи.
Запрос JSON включает в себя merchantId
номера счета MCA, accountId
дополнительной учетной записи, уникальный batchId
и method
, установленный для get
.
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Ниже приведен пример тела запроса в формате JSON:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
Ниже приведен пример тела ответа JSON:
{
"kind": "content#accountstatusesCustomBatchResponse",
"entries": [
{
"batchId": 9,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1212121212",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "home_page_issue",
"title": "Website URL not provided",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/176793"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
},
{
"batchId": 99,
"accountStatus": {
"kind": "content#accountStatus",
"accountId": "1313131313",
"websiteClaimed": true,
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "0",
"expiring": "0"
}
}
]
}
}
]
}
Протестируйте ресурс «Состояния учетных записей»
В следующем примере мы получаем, перечисляем и получаем статус учетной записи custombatch.get
для учетных записей MCA:
Получите статус суб-аккаунта для MCA с помощью
accountstatuses.get
.Получите
merchantId
иaccountId
, выполнивGET
к конечной точке API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
В случае успеха вы должны получить код состояния
HTTP 200
и список состояний учетной записи в формате JSON.
Просмотрите все статусы дочерних учетных записей MCA с помощью
accountstatuses.list
.Выполните GET к конечной точке API с вашим
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
В случае успеха вы должны получить код состояния
HTTP 200
и список состояний учетной записи в формате JSON для отправленногоmerchantId
.
Просмотрите несколько субаккаунтов для MCA в пакетном режиме с помощью
accountstatuses.custombatch
.Создайте действительный JSON, используя свой
accountID
,merchant ID
и методget
.Выполните POST для конечной точки API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
В случае успеха вы должны получить код состояния
HTTP 200
и список состояний учетной записи в формате JSON.