Come si ottiene lo stato delle offerte di prodotto?

  • Articolo

Quando si aggiunge o si aggiorna un'offerta di prodotto in un catalogo o in un negozio, l'offerta passa attraverso una convalida iniziale prima di passare attraverso la revisione editoriale. Tale processo può richiedere fino a 36 ore. Per verificare se l'offerta ha superato il processo di revisione, usare la risorsa Stato .

Nota

Per ottenere un elenco dei prodotti con stato impostato su Non approvato o Avviso, vedere Ottenere lo stato delle offerte del prodotto.

Di seguito è riportato l'URI di base usato per ottenere la Status risorsa.

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

Per ottenere lo stato delle offerte di prodotto, aggiungere il modello seguente all'URI di base.

{bmcMerchantId}/catalogs/{catalogId}/status

Impostare sull'ID {bmcMerchantId} archivio BMC e sull'ID {catalogId} del catalogo che contiene le offerte di prodotto di cui si vuole ottenere lo stato.

Ogni richiesta HTTP deve includere il token di accesso OAuth dell'utente e il token di sviluppo. Per specificare il token di accesso dell'utente, impostare l'intestazione AuthenticationToken . Per specificare il token di sviluppo, impostare l'intestazione DeveloperToken .

Se si gestiscono cataloghi per conto di altri clienti, è necessario impostare:

  • L'intestazione CustomerId all'ID cliente del cliente di cui si sta gestendo il negozio.
  • L'intestazione CustomerAccountId sull'ID account di uno degli account del cliente gestiti dall'utente (non importa quale account gestito).

Non è necessario specificare il token di accesso o il token di sviluppo per scaricare il report. è sufficiente specificarli per ottenere lo stato.

Per impostazione predefinita, l'API Contenuto usa oggetti JSON per rappresentare lo stato. Per usare XML, impostare il parametro di query alt su XML.

Inviare una richiesta HTTP GET all'URL risultante. La risposta contiene un oggetto Status che contiene il numero di offerte passate o non riuscite nel processo di revisione negli ultimi 30 giorni. Se un'offerta non è riuscita, la Status risorsa include un URL che è possibile usare per scaricare un report che descrive il motivo per cui l'offerta non è riuscita.

Di seguito viene illustrato un oggetto di esempio Status .

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

Il report identifica l'offerta non riuscita, ma non fornisce le informazioni sul timestamp o sul controllo della versione che è possibile usare per identificare gli aggiornamenti a cui fa riferimento il report. Ad esempio, se hai caricato un'offerta 2 giorni fa e l'hai aggiornata ieri, non saprai se il problema è correlato alla versione caricata 2 giorni fa o a quella caricata ieri. Tuttavia, potrebbe essere possibile usare gli attributi dell'elemento nella colonna Frammento di offerta del report per dedurre la versione dell'elemento segnalata.

Poiché il file di report è compresso con zip, è necessario decomprimere il file per leggere il report. Non esiste alcun limite al numero di report che il sistema può archiviare; tuttavia, il periodo di tempo in cui vengono archiviati i report non è definito. Per informazioni sul contenuto del report, vedere Formato report.

A seconda dell'attività associata al catalogo, il report può essere di grandi dimensioni. Non è consigliabile richiedere il report più frequentemente del necessario. L'intervallo consigliato non è più di una volta all'ora.

Per un esempio di codice che illustra come ottenere lo stato del catalogo e scaricare il report, vedere Download del report sullo stato del catalogo.

Di seguito viene illustrato un report di esempio.

"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"