Como obtenho o Estado das Ofertas de Produto?

  • Artigo

Quando adiciona ou atualiza uma oferta de produto num catálogo ou loja, a oferta passa por uma validação inicial antes de passar por uma revisão editorial. Esse processo pode demorar até 36 horas. Para ver se a oferta passou no processo de revisão, utilize o recurso Estado .

Nota

Para obter uma lista dos produtos com o respetivo estado definido como Desaprovado ou Aviso, consulte Obter o estado das ofertas do produto.

Segue-se o URI base que utiliza para obter o Status recurso.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Para obter o estado das ofertas de produtos, acrescente o seguinte modelo ao URI base.

{bmcMerchantId}/catalogs/{catalogId}/status

Defina {bmcMerchantId} para o ID da loja BMC e defina {catalogId} como o ID do catálogo que contém as ofertas de produtos das quais pretende obter o estado.

Cada pedido HTTP tem de incluir o token de acesso OAuth do utilizador e o token de programador. Para especificar o token de acesso do utilizador, defina o cabeçalho AuthenticationToken . Para especificar o token do programador, defina o cabeçalho DeveloperToken .

Se gerir catálogos em nome de outros clientes, tem de definir:

Não precisa de especificar o token de acesso ou token de programador para transferir o relatório; só tem de especificá-los para obter o estado.

Por predefinição, a API de Conteúdo utiliza objetos JSON para representar o estado. Para utilizar XML, defina o parâmetro de consulta alt como XML.

Envie um pedido HTTP GET para o URL resultante. A resposta contém um objeto Estado que contém o número de ofertas que passaram ou falharam no processo de revisão nos últimos 30 dias. Se uma oferta falhou na revisão, o Status recurso inclui um URL que pode utilizar para transferir um relatório que descreve o motivo pela qual a oferta falhou.

Segue-se um objeto de exemplo Status .

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

O relatório identifica a oferta que falhou, mas não fornece as informações de controlo de versões ou carimbo de data/hora que pode utilizar para identificar a que atualizações o relatório se refere. Por exemplo, se carregou uma oferta há 2 dias e a atualizou ontem, não saberá se o problema está relacionado com a versão carregada há 2 dias ou a que foi carregada ontem. No entanto, poderá utilizar os atributos do item na coluna Fragmento de Oferta do relatório para inferir a versão do item que está a ser reportada.

Uma vez que o ficheiro de relatório é comprimido por ZIP, tem de deszipar o ficheiro para ler o relatório. Não existe limite para o número de relatórios que o sistema pode armazenar; no entanto, o período de tempo durante o qual os relatórios são armazenados é indefinido. Para obter informações sobre o conteúdo do relatório, consulte Formato do Relatório.

Dependendo da atividade associada ao catálogo, o relatório pode ser grande. Não deve pedir o relatório com mais frequência do que o necessário. O intervalo recomendado não é superior a uma vez por hora.

Para obter um exemplo de código que mostra como obter o estado do catálogo e transferir o relatório, veja Transferir o Relatório de Estado do Catálogo.

Segue-se um relatório de exemplo.

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"