Você pode 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
a ela.
Os comerciantes com várias lojas on-line ou marcas vendidas em sites diferentes podem 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 reserva-se o direito de aplicar essas políticas e responder adequadamente se encontrarmos conteúdo ou comportamento que viole essas políticas.
Consulte a referência Problemas da conta para ver detalhes sobre problemas comuns.
accountstatuses.get
É possível usar accountstatuses.get
para visualizar as informações de status de uma única conta do comerciante.
É possível usar o parâmetro destination
para controlar quais problemas de produtos 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 de conta da MCA e
accountId
é uma subconta dessa MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Para ver informações de status para uma conta independente, chame accountstatuses.get
com o mesmo ID para merchantId
e accountId
.
Esse método retorna problemas no nível da conta e do item. Use os recursos de anúncios
do Shopping e de Listagens
sem custo financeiro para corrigir
accountLevelIssues
retornado na resposta de accountstatuses.get
.
Veja um exemplo de resposta para uma subconta que foi suspensa por uma violação de "página de destino que 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
Use accountstatuses.list
para visualizar as informações de status da conta em todas
as subcontas da sua MCA.
É possível usar filtros com accountstatuses.list
para filtrar problemas de produtos por
destino. Quando um destino não é especificado, a resposta inclui status
para destination: Shopping
.
Veja a seguir um exemplo de solicitação para conferir o status de todas as subcontas
na 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 accountstatuses.list
em uma conta que não é de MCA (por exemplo, uma
conta independente do Merchant Center) retorna um erro 403
.
Veja 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 as informações de status de várias subcontas em uma conta de múltiplos clientes.
O JSON de solicitação inclui o merchantId
do número da conta 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, listamos e custombatch.get
o status da conta para
contas de MCA:
Confira o status da subconta de uma MCA usando
accountstatuses.get
.Consiga
merchantId
eaccountId
executando umGET
para o endpoint da API:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Você vai receber um código de status
HTTP 200
para a conclusão e a lista de status da conta em JSON.
Confira o status de todos os subcontas de uma MCA usando
accountstatuses.list
.Execute GET no endpoint da API com
merchantId
:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
Você receberá um código de status
HTTP 200
para a conclusão e a lista de status da conta em JSON para omerchantId
enviado.
Veja várias subcontas para a MCA no modo de lote usando
accountstatuses.custombatch
.Crie um JSON válido usando
accountID
,merchant ID
e um métodoget
.Execute um POST no endpoint da API:
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
Você vai receber um código de status
HTTP 200
para a conclusão e a lista de status da conta em JSON.