Champs Schema.org obligatoires et recommandes

Les propriétés incluses déterminent si les moteurs de recherche et les autres consommateurs comprennent la page. Cette consultation accepte un nom courant tel que Article, Product, Recipe ou FAQPage, puis renvoie immédiatement une liste pratique de champs. Elle distingue les propriétés généralement obligatoires des améliorations recommandées, emploie les noms canoniques et rejette clairement tout type inconnu afin qu'un processus automatisé ne poursuive jamais son exécution sur une supposition silencieuse.

Commencez par le type exact représenté par votre page

Les données structurées fonctionnent mieux lorsque le type choisi décrit le sujet principal de la page, et non un simple élément secondaire. Indiquez un type Schema.org comme Product pour un article vendu, Recipe pour des instructions culinaires, Article pour un contenu éditorial ou LocalBusiness pour une entreprise disposant d'une présence physique. La consultation ignore la casse et accepte également l'URL complète d'un type schema.org, ce qui est pratique lorsque la valeur provient d'un document JSON-LD existant. La réponse fournit le nom et l'URL canoniques avec deux listes ordonnées de propriétés. Si le nom ne figure pas dans le catalogue pris en charge, la capacité renvoie une erreur de saisie au lieu d'inventer une correspondance approchante. Dans une chaîne de publication, une faute comme Productt arrête donc la compilation au lieu de produire un balisage apparemment plausible, mais dépourvu de sens défini. Choisissez le type compatible le plus précis. Cette consultation couvre les types populaires des mises en œuvre SEO, et non toutes les classes du vocabulaire Schema.org complet.

Interprétez les champs comme une liste de mise en œuvre

Schema.org est un vocabulaire et n'impose pas universellement des propriétés comme le ferait un schéma de base de données. Les fonctionnalités de recherche, validateurs et autres consommateurs appliquent leurs propres critères d'admissibilité, susceptibles de varier selon la plateforme et la présentation. La liste obligatoire désigne donc les propriétés couramment considérées comme le minimum utile en SEO, tandis que les champs recommandés améliorent généralement l'exhaustivité, l'admissibilité ou la qualité du résultat affiché. Associez d'abord chaque propriété obligatoire à une information réelle et visible sur la page. Ajoutez ensuite les propriétés recommandées lorsque vous disposez de données fiables. N'inventez jamais une note, un prix, un auteur, une image, une disponibilité ou une date dans le seul but de remplir la liste. Un objet plus court et fidèle au contenu vaut mieux qu'un balisage riche contredisant ce que voient les visiteurs. Certaines propriétés contiennent des objets imbriqués, notamment offers pour Product, author pour Article, location pour Event et mainEntity pour FAQPage. La consultation nomme ces propriétés supérieures, mais ne génère pas leurs valeurs et ne valide pas un graphe JSON-LD complet.

Intégrez des résultats déterministes à vos contrôles

La consultation utilise un catalogue fixe en mémoire, sans réseau, modèle, hasard ni dépendance à l'heure. Un même type pris en charge produit donc toujours le même résultat ordonné. Elle convient aux audits reproductibles, générateurs de formulaires, modèles de schéma, scripts de migration et contrôles d'intégration continue. Un CMS peut demander la liste lorsqu'une personne chargée de l'édition choisit un type de contenu, signaler les entrées obligatoires manquantes et présenter séparément les améliorations recommandées. Un outil d'audit peut comparer les clés JSON-LD existantes à la réponse et relever les lacunes sans transformer chaque recommandation en erreur. Un générateur peut utiliser l'URL canonique tout en conservant l'ordre des champs dans une interface prévisible. Considérez le résultat comme un point de départ pratique et vérifiez la documentation actuelle de tout moteur de recherche dont les résultats enrichis sont essentiels, car ses règles particulières ne font pas partie de ce catalogue hors ligne. Une requête API coûte $0.002 et le navigateur utilise la même logique pure. Tout type non pris en charge produit volontairement une erreur avec le nom soumis et les choix admis.