Status da conta

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

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

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

Consulte a referência de problemas da conta para mais detalhes sobre problemas comuns.

accountstatuses.get

É possível usar accountstatuses.get para conferir as informações de status de uma única conta de comerciante.

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

Confira um exemplo de solicitação em que merchantId é um ID de conta de MCA e accountId é uma subconta dessa MCA:

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

Para receber informações de status de uma conta independente, chame accountstatuses.get com o mesmo ID de conta para merchantId e accountId.

Esse método retorna problemas de conta e de item. É possível usar os recursos de anúncios do Shopping e listagens sem custo financeiro para corrigir accountLevelIssues retornados na resposta de accountstatuses.get.

Confira um exemplo de resposta para uma subconta que foi suspensa por uma violação de "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 conferir as informações de status de 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 em merchantId da MCA:

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 de uma conta que não é MCA (por exemplo, uma conta independente do Merchant Center) retorna um erro 403.

Confira um exemplo de resposta para chamar accountstatuses.list de 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 em 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 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 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
    }
  ]
}

Confira um exemplo de corpo JSON de resposta:

{
 "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 de status da conta

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

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

    1. Receba 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ê vai receber um código de status HTTP 200 para sucesso e a lista de status da conta em JSON.

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

    1. Execute 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. Conferir várias subcontas de MCA no modo em lote usando accountstatuses.custombatch.

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

    2. Execute 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.