Status dos produtos

Use o recurso productstatuses para conferir o status detalhado dos seus produtos do Shopping.

Consulte Problemas com produtos para mais detalhes sobre problemas comuns.

Os comerciantes são responsáveis por obedecer às políticas dos anúncios do Shopping e de 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.

Requisitos

Você precisa fazer o seguinte para conferir o status dos produtos:

  • Inscreva sua conta em um destino.
  • Forneça um código de país válido em um dos seguintes locais:
    • O campo feedLabel.
    • O campo shipping.
    • No nível do feed.
    • As configurações de frete da sua conta.

Conferir o status de um produto

Use productstatuses.get para conferir o status de um produto.

Você pode usar o destinations parâmetro nas solicitações get e list para conferir problemas de um destino específico. Se você não especificar um destino, os problemas de todos os destinos qualificados serão retornados.

Confira um exemplo de solicitação get, com parâmetros de consulta opcionais:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

Todas as respostas de productstatuses.get incluem os seguintes campos:

  • kind: o valor é sempre content#productStatus.
  • creationDate: a data em que o produto foi criado.
  • lastUpdateDate: a última vez que o produto foi atualizado.
  • googleExpirationDate: a data de validade do produto.
  • productId: o ID REST do produto.
  • title: o título do produto.
  • link: o URL do produto.
  • destinationStatuses: o status do produto em cada destino e país.

O campo itemLevelIssues só vai aparecer na resposta se o produto tiver problemas no nível do item no momento da sua solicitação.

Confira um exemplo de resposta JSON:

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "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",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

Listar todos os status de produtos

Use productstatuses.list para conferir todos os seus produtos e os status deles.

Você pode usar os seguintes parâmetros para refinar sua consulta:

  • destinations: o destino para o qual conferir os status.
  • pageToken: usado para receber as páginas de resultados subsequentes. Cada página tem um nextPageToken que pode ser usado para acessar a próxima página na sequência.
  • maxResults: o número máximo de resultados por página.

Confira um exemplo de solicitação list com parâmetros de consulta opcionais:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

Confira um exemplo de resposta JSON:

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

A chamada productstatuses.list é segura para testes em produção porque não faz mudanças nos seus dados.

Destinos

Confira os destinos que você pode usar para produtos do Shopping:

  • shopping ads: produtos dos anúncios do Shopping.
  • ShoppingActions: produtos do programa Comprar com o Google.
  • surfaces across google: produtos de listagens sem custo financeiro.
  • shopping: produtos dos anúncios de inventário local.

Problemas no nível do item

Cada problema no nível do item inclui os seguintes campos:

  • code: o código de erro usado para determinar o problema.
  • servability: indica se o produto é mostrado como:
    • disapproved: o problema impede que o produto seja mostrado.
    • unaffected: o produto ainda é mostrado.
  • resolution: informa se o comerciante pode resolver o problema.
  • attributeName: o nome do atributo afetado.
  • destination: o destino afetado.
  • description: a descrição do produto.
  • detail: fornece mais informações sobre o problema.
  • documentation: indica onde encontrar a documentação sobre o problema.
  • applicableCountries: indica em quais países o problema afeta o produto.