Status dos produtos

Você pode usar o recurso productstatuses para conferir o status detalhado dos seus produtos do Shopping.

Consulte problemas do produto para mais detalhes sobre problemas comuns.

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.

Requisitos

Para conferir o status dos produtos, faça o seguinte:

  • Inscreva sua conta em um destino.
  • Forneça um código de país válido em uma das seguintes opções:
    • 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.

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

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 expiração do produto.
  • productId: o ID REST do produto.
  • title: o título do produto.
  • link: o link do 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.

Use os seguintes parâmetros para refinar sua consulta:

  • destinations: o destino para conferir os status.
  • pageToken: usado para receber as páginas subsequentes de resultados. 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 teste 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 Comprar com o Google.
  • surfaces across google: produtos das listagens sem custo financeiro.
  • shopping: produtos de 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: dá 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.