Você pode usar o
accountstatuses
recurso para conferir o status das transações
central ou uma MCA (conta de múltiplos clientes) e todas as subcontas associadas
a ele.
Comerciantes que têm várias marcas ou lojas on-line vendidas em separado os sites podem ter subcontas em uma MCA.
Os comerciantes são responsáveis por obedecer à Política de preços anúncios e sem custo financeiro de fichas de empresas. Google O Shopping se reserva o direito de aplicar essas políticas e responder de maneira adequada. se encontrarmos conteúdo ou comportamento que viole essas políticas.
Consulte a referência de Problemas da conta. para detalhes sobre problemas comuns na conta.
accountstatuses.get
Você pode usar accountstatuses.get
para ver as informações de status da conta de um
uma única conta de comerciante.
Use o parâmetro destination
para controlar quais problemas do produto são
são retornadas. Quando um destino não é especificado, a resposta padrão inclui
status para destination: Shopping
.
Este é um exemplo de solicitação, em que merchantId
é o ID da conta da MCA e
accountId
é uma subconta dessa MCA:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Para receber informações sobre o status de uma conta independente, chame
accountstatuses.get
com o mesmo ID da conta para merchantId
e accountId
.
Esse método retorna problemas no nível da conta e do item. Você pode usar a Central de
anúncios e Sem custo financeiro
de fichas de empresa
accountLevelIssues
retornado na resposta de accountstatuses.get
.
Este é um exemplo de resposta para uma subconta que foi suspensa por um motivo página não funciona" violação.
{
"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
Você pode usar accountstatuses.list
para ver as informações de status da conta em todos
subcontas da 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.
no 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,
conta independente do Merchant Center) retorna um erro 403
.
Confira um exemplo de resposta para chamar accountstatuses.list
para um comando independente
conta:
{
"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 a conta
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, obtemos, listamos e custombatch.get
o status da conta para
MCA:
Confira o status da subconta de uma MCA usando
accountstatuses.get
.Acesse o
merchantId
e oaccountId
executando umGET
para a API endpoint:GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
Você receberá um código de status
HTTP 200
quando a operação for concluída. lista de status 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ê receberá um código de status
HTTP 200
quando a operação for concluída. lista de status em JSON para omerchantId
enviado.
Ver várias subcontas da MCA no modo em lote usando
accountstatuses.custombatch
:Criar um JSON válido usando
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
quando a operação for concluída. lista de status em JSON.