Obtenir les status de vos offres de produits

Remarque

La ressource ProductStatuses est disponible uniquement pour les participants bêta fermés. Pour plus d’informations sur la participation au programme bêta fermé ou open-beta, contactez votre responsable de compte.

Tous les éléments de programmation du Store et la documentation sont susceptibles d’être modifiés pendant la version bêta.

Pour obtenir la liste des offres de produits de votre magasin dont le status est défini sur Désapprouve ou Avertissement, utilisez le modèle Obtenir les états des produits.

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

Le corps de la réponse est un objet ProductStatuses . Si le magasin ne contient pas de produits avec des états Désapprouvés ou Avertissement, le resources champ contient un tableau vide.

{
  "resources": []
}

Voici à quoi ressemble la réponse lorsque les produits ont leur status défini sur Avertissement et Désapprobé. Le itemLevelIssues champ contient la liste des problèmes que vous devez résoudre.

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

Par défaut, la demande retourne un maximum de 25 offres. Pour retourner un nombre différent d’offres, incluez le paramètre de requête 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"

Si le nombre d’offres avec leur status défini sur Désapprobé ou Avertissement est supérieur au nombre maximal de résultats, la réponse contient le nextPageToken champ .

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

Pour obtenir la page suivante des offres, incluez le paramètre de requête continuation-token dans votre prochain appel et définissez-le sur le jeton.

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

Le modèle d’appel consiste généralement à appeler ce modèle dans une boucle jusqu’à ce que la réponse n’inclue pas le nextPageToken champ.

Obtention d’un récapitulatif status nombre d’offres de produits

La ressource ProductStatuses offre une vue récapitulative des status d’offres de produits dans un magasin. L’affichage signale les offres approuvées et désapprouvées, ainsi que les offres en attente de révision ou sur le point d’expirer.

Pour demander une vue récapitulative, utilisez le modèle d’affichage résumé. Définissez {merchantId} sur l’ID du magasin à partir duquel vous souhaitez obtenir la vue.

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 réponse est un objet ProductStatusesSummary .

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

Lorsque la status d’une offre change, la vue récapitulative peut prendre jusqu’à deux heures.