Partager via


Ressource d’état

La ressource Status vous permet d’obtenir les status des offres de produits que vous avez chargées dans le catalogue spécifié. Une fois que vous avez chargé des offres dans le catalogue, elles passent par un processus de validation et de révision éditoriale. Ce processus peut prendre jusqu’à 36 heures. L’offre n’est incluse dans le rapport qu’une fois le processus de révision terminé.

Pour obtenir une vue d’ensemble du fonctionnement du processus, consultez Comment obtenir l’état des offres de produits ?

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.

Base URI

Voici l’URI de base auquel vous ajoutez les modèles.

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

Modèles

Pour créer les points de terminaison utilisés pour obtenir les status d’offres de produits dans un catalogue, ajoutez le modèle approprié à l’URI de base.

Remarque

{bmcMerchantId}/catalogs/{catalogId}/status est déconseillé et nous vous déconseillons de l’utiliser.

Modèle Verbe HTTP Description Ressource
{bmcMerchantId}/catalogs/{catalogId}/status GET Utilisez pour obtenir le nombre d’offres chargées qui ont réussi ou échoué à la validation et à la révision éditoriale.

Définissez {bmcMerchantId} sur l’ID du magasin MMC.

Définissez {catalogId} sur l’ID du catalogue.
Demande : N/A
Réponse : État

Paramètres de requête

Les points de terminaison peuvent inclure les paramètres de requête suivants.

Paramètre Description
alt Facultatif. Utilisez pour spécifier le type de contenu utilisé dans la demande et la réponse. Les valeurs possibles sont json et xml. La valeur par défaut est json.

En-têtes

Voici les en-têtes de demande et de réponse.

En-tête Description
Accepter En-tête de la demande.<p>Inclure cet en-tête lorsque vous téléchargez le rapport. Vous devez définir cet en-tête sur application/x-zip-compressed.
AuthenticationToken En-tête de la demande.

Définissez cet en-tête sur un jeton d’authentification OAuth. Pour plus d’informations sur l’obtention d’un jeton, consultez Authentification de vos informations d’identification.
Emplacement du contenu En-tête de réponse.

URL qui identifie le magasin dans lequel le produit a été inséré. Cet en-tête est inclus dans la réponse d’une demande d’insertion.
CustomerAccountId En-tête de la demande.

ID de compte de l’un des comptes que vous gérez au nom du client spécifié dans l’en-tête CustomerId . Le compte que vous spécifiez n’a pas d’importance. Spécifiez cet en-tête uniquement si vous gérez un compte pour le compte du client.
Customerid En-tête de la demande.

ID client du client dont vous gérez le magasin. Spécifiez cet en-tête uniquement si vous gérez le magasin pour le compte du client. Si vous définissez cet en-tête, vous devez également définir l’en-tête CustomerAccountId .
DeveloperToken En-tête de la demande.

Jeton d’accès développeur de l’application cliente. Chaque demande doit inclure cet en-tête. Pour plus d’informations sur l’obtention d’un jeton, consultez Avez-vous vos informations d’identification Microsoft Advertising et votre jeton de développeur ?
Emplacement En-tête de réponse.

URL qui identifie le magasin dans lequel le produit a été inséré. Cet en-tête est inclus dans la réponse d’une demande d’insertion.
WebRequestActivityId En-tête de réponse.

ID de l’entrée de journal qui contient les détails de la demande. Vous devez toujours capturer cet ID si une erreur se produit. Si vous n’êtes pas en mesure de déterminer et de résoudre le problème, incluez cet ID avec les autres informations que vous fournissez à l’équipe de support technique.

Objets de requête et de réponse

Voici les objets de requête et de réponse utilisés par l’API.

Chaque objet définit le nom de clé JSON et le nom d’élément XML que vous utilisez en fonction du type de contenu que vous avez spécifié pour la requête.

Objet Description
État Définit la status des offres de produits qui ont été chargées dans le catalogue.

Statut

Définit la status des offres de produits qui ont été chargées dans le catalogue. Le nom XML de l’objet est <catalogStatus>.

Nom Valeur Type Nom de l’élément XML
catalogId ID du catalogue signalé. ulong <catalog_id>
publishedCount Nombre d’offres ayant fait l’objet d’une validation et d’une révision éditoriale. ulong <published_count>
rejectedCount Nombre d’offres ayant échoué à la validation et à la révision éditoriale. Ce nombre indique le nombre de lignes dans le corps du rapport (voir Format du rapport). ulong <rejected_count>
rejectionReportUrl URL que vous utilisez pour télécharger le rapport. L’objet inclut ce champ uniquement lorsque rejectedCount est supérieur à zéro.

Le rapport est compressé et doit être décompressé avant de pouvoir le lire.
string <catalog_id>

Codes d’état HTTP

Les requêtes peuvent retourner les codes de status HTTP suivants.

Code d'état Description
200 Opération réussie.
400 Demande incorrecte Une valeur de paramètre de requête n’est pas valide ou l’URL du rapport (voir rejectionReportUrl) n’est plus valide.
401 Non autorisé Les informations d’identification de l’utilisateur ne sont pas valides.
404 Introuvable. Status n’est pas disponible pour le catalogue spécifié ou l’ID de catalogue ou de magasin n’est pas valide.
500 Erreur du serveur.

Format de rapport

Le fichier de rapport que vous téléchargez est contenu dans un dossier compressé Zip (*.zip). Vous devez décompresser le dossier et son contenu avant de pouvoir lire le rapport. Le rapport est un fichier délimité par des virgules nommé MerchantCatalogReport.csv.

Le rapport est divisé en une section d’en-tête et une section de corps de rapport. La première ligne contient les noms de colonnes suivants pour la section d’en-tête.

Nom de colonne Description
Nom du catalogue Nom du catalogue.
ID de catalogue ID du catalogue.
ID du magasin ID du magasin qui contient le catalogue.
Heure de chargement Ne pas utiliser. Si ce champ existe, ignorez-le.

La deuxième ligne contient les données d’en-tête.

La troisième ligne est vide.

La quatrième ligne contient les noms de colonnes suivants pour le corps du rapport, qui commence sur la cinquième ligne.

Nom de colonne Description
ID d’élément OfferId de l’offre qui a échoué à la validation ou à la révision éditoriale. Le rapport contient des ID uniques.
Message Erreur signalée.
Type Type d’erreur. Les valeurs possibles sont Error ou Warning.
Valeurs Valeur de données à l’origine de l’erreur, si l’erreur a été provoquée par une valeur non valide.
Extrait de l’offre Liste délimitée par des points-virgules de sous-ensemble des données de l’offre. Le format est le titre ; productType ; lien ; imageLink ; prix ; salePrice ; saleStartDate ; saleEndDate. Toutes les erreurs n’incluent pas tous les composants.

Pour obtenir un exemple de rapport, consultez Exemple de rapport.