Status da conta

Use o recurso accountstatuses para conferir o status da sua conta do Merchant Center ou de uma MCA (conta de múltiplos clientes) e todas as subcontas associadas a ela.

Comerciantes que têm várias lojas ou marcas on-line vendidas em sites separados podem ter subcontas em uma MCA.

Os comerciantes são responsáveis por obedecer às políticas de anúncios do Shopping e listagens sem custo financeiro. O Google Shopping se reserva o direito de aplicar essas políticas e responder adequadamente se encontrarmos conteúdo ou comportamento que as viole.

Consulte a referência Problemas com a conta para detalhes sobre problemas comuns.

accountstatuses.get

Você pode usar accountstatuses.get para conferir as informações de status de uma única conta do comerciante.

Use 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.

Confira 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 receber 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. Use os recursos Anúncios do Shopping e Listagens sem custo financeiro para corrigir accountLevelIssues retornado na resposta de accountstatuses.get.

Confira um exemplo de resposta para uma subconta suspensa por uma violação de "página de destino não funcionando".

{
 "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 informações de status em todas as subcontas da sua MCA.

Você pode 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.

Confira um exemplo de solicitação para receber informações de 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 o accountstatuses.list de uma conta que não é da MCA (por exemplo, uma conta independente do Merchant Center) retorna um erro 403.

Confira um exemplo de resposta para chamar accountstatuses.list em 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 da conta para várias subcontas em uma conta de múltiplos clientes.

O JSON da solicitação inclui o merchantId do número da conta 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

Confira abaixo um exemplo de corpo JSON da solicitação:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

Confira 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 "Account Statuses"

No exemplo a seguir, vamos receber, listar e custombatch.get o status da conta para contas da MCA:

  1. Receba o status da subconta de uma MCA usando accountstatuses.get.

    1. Para receber o merchantId e o accountId, faça um GET no endpoint da API:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

    2. Você vai receber um código de status HTTP 200 para sucesso e a lista de status da conta em JSON.

  2. Confira o status de todas as subcontas de uma MCA usando accountstatuses.list.

    1. Faça um GET no 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.

  3. Veja várias subcontas da MCA no modo em lote usando accountstatuses.custombatch.

    1. Crie um JSON válido usando accountID, merchant ID e um método get.

    2. Faça um POST no endpoint da API:

      POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

    3. Você vai receber um código de status HTTP 200 para sucesso e a lista de status da conta em JSON.