Abrufen der status Ihrer Produktangebote

Hinweis

Die ProductStatuses-Ressource ist nur für Teilnehmer mit geschlossener Beta verfügbar. Für Informationen zur Teilnahme am Closed-Beta- oder Open-Beta-Programm wenden Sie sich bitte an Ihren Account Manager.

Alle Store-Programmierelemente und -dokumentationen können während der Betaversion geändert werden.

Um eine Liste der Produktangebote in Ihrem Store abzurufen, deren status auf Abgelehnt oder Warnung festgelegt ist, verwenden Sie die Vorlage Produktstatus abrufen.

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

Der Antworttext ist ein ProductStatuses-Objekt . Wenn der Store keine Produkte mit dem Status "Abgelehnt" oder "Warnung" enthält, enthält das resources Feld ein leeres Array.

{
  "resources": []
}

So sieht die Antwort aus, wenn die status für Produkte auf Warnung und Ablehnung festgelegt sind. Das itemLevelIssues Feld enthält die Liste der Probleme, die Sie beheben sollten.

{
  "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"
        }
      ]
    }
  ]
}

Standardmäßig gibt die Anforderung maximal 25 Angebote zurück. Um eine andere Anzahl von Angeboten zurückzugeben, schließen Sie den Abfrageparameter max-results ein.

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"

Wenn die Anzahl der Angebote, deren status auf Abgelehnt oder Warnung festgelegt ist, größer als max-results ist, enthält die Antwort das nextPageToken Feld.

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

Um die nächste Seite mit Angeboten zu erhalten, schließen Sie den Abfrageparameter continuation-token in Ihren nächsten Aufruf ein, und legen Sie ihn auf das Token fest.

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

Das typische Aufrufmuster besteht darin, diese Vorlage in einer Schleife aufzurufen, bis die Antwort das nextPageToken Feld nicht enthält.

Abrufen einer Zusammenfassung status Anzahl von Produktangeboten

Die Ressource ProductStatuses bietet eine Zusammenfassungsansicht der status von Produktangeboten in einem Geschäft. Die Ansicht meldet genehmigte und nicht genehmigte Angebote sowie Angebote, die noch ausstehen oder ablaufen.

Um eine Zusammenfassungsansicht anzufordern, verwenden Sie die Zusammenfassungsansichtsvorlage. Legen Sie {merchantId} auf die ID des Speichers fest, aus dem Die Ansicht stammen soll.

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

Die Antwort ist ein ProductStatusesSummary-Objekt .

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

Wenn sich die status eines Angebots ändert, kann es bis zu zwei Stunden dauern, bis die Zusammenfassungsansicht die Änderung widerspiegelt.