É possível usar o recurso
accountstatuses
para ver o status da sua conta do Merchant
Center ou de uma MCA (conta de múltiplos clientes) e todas as subcontas
associadas a ela.
Os comerciantes que têm várias lojas ou marcas on-line vendidas em sites diferentes podem optar por ter subcontas em uma MCA.
Os comerciantes são responsáveis por obedecer às políticas de anúncios do Shopping e de listagens sem custo financeiro. O Google Shopping se reserva o direito de aplicar essas políticas e responder adequadamente se encontrar conteúdo ou comportamento que viole essas políticas.
Consulte a referência de Problemas da conta para detalhes dos problemas comuns da conta.
accountstatuses.get
Você pode usar accountstatuses.get
para visualizar as informações de status de uma única conta do comerciante.
Use o parâmetro destination
para controlar quais problemas do produto são
retornados. Quando um destino não é especificado, a resposta padrão inclui
status para destination: Shopping
.
Veja um exemplo de solicitação, em que merchantId
é um ID da MCA e accountId
é uma subconta dessa MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Para ver informações sobre o status de uma conta independente, chame
accountstatuses.get
com o mesmo ID de conta para merchantId
e accountId
.
Esse método retorna problemas no nível da conta e do item. Você pode usar os recursos de anúncios
do Shopping e de listagens
sem custo financeiro para corrigir
accountLevelIssues
retornados na resposta de accountstatuses.get
.
Veja um exemplo de resposta para uma subconta que foi suspensa por uma violação "A página de destino não funciona".
{
"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
É possível usar accountstatuses.list
para consultar as informações de status da conta em todas as subcontas da sua MCA.
É possível usar filtros com accountstatuses.list
para filtrar problemas nos produtos por
destino. Quando um destino não é especificado, a resposta inclui status
para destination: Shopping
.
Confira um exemplo de solicitação para receber informações sobre o status de todas as subcontas da MCA merchantId
:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Veja um exemplo de resposta:
{
"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"
}
}
]
}
]
}
Uma chamada para o accountstatuses.list
de uma conta que não é da MCA (por exemplo, uma conta independente do Merchant Center) retorna um erro 403
.
Este é um exemplo de resposta para chamar accountstatuses.list
para uma conta
independente:
{
"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'."
}
}
Modo de lote
Um accountstatuses.custombatch
com um método GET
retorna informações de status de várias subcontas em uma conta de múltiplos clientes.
O JSON da solicitação inclui o merchantId
do número da MCA, o accountId
da subconta, um batchId
exclusivo e o method
definido como get
.
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Veja a seguir um exemplo de corpo JSON de solicitação:
{
"entries": [
{
"accountId": 1212121212,
"merchantId": 4444444444,
"method": "get",
"batchId": 9
},
{
"accountId": 1313131313,
"merchantId": 4444444444,
"method": "get",
"batchId": 99
}
]
}
Veja a seguir um exemplo de corpo de resposta 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"
}
}
]
}
}
]
}
Testar o recurso Status da conta
No exemplo a seguir, recebemos a lista e o status custombatch.get
das contas de MCA:
Confira o status da subconta de uma MCA usando
accountstatuses.get
.Consiga o
merchantId
e oaccountId
executando umGET
no endpoint da API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Você receberá um código de status
HTTP 200
para êxito e a lista de status da conta em JSON.
Veja o status de todos os status da subconta de uma MCA usando
accountstatuses.list
.Execute um GET para o endpoint da API com seu
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Você vai receber um código de status
HTTP 200
para sucesso e a lista de status da conta em JSON para omerchantId
enviado.
Veja várias subcontas da MCA no modo em lote usando
accountstatuses.custombatch
.Crie um JSON válido usando os métodos
accountID
,merchant ID
eget
.Execute um POST para o endpoint da API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Você receberá um código de status
HTTP 200
para êxito e a lista de status da conta em JSON.