Ottenere lo stato delle offerte dei prodotti

Nota

La risorsa ProductStatuses è disponibile solo per i partecipanti con beta chiusa. Per informazioni sulla partecipazione al programma closed-beta o open beta, contattare il proprio account manager.

Tutti gli elementi di programmazione e la documentazione dello Store sono soggetti a modifiche durante la versione beta.

Per ottenere un elenco delle offerte di prodotti nel tuo negozio con lo stato impostato su Non approvato o Avviso, usa il modello Ottieni stato prodotto.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses

Il corpo della risposta è un oggetto ProductStatuses . Se lo store non contiene prodotti con stato Non approvato o Avviso, il resources campo contiene una matrice vuota.

{
  "resources": []
}

Ecco l'aspetto della risposta quando lo stato dei prodotti è impostato su Avviso e Non approvato. Il itemLevelIssues campo contiene l'elenco dei problemi da risolvere.

{
  "resources": [
    {
      "productId": "online:en:CA:9",
      "title": "Slip Resistant - Shoes For Crews...",
      "status": "Warning",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "GtinPlusBrandRequiredWarn",
          "description": "Missing one or more identifiers - The Brand and GTIN or Brand and MPN are required.",
          "servability": "Unaffected"
        }
      ]
    },

    . . .

    {
      "productId": "online:en:CA:7",
      "title": "No Slip - Shoes For Crews...",
      "status": "Disapproved",
      "creationDate": "2018-10-08T07:38:00Z",
      "lastUpdateDate": "2020-09-29T14:35:54Z",
      "expirationDate": "2020-10-29T14:35:54Z",
      "itemLevelIssues": [
        {
          "code": "EVRejectedErr",
          "description": "The offer was rejected by the external validation component: EV.",
          "servability": "Disapproved"
        },
        {
          "code": "EV_39",
          "description": "Trademark content",
          "servability": "Disapproved"
        }
      ]
    }
  ]
}

Per impostazione predefinita, la richiesta restituisce un massimo di 25 offerte. Per restituire un numero diverso di offerte, includere il parametro di query max-results .

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5"

Se il numero di offerte con stato impostato su Non approvato o Avviso è maggiore del numero massimo di risultati, la risposta contiene il nextPageToken campo .

{
  "nextPageToken": "W3sidG9rZW4iOm51bGwsInJhbmdlIjp7Im1pbiI6IjA1QzFFNTNEMUYwRjg2IiwibWF4IjoiMDVDMUU1NUIyRDk3NEEifX1d",
  "resources": [...]
}

Per ottenere la pagina successiva delle offerte, includere il parametro di query del token di continuazione nella chiamata successiva e impostarlo sul token.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  "https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatuses?max-results=5&continuation-token=W3sidG9rZW4iOm..."

Il modello di chiamata in genere consiste nel chiamare questo modello in un ciclo fino a quando la risposta non include il nextPageToken campo .

Ottenere i conteggi di riepilogo dello stato delle offerte di prodotto

La risorsa ProductStatuses offre una visualizzazione riepilogativa dello stato delle offerte di prodotti in un negozio. I report di visualizzazione approvano e non approvano le offerte insieme alle offerte in sospeso o che stanno per scadere.

Per richiedere una visualizzazione di riepilogo, usare il modello di visualizzazione di riepilogo. Impostare {merchantId} sull'ID dell'archivio da cui si vuole visualizzare la visualizzazione.

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345/productstatusessummary

La risposta è un oggetto ProductStatusesSummary .

{
  "merchantId":12345,
  "approved":189,
  "expiring":14,
  "disapproved":3,
  "pending":10
}

Quando lo stato di un'offerta cambia, potrebbero essere necessarie fino a due ore prima che la visualizzazione di riepilogo rifletta la modifica.