Comment obtenir l’état des offres de produits ?

  • Article

Lorsque vous ajoutez ou mettez à jour une offre de produit dans un catalogue ou un magasin, l’offre fait l’objet d’une validation initiale avant d’effectuer une révision éditoriale. Ce processus peut prendre jusqu’à 36 heures. Pour voir si l’offre a réussi le processus de révision, utilisez la ressource État .

Remarque

Pour obtenir la liste des produits dont la status est définie sur Désapprouvée ou Avertissement, consultez Obtenir les status de vos offres de produits.

Voici l’URI de base que vous utilisez pour obtenir la Status ressource.

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

Pour obtenir la status des offres de produits, ajoutez le modèle suivant à l’URI de base.

{bmcMerchantId}/catalogs/{catalogId}/status

Définissez {bmcMerchantId} sur votre ID de magasin BMC et sur {catalogId} l’ID du catalogue qui contient les offres de produits dont vous souhaitez obtenir les status.

Chaque requête HTTP doit inclure le jeton d’accès OAuth de l’utilisateur et votre jeton de développeur. Pour spécifier le jeton d’accès de l’utilisateur, définissez l’en-tête AuthenticationToken . Pour spécifier votre jeton de développeur, définissez l’en-tête DeveloperToken .

Si vous gérez des catalogues pour le compte d’autres clients, vous devez définir :

  • En-tête CustomerId de l’ID client du client dont vous gérez le magasin.
  • En-tête CustomerAccountId de l’ID de compte de l’un des comptes du client que vous gérez (peu importe le compte géré).

Vous n’avez pas besoin de spécifier le jeton d’accès ou le jeton de développeur pour télécharger le rapport ; il vous suffit de les spécifier pour obtenir les status.

Par défaut, l’API de contenu utilise des objets JSON pour représenter les status. Pour utiliser du code XML, définissez le paramètre de requête alt sur XML.

Envoyez une requête HTTP GET à l’URL obtenue. La réponse contient un objet Status qui contient le nombre d’offres qui ont passé ou échoué le processus de révision au cours des 30 derniers jours. Si une offre a échoué à la révision, la Status ressource inclut une URL que vous pouvez utiliser pour télécharger un rapport décrivant la raison de l’échec de l’offre.

L’exemple suivant montre un exemple Status d’objet.

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

Le rapport identifie l’offre qui a échoué, mais ne fournit pas les informations de timestamp ou de contrôle de version que vous pouvez utiliser pour identifier les mises à jour auxquelles le rapport fait référence. Par exemple, si vous avez chargé une offre il y a 2 jours, puis l’avez mise à jour hier, vous ne savez pas si le problème est lié à la version chargée il y a 2 jours ou à celle chargée hier. Toutefois, vous pouvez utiliser les attributs de l’élément dans la colonne Extrait de code d’offre du rapport pour déduire la version de l’élément qui est signalée.

Étant donné que le fichier de rapport est compressé zip, vous devez décompresser le fichier pour lire le rapport. Il n’existe aucune limite au nombre de rapports que le système peut stocker ; Toutefois, la durée de stockage des rapports n’est pas définie. Pour plus d’informations sur le contenu du rapport, consultez Format du rapport.

Selon l’activité associée au catalogue, le rapport peut être volumineux. Vous ne devez pas demander le rapport plus fréquemment que nécessaire. L’intervalle recommandé n’est pas plus d’une fois par heure.

Pour obtenir un exemple de code qui montre comment obtenir les status du catalogue et télécharger le rapport, consultez Téléchargement du rapport d’état du catalogue.

Voici un exemple de rapport.

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