El feed de contenido multimedia es un objeto JSON que contiene una colección de entidades que representan el contenido multimedia de tu catálogo, como series de TV, películas, canciones, álbumes y mucho más. El primer paso del proceso de incorporación es comenzar a desarrollar tus feeds. Una vez que los archivos estén listos, debes alojar el feed con uno de los métodos de hosting admitidos para que Google lo recupere con regularidad.
Requisitos de formato del archivo de feed
Los siguientes son los requisitos para los archivos de feed:
- El archivo del feed debe tener la extensión de nombre de archivo
.json. - No encriptes el archivo de feed.
Codifica el archivo de feed en UTF-8 (verifica la configuración del editor de archivos).

Divide el archivo en varios archivos si el archivo de feed supera 1 GB (sin comprimir).
Te recomendamos que crees un archivo por tipo de entidad (por ejemplo,
tvseries.json,tvseasons.json,tvepisodes.json,movies.json, etcétera).- Si alguno de estos archivos supera 1 GB, divide sus entidades en varios
archivos (por ejemplo,
tvepisodes_01.json,tvepisodes_02.json, etcétera). - Siempre que el tamaño del archivo sea inferior a 1 GB, no hay limitaciones en cuanto a la cantidad de entidades que puedes incluir en un solo archivo.
- Si alguno de estos archivos supera 1 GB, divide sus entidades en varios
archivos (por ejemplo,
Asegúrate de que el archivo esté codificado sin BOM, según la especificación de JSON. Para verificar un SO Linux,
hexdump file.json | head -n 1no debe comenzar conBBEFen la dirección 0x00.
Tipos de feeds
Feed de producción
- Representa el conjunto de archivos de feed JSON que, en conjunto, representan todo el catálogo que deseas lanzar en Google. Puedes obtener información para crear un feed en la siguiente sección.
- Este es el único feed que necesitas si te integras con Google por primera vez.
- Una vez que se envíe este feed a Google, se analizará de forma exhaustiva y se iterará varias veces para lograr un nivel de calidad más alto en relación con la cantidad de información que se captura y su exactitud antes de que se transfiera y se lance.
Feed de etapa de pruebas
- Existen ciertos casos de uso que requieren la expansión del feed de producción. Estos son algunos ejemplos de esas situaciones:
- Expansión del feed para incluir nuevos tipos de entidades que no se hayan lanzado anteriormente
- Expansión del feed para incluir una gran cantidad de entidades o metadatos nuevos que se lanzarán en ubicaciones nuevas
- Expansión del feed a nuevos tipos de plataformas Por ejemplo, cuando el feed de producción solo se lanza en la Búsqueda de Google y ahora quieres expandir el lanzamiento a Google TV.
- En esos casos, se requiere un feed de etapa de pruebas. Este feed es una copia del feed de producción, excepto que tiene metadatos adicionales, por ejemplo, vínculos directos para una plataforma nueva, metadatos para una configuración regional nueva, etcétera.
- Al igual que el feed de producción, este se analizará de forma exhaustiva y se iterará varias veces para alcanzar un nivel de calidad más alto en relación con la cantidad de información que se captura y su exactitud. Una vez que se alcanza el nivel de calidad, este feed reemplaza al feed de producción actual para convertirse en el nuevo feed de producción.
- Este feed nos permite separar el lanzamiento inicial de los lanzamientos adicionales y realizar todas las pruebas necesarias sin afectar el feed de producción. Esto garantiza que no se interrumpa la experiencia del usuario final.
Trabaja con tu representante de Google para aclarar cualquier duda que tengas sobre lo anterior.
Crea un archivo de feed
Sigue estas prácticas recomendadas cuando crees el feed:
Crea un feed de muestra con un conjunto pequeño de entidades
Antes de crear un feed que contenga todo el contenido de tu catálogo, te recomendamos que crees un feed de muestra con solo un pequeño conjunto de entidades. Mientras trabajas en tu feed, es probable que encuentres problemas. Si limitas el tamaño del conjunto de entidades, podrás depurar estos errores y advertencias con mayor facilidad.
-
Proporcionamos herramientas que garantizan que tu feed cumpla con las especificaciones. Te recomendamos que uses estas herramientas para resolver todos los errores y las advertencias que se encuentren en tu feed de muestra.
Cómo crear un feed de producción
Después de verificar que tienes una buena estructura para el conjunto pequeño de tus entidades, desarrolla un feed para todo tu catálogo.
Crea un feed de muestra
- Selecciona una entidad representativa de tu catálogo. Elige una entidad con una estructura razonablemente compleja, pero que siga siendo típica para una entidad del catálogo.
- Usa la herramienta de validación de esquemas JSON para verificar si hay errores de sintaxis y propiedades obligatorias faltantes. (Consulta la siguiente sección para obtener más detalles).
Ejemplo de un feed con una sola entidad
Movie{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": ["http://schema.org", {"@language": "en"}], "@type": "Movie", "@id": "http://www.example.com/my_favorite_movie", "url": "http://www.example.com/my_favorite_movie", "name": "My Favorite Movie", "potentialAction": { "@type": "WatchAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
Valida el feed de muestra
Las siguientes herramientas están disponibles para ayudarte a validar un feed de muestra con las especificaciones de datos estructurados de Google para feeds de contenido multimedia:
Herramienta de validación de esquemas JSON
La herramienta de validación de esquemas JSON valida todos los archivos de un feed de forma local antes de subirlos. Usa esta herramienta durante el desarrollo del feed para evitar errores comunes de estructura y tipo. Puedes obtener más información sobre la herramienta aquí.
Propiedades de catálogo en Search Console
Después de que tu representante de Google habilite tu propiedad de catálogo de Search Console y se transfiera tu feed de muestra o de etapa de pruebas, usa las propiedades de catálogo en Search Console para inspeccionar los errores de validación, las advertencias y los diagnósticos de transferencia a nivel de la entidad.
Crea un feed de producción
- Una vez que se resuelvan todos los errores y las advertencias estructurales en el feed de muestra, expande el feed para incluir todas las entidades de tu catálogo.
- Ejecuta la herramienta de validación de esquemas JSON en tus archivos de feed expandidos y revisa las propiedades del catálogo en Search Console después de la carga para verificar que no haya errores de validación. Para confirmar que tu feed incluya todas las entidades de tu catálogo, compara la cantidad de entidades del feed con la cantidad de elementos del catálogo.