Status da conta

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:

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

    1. Consiga merchantId e accountId executando um GET para o 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 a conclusão e a lista de status da conta em JSON.

  2. Confira o status de todos os subcontas de uma MCA usando accountstatuses.list.

    1. Execute GET no endpoint da API com merchantId:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      
    2. Você receberá um código de status HTTP 200 para a conclusão e a lista de status da conta em JSON para o merchantId enviado.

  3. Veja várias subcontas para a MCA no modo de lote usando accountstatuses.custombatch.

    1. Crie um JSON válido usando 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 a conclusão e a lista de status da conta em JSON.