Imaginons que vous souhaitiez obtenir des informations sur les produits actuellement disponibles dans votre compte. Plus particulièrement, vous souhaitez savoir si certains de vos produits présentent des problèmes qui doivent être résolus. Vous savez comment obtenir ces informations depuis Merchant Center, mais vous préférez configurer un système d'alerte automatique à l'aide de Content API. Dans ce guide, vous découvrirez la correspondance entre les informations sur le niveau de gravité des problèmes dans Content API et la hiérarchisation des problèmes dans le rapport de la section "Diagnostic" de Merchant Center.
Exemple d'interaction avec Content API
Afin de connaître les problèmes qui affectent vos produits, vous pouvez exécuter la requête Accountstatuses.get pour votre compte. Voici un exemple partiel de la ressource renvoyée :
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
Sous accountLevelIssues[].severity, vous voyez le niveau de gravité des erreurs liées à votre compte Merchant Center. Les erreurs présentant un niveau de gravité Critical [critique] entraînent la suspension du compte, ce qui vous empêche de diffuser vos produits.
Sous itemLevelIssues, vous voyez les erreurs liées aux produits qui peuvent entraîner des refus. Notez que itemLevelIssues[].numItems vous indique que deux articles de votre compte sont affectés par un problème de lien image non fonctionnel et que cinq articles présentent une erreur de page de destination.
Sous itemLevelIssues[].servability, vous pouvez vérifier si l'erreur entraîne le refus des produits concernés. Notez que les liens image non fonctionnels et les erreurs de page de destination entraînent le refus des produits.
Pour trouver tous les produits concernés et obtenir la liste complète des problèmes rencontrés par article, appelez la méthode Productstatuses.list. Les entrées renvoyées se présentent comme suit :
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
Vous disposez désormais d'informations sur les problèmes affectant les produits dans votre compte, mais il est difficile de déterminer à quel point il est important de les résoudre.
Dans notre exemple Productstatuses, vous pouvez utiliser itemLevelIssues[].servability pour savoir si une erreur vous empêche de diffuser le produit concerné sur Shopping Actions, dans les annonces Shopping ou dans l'inventaire sur propriétés Google.
Si itemLevelIssues[].servability est unaffected [non affecté], à l'instar de ambiguous_gtin, l'erreur n'empêche pas la diffusion de votre produit.
Cependant, si itemLevelIssues[].servability est disapproved [refusé], à l'instar de mobile_landing_page_crawling_not_allowed, il s'agit d'une erreur beaucoup plus grave, car vous ne pouvez pas diffuser votre produit tant qu'elle n'est pas résolue.
Dans notre exemple Accountstatuses, sous accountLevelIssues[].severity, la section Diagnostic de Merchant Center classe les problèmes en fonction de leur gravité et explique les différents niveaux de priorité.
Commencez par consulter le rapport :
En quoi les informations obtenues via Content API for Shopping sont-elles liées à celles présentées dans la section "Diagnostic" ? Quelles entrées correspondent à des problèmes qu'il faut résoudre au plus vite ? Quelles sont celles qui correspondent à des problèmes qu'il est utile, mais pas essentiel de résoudre ? Quels problèmes empêcheront la diffusion de vos produits dans vos annonces s'ils ne sont pas résolus ?
Comme le montrent ces exemples, la section "Diagnostic" fournit des informations sur le niveau de gravité des problèmes affectant les produits dans ce compte et le compte lui-même, tandis que Content API (via le service Accountstatuses) ne fournit que des informations sur le niveau de gravité des problèmes accountLevel.
Chaque source classe les problèmes en trois catégories selon leur niveau de gravité. En comprenant comment déterminer le niveau de gravité des problèmes renvoyés par les services associés aux états, vous pouvez identifier rapidement les problèmes les plus importants à traiter et ceux qui peuvent être ignorés sans incidence.
Hiérarchisation et niveau de gravité des problèmes
Dans la section "Diagnostic", les problèmes sont classés, selon leur niveau de gravité, dans l'une des catégories suivantes : erreurs, avertissements et notifications. Dans les tableaux du rapport, comme celui présenté ci-dessus, ces niveaux sont représentés par des images qui apparaissent dans la première colonne : 
pour les erreurs, 
pour les avertissements et 
pour les notifications.
Les erreurs entraînent la suspension du compte ou le refus des articles. Elles doivent être résolues le plus rapidement possible pour que les articles puissent s'afficher à nouveau dans les résultats.
Les avertissements sont susceptibles d'avoir un impact négatif sur les performances de vos annonces et d'entraîner, ultérieurement, une suspension de compte ou un refus de vos articles si les problèmes ne sont pas corrigés.
Les notifications sont des suggestions pour optimiser la qualité des données. La résolution de ces problèmes est recommandée, mais pas obligatoire.
Cependant, il n'est pas nécessaire d'accéder à Merchant Center pour savoir à quoi correspond chaque erreur.
Dans Content API, le champ accountLevelIssues[].severity dans les objets des ressources Accountstatuses fournit les mêmes informations sur le niveau de gravité. Ces champs peuvent contenir l'une des trois valeurs suivantes : critical, error et suggestion.
Chaque valeur correspond à un type de problème individuel dans la hiérarchisation de l'onglet "Diagnostic" :
| Niveau de gravité concernant la qualité des données (API) | Hiérarchisation des problèmes |
|---|---|
critical |
Erreur () |
error |
Avertissement () |
suggestion |
Notification () |
Ainsi, dans notre exemple Accountstatuses, le problème missing_ad_words_link vous indique que vous devez associer un compte Google Ads pour pouvoir diffuser des annonces, mais il n'affecte pas l'état d'approbation du produit dans votre base de données Merchant Center.
D'autre part, l'erreur editorial_and_professional_standards_destination_url_down_policy est beaucoup plus grave et entraîne la suspension immédiate de votre compte. Si vous participez aux programmes Shopping Actions ou Inventaire sur propriétés Google, ou si vous possédez un compte Google Ads associé, une erreur critical empêche immédiatement vos produits d'être diffusés sur Shopping Actions, dans les annonces Shopping ou dans l'inventaire sur propriétés Google.
Grâce à ces informations, plus besoin d'accéder à Merchant Center pour connaître la gravité des problèmes relatifs à vos produits. Vous pouvez désormais développer un programme d'alerte qui vous informera immédiatement des problèmes importants détectés ainsi que de problèmes moins graves au cas où vous souhaiteriez les corriger.