Esta página foi traduzida pela API Cloud Translation.

Status da conta

É 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.
1. Consiga o merchantId e o accountId executando um GET no endpoint da API:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. 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.
1. Execute um GET para o endpoint da API com seu merchantId:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Você vai receber um código de status HTTP 200 para sucesso e a lista de status da conta em JSON para o merchantId enviado.
Veja várias subcontas da MCA no modo em lote usando accountstatuses.custombatch.
1. Crie um JSON válido usando os métodos accountID, merchant ID e get.
2. Execute um POST para o endpoint da API:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Você receberá um código de status HTTP 200 para êxito e a lista de status da conta em JSON.