Crear un feed
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 integración es comenzar a desarrollar tus feeds. Una vez que los archivos estén listos, debes alojados
el feed con uno de los métodos de alojamiento admitidos para que Google lo recupere con regularidad.
Los siguientes son los requisitos para los archivos de feed:
- El archivo del feed debe tener la extensión del nombre del archivo
.json.
- No encriptes el archivo del feed.
Codifica el archivo del feed en UTF-8 (consulta la configuración de tu editor de archivos).
Divide el archivo en varios archivos si el archivo de feed es superior a 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 los 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 sobre la cantidad de entidades que puedes incluir en un solo archivo.
Asegúrate de que el archivo esté codificado sin BOM, según la especificación JSON. Para verificarlo en un SO Linux, hexdump file.json | head -n 1 no debe comenzar con BBEF en 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. Obtén información para crear un feed en la siguiente sección.
- Este es el único feed que necesitas si realizas la integración con Google por primera vez.
- Una vez que se envíe este feed a Google, se analizará en detalle 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 lance por completo.
Feed de etapa de pruebas
- Hay 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 lanzaron anteriormente.
- Expansión del feed para incluir una gran cantidad de entidades o metadatos nuevos que se lanzarán en nuevas configuraciones regionales.
- 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 deseas expandir el lanzamiento a Google TV.
- En esos casos, se requiere un feed 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 con el feed de producción, se analizará y iterará en varias ocasiones para lograr una barra de calidad más alta en relación con la cantidad de información que se captura y su exactitud.
Una vez que se alcanza la barra de calidad, este feed reemplaza al feed de producción actual y se convierte en el nuevo feed de producción.
- Este feed nos permite separar el lanzamiento inicial de los lanzamientos adicionales, realizar todas las pruebas necesarias sin afectar el feed de producción. Esto garantiza que no haya interrupciones en 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:
Cómo crear un feed de ejemplo con un pequeño conjunto 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. Es probable que, mientras trabajas en tu feed, te encuentres con
problemas. Si limitas el tamaño del conjunto de entidades, podrás depurar estos errores y advertencias con mayor facilidad.
Cómo validar el feed de muestra
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 encuentran en tu feed de muestra.
Cómo crear un feed de producción
Después de verificar que tienes una buena estructura para el pequeño conjunto 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 bastante compleja, pero que aún sea típica de una entidad en el catálogo.
- Usa la herramienta de validación de feeds de datos para verificar si hay errores de sintaxis y propiedades obligatorias faltantes. (consulta la siguiente sección para obtener más información).
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 ejemplo
Las siguientes herramientas están disponibles para ayudarte a validar un feed de muestra con las especificaciones de datos estructurados de Google para feeds multimedia.
Herramienta de validación de feeds de datos
La herramienta de validación de feeds de datos puede validar una sola entidad a la vez. Usa esta herramienta para validar una entidad de muestra de tu catálogo en busca de errores estructurales y errores de contenido comunes. Puedes encontrar más detalles sobre la herramienta aquí.
Herramienta de validación de esquemas JSON
La herramienta de validación del esquema JSON puede validar todos los archivos de un feed. Usa esta herramienta durante el desarrollo del feed para evitar errores estructurales comunes. Puedes encontrar más detalles sobre la
herramienta aquí.
Crea un feed de producción
- Una vez que se resuelvan todos los errores y las advertencias del feed de muestra, expándelo para incluir todas
las entidades de tu catálogo.
- Usa la herramienta de validación de feeds de datos con frecuencia para validar una pequeña cantidad de entidades de tu feed a la vez (si pegas una gran cantidad de entidades en la herramienta, es posible que se congele el navegador web). Para confirmar que tu feed incluya todas las entidades de tu catálogo, compara la cantidad de entidades de tu feed con la cantidad de artículos de tu catálogo.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
[null,null,[],[[["\u003cp\u003eThe Media feed is a JSON object that contains media content, and onboarding begins with developing and hosting these feeds.\u003c/p\u003e\n"],["\u003cp\u003eFeed files must be in \u003ccode\u003e.json\u003c/code\u003e format, UTF-8 encoded without BOM, unencrypted, and potentially split into multiple files if exceeding 1GB.\u003c/p\u003e\n"],["\u003cp\u003eTwo types of feeds exist: Production feed for initial launch of your entire catalog and Staging feed for subsequent expansions or new platform integrations.\u003c/p\u003e\n"],["\u003cp\u003eBefore creating a full production feed, it is recommended to start with a sample feed, validate it using provided tools, and then expand it to include your entire catalog.\u003c/p\u003e\n"]]],["The initial step in onboarding is developing media feeds, which are JSON files representing your catalog's content. Once developed, these files must be hosted for regular Google fetching. Feed files must be in `.json` format, UTF-8 encoded, unencrypted, and under 1GB (uncompressed); splitting larger files is recommended. Two types exist: production (for initial launch) and staging (for expansion), both are validated and iterated. You should start with a small sample feed for validation, then use tools to validate it, and expand to a production feed.\n"],null,["# Create a feed\n\nThe Media feed is a JSON object that contains a collection of entities that represent the\nmedia content in your catalog, such as TV Series, Movies, Songs, Albums, and more. The first step in\nthe onboarding process is to start developing your feeds. Once the files are ready, you need to [host](./host-the-feed)\nthe feed using one of the supported hosting methods for Google to fetch regularly.\n| **Note:** If you haven't gathered all the required information for your content, see the [Collect Information](../collect-information/) section.\n\nFeed file format requirements\n-----------------------------\n\nThe following are the requirements for the feed file(s):\n\n- Feed file must have the filename extension `.json`.\n- Don't encrypt your feed file.\n- Encode your feed file in UTF-8 (check your file editor setting).\n\n- Split the file into multiple files if your feed file is larger than 1 GB (uncompressed).\n\n- We recommend you create a file per entity type (for example, `tvseries.json`, `tvseasons.json`, `tvepisodes.json`, `movies.json`, etc).\n\n - If any of these files exceeds 1GB, split its entities into multiple files (for example, `tvepisodes_01.json`, `tvepisodes_02.json`, etc).\n - As long as the file size is less than 1 GB, there is no limitation on how many entities you can include in a single file.\n- Ensure that the file is encoded **without** BOM, as per [JSON specification](https://tools.ietf.org/html/rfc7159#section-8.1). To check on a linux OS, `hexdump file.json | head -n 1` must not start with `BBEF` at address 0x00.\n\nTypes of feeds\n--------------\n\n### Production feed\n\n- This represents the set of json feed file(s) that together represent your entire catalog you want to launch on Google. You can learn how to create a feed in the section below.\n- This is the only feed you need if you are integrating with Google for the first time.\n- Once this feed is submitted to Google, it will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness before it is finally ingested and launched.\n\n### Staging feed\n\n- There are certain use cases that require the expansion of the production feed. A few examples of such scenarios are:\n - Expansion of the feed to include new entity types, not previously launched.\n - Expansion of the feed to include a huge number of new entities/metadata to launch in new locales.\n - Expansion of the feed to new platform types. For example, when the production feed is only launched on Google Search and now you want to expand the launch to Google TV.\n- In such cases, a staging feed is required. This feed is a copy of the production feed except that it has additional metadata, for example, deep links for a new platform, metadata for a new locale and so on.\n- Similar to the production feed, this will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness. Once the quality bar is achieved, this feed replaces the current production feed to become the new production feed.\n- This feed allows us to separate the initial launch from the additional launches, perform all required testing, without affecting the production feed. This ensures no disruptions to the end user experience.\n\nWork with your Google representative to clarify any questions you may have on the above.\n\nCreate a feed file\n------------------\n\nFollow these best practices when creating the feed:\n\n1. [Create a sample feed using a small set of entities](#create_a_sample_feed)\n\n Before building a feed that contains all the content in your catalog, we recommend you create a\n sample feed with only a small set of entities. While working on your feed, you're likely to run into\n issues. By limiting your the size of the set of entities, you will be able to debug these errors and\n warnings more easily.\n2. [Validate the sample feed](#validate_the_sample_feed)\n\n We provide tools that ensure that your feed is compliant with the specifications. We recommend\n you use these tools to resolve all the errors and warnings found in your sample feed.\n3. [Create a production feed](#create_a_production_feed)\n\n After you've verified that you have a good structure for the small set of your entities, develop a feed for your entire catalog.\n\n### Create a sample feed\n\n1. Select one representative entity from your catalog. Choose an entity with a reasonably complex structure, but is still typical for an entity in the catalog.\n 2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) to check for syntax errors and missing required properties. (See the next section for details.) Example of a feed with a single `Movie` entity \n\n ```carbon\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"DataFeed\",\n \"dateModified\": \"2018-07-20T00:44:51Z\",\n \"dataFeedElement\": [\n {\n \"@context\": [\"http://schema.org\", {\"@language\": \"en\"}],\n \"@type\": \"Movie\",\n \"@id\": \"http://www.example.com/my_favorite_movie\",\n \"url\": \"http://www.example.com/my_favorite_movie\",\n \"name\": \"My Favorite Movie\",\n \"potentialAction\": {\n \"@type\": \"WatchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"http://www.example.com/my_favorite_movie?autoplay=true\",\n \"inLanguage\": \"en\",\n \"actionPlatform\": [\n \"http://schema.org/DesktopWebPlatform\",\n \"http://schema.org/MobileWebPlatform\",\n \"http://schema.org/AndroidPlatform\",\n \"http://schema.org/AndroidTVPlatform\",\n \"http://schema.org/IOSPlatform\",\n \"http://schema.googleapis.com/GoogleVideoCast\"\n ]\n },\n \"actionAccessibilityRequirement\": {\n \"@type\": \"ActionAccessSpecification\",\n \"category\": \"subscription\",\n \"requiresSubscription\": {\n \"@type\": \"MediaSubscription\",\n \"name\": \"Example Package\",\n \"commonTier\": true,\n \"@id\": \"[partner determined string]\"\n },\n \"availabilityStarts\": \"2018-07-21T10:35:29Z\",\n \"availabilityEnds\": \"2019-10-21T10:35:29Z\",\n \"eligibleRegion\": [\n {\n \"@type\": \"Country\",\n \"name\": \"US\"\n },\n {\n \"@type\": \"Country\",\n \"name\": \"CA\"\n }\n ]\n }\n },\n \"sameAs\": \"https://en.wikipedia.org/wiki/my_favorite_movie\",\n \"releasedEvent\": {\n \"@type\": \"PublicationEvent\",\n \"startDate\": \"2008-01-20\",\n \"location\": {\n \"@type\": \"Country\",\n \"name\": \"US\"\n }\n },\n \"description\": \"This is my favorite movie.\",\n \"actor\": [\n {\n \"@type\": \"Person\",\n \"name\": \"John Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/John_Doe\"\n },\n {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/Jane_Doe\"\n }\n ],\n \"identifier\": [\n {\n \"@type\": \"PropertyValue\",\n \"propertyID\": \"IMDB_ID\",\n \"value\": \"tt0123456\"\n }\n ]\n }\n ]\n }\n ```\n\n### Validate the sample feed\n\nThe following tools are available to help you validate a sample feed with Google's structured data\nspecifications for media feeds.\n\n- **Data Feed Validation tool**\n\n The Data Feed Validation tool can validate a single entity at a time. Use this tool to validate a sample\n entity from your catalog for structural errors and common content errors. You can find more\n details about the tool [here](../tools/troubleshoot-using-the-data-feed-validation-tool).\n- **JSON Schema Validation tool**\n\n The JSON Schema Validation tool can validate all files in a feed. Use this tool during the\n development of the feed to avoid common structural errors. You can find more details about the\n tool [here](../tools/jsonschemas).\n\n### Create a production feed\n\n1. Once all the errors and warnings in the sample feed are resolved, expand the feed to include all the entities in your catalog.\n2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) frequently to validate a small number of entities in your feed at a time (Pasting a large number of entities on the tool may freeze the web browser). Confirm that your feed includes all the entities in your catalog by comparing the number of entities in your feed with the number of items in your catalog."]]
