Campos de tipos Schema.org: obligatorios y recomendados

Las propiedades incluidas determinan si los buscadores y otros consumidores pueden comprender la página. Esta consulta acepta nombres conocidos como Article, Product, Recipe o FAQPage y devuelve de inmediato una lista práctica de campos. Separa las propiedades habitualmente obligatorias de las mejoras recomendadas, utiliza nombres canónicos y rechaza claramente los tipos desconocidos para que los procesos automatizados nunca continúen a partir de una suposición silenciosa.

Empiece por el tipo exacto que representa su página

Los datos estructurados funcionan mejor cuando el tipo elegido describe el tema principal de la página y no solo un elemento secundario. Introduzca un tipo de Schema.org como Product para un artículo que se puede comprar, Recipe para instrucciones de cocina, Article para contenido editorial o LocalBusiness para un negocio con presencia física. La consulta no distingue mayúsculas de minúsculas y también acepta una URL completa del tipo en schema.org, algo práctico cuando el valor procede de un documento JSON-LD existente. La respuesta incluye el nombre y la URL canónicos junto con dos listas ordenadas de propiedades. Si el nombre no pertenece al catálogo compatible, la capacidad devuelve un error de entrada en vez de inventar una coincidencia aproximada. En un flujo de publicación, ese comportamiento permite que una errata como Productt detenga el proceso, en lugar de producir marcado aparentemente válido pero sin significado definido. Elija el tipo compatible más específico y exacto. Esta consulta cubre tipos populares en implementaciones SEO, no todas las clases del vocabulario completo de Schema.org.

Interprete los campos como una lista práctica de implementación

Schema.org es un vocabulario y no exige propiedades universalmente como lo haría el esquema de una base de datos. Las funciones de búsqueda, los validadores y otros consumidores establecen sus propios requisitos, que pueden variar según la plataforma y la presentación. Por eso, la lista de campos obligatorios representa las propiedades que suelen considerarse el mínimo útil para SEO, mientras que las recomendadas mejoran la integridad, la elegibilidad o la calidad de un resultado mostrado. Asocie primero cada propiedad obligatoria con información real y visible en la página. Después añada las recomendadas cuando disponga de datos fiables. Nunca invente una valoración, un precio, un autor, una imagen, una disponibilidad o una fecha solo para completar la lista. Un objeto más breve y basado en el contenido es preferible a un marcado rico que contradiga lo que ven los visitantes. Algunas propiedades contienen objetos anidados, como offers en Product, author en Article, location en Event y mainEntity en FAQPage. La consulta nombra las propiedades superiores, pero no genera valores anidados ni valida todo un grafo JSON-LD.

Integre resultados deterministas en auditorías y publicaciones

Como la consulta usa un catálogo fijo en memoria sin red, modelos, aleatoriedad ni dependencia del reloj, un mismo tipo compatible siempre produce el mismo resultado ordenado. Esto resulta útil para auditorías repetibles, creadores de formularios, plantillas de esquema, migraciones y controles de integración continua. Un CMS puede solicitar la lista cuando una persona editora selecciona un tipo de contenido, marcar los datos obligatorios ausentes y mostrar por separado las mejoras recomendadas. Una herramienta de auditoría puede comparar las claves JSON-LD existentes con la respuesta e informar de carencias sin tratar cada recomendación como un error. Un generador puede usar la URL canónica y conservar el orden para ofrecer una interfaz predecible. Considere el resultado un punto de partida práctico y consulte la documentación vigente de cualquier buscador cuyo resultado enriquecido sea esencial, pues sus políticas quedan fuera de este catálogo sin conexión. Cada solicitud API cuesta $0.002; la experiencia del navegador utiliza la misma lógica pura. Un tipo no compatible produce deliberadamente un error con el nombre enviado y las opciones admitidas para facilitar la corrección.