Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O feed de mídia é um objeto JSON que contém uma coleção de entidades que representam o
conteúdo de mídia no seu catálogo, como séries de TV, filmes, músicas, álbuns e muito mais. A primeira etapa do processo de integração é começar a desenvolver seus feeds. Quando os arquivos estiverem prontos, você precisará hospedar
o feed usando um dos métodos de hospedagem aceitos para que o Google faça a busca regularmente.
Requisitos de formato do arquivo do feed
Confira os requisitos para os arquivos de feed:
O arquivo do feed precisa ter a extensão de nome de arquivo .json.
Não criptografe o arquivo do feed.
Codifique o arquivo de feed em UTF-8 (confira a configuração do editor de arquivos).
Divida o arquivo em vários arquivos se ele tiver mais de 1 GB (descompactado).
Recomendamos que você crie um arquivo por tipo de entidade (por exemplo, tvseries.json, tvseasons.json, tvepisodes.json, movies.json etc.).
Se algum desses arquivos exceder 1 GB, divida as entidades em vários
arquivos (por exemplo, tvepisodes_01.json, tvepisodes_02.json etc.).
Se o tamanho do arquivo for menor que 1 GB, não haverá limitação de entidades que podem ser incluídas em um único arquivo.
Verifique se o arquivo está codificado sem BOM, conforme a especificação JSON. Para verificar em um SO Linux, hexdump file.json | head -n 1 não pode começar com BBEF no endereço 0x00.
Tipos de feed
Feed de produção
Ele representa o conjunto de arquivos de feed JSON que, juntos, representam todo o catálogo que você quer lançar no Google. Saiba como criar um feed na seção abaixo.
Esse é o único feed necessário se você estiver fazendo a integração com o Google pela primeira vez.
Depois que esse feed for enviado ao Google, ele será analisado e iterado várias vezes para alcançar um nível de qualidade mais alto em relação à quantidade de informações capturadas e à sua precisão antes de ser finalmente transferido e lançado.
Feed de preparo
Há casos de uso que exigem a expansão do feed de produção. Confira alguns exemplos
desses cenários:
Expansão do feed para incluir novos tipos de entidades, não lançados anteriormente.
Expansão do feed para incluir um grande número de novas entidades/metadados a serem lançados em novas
localidades.
Expansão do feed para novos tipos de plataforma. Por exemplo, quando o feed de produção é lançado apenas
na Pesquisa Google e você quer expandir o lançamento para o Google TV.
Nesses casos, é necessário um feed de preparação. Esse feed é uma cópia do feed de produção, mas tem metadados adicionais, por exemplo, links diretos para uma nova plataforma, metadados para uma nova localidade e assim por diante.
Assim como o feed de produção, ele será analisado e iterado várias vezes para
alcançar um nível de qualidade mais alto em relação à quantidade de informações capturadas e à precisão delas.
Quando a barra de qualidade for alcançada, esse feed vai substituir o feed de produção atual e se tornar o
novo feed de produção.
Esse feed permite separar o lançamento inicial dos outros e realizar todos os testes necessários sem afetar o feed de produção. Isso garante que a experiência do usuário final não seja interrompida.
Converse com seu representante do Google para esclarecer dúvidas sobre o assunto.
Antes de criar um feed que contenha todo o conteúdo do seu catálogo, recomendamos que você crie um
feed de exemplo com apenas um pequeno conjunto de entidades. Ao trabalhar no seu feed, é provável que você encontre
problemas. Ao limitar o tamanho do conjunto de entidades, você poderá depurar esses erros e
avisos com mais facilidade.
Fornecemos ferramentas que garantem que seu feed esteja em conformidade com as especificações. Recomendamos
que você use essas ferramentas para resolver todos os erros e avisos encontrados no seu feed de amostra.
Depois de verificar se você tem uma boa estrutura para o pequeno conjunto de entidades, desenvolva um feed para todo o catálogo.
Criar um feed de exemplo
Selecione uma entidade representativa do seu catálogo. Escolha uma entidade com uma estrutura razoavelmente complexa, mas que ainda seja típica de uma entidade no catálogo.
Use a ferramenta de validação do feed de dados para verificar se há erros de sintaxe e propriedades obrigatórias ausentes. Para mais detalhes, consulte a próxima seção.
Exemplo de um feed com uma única entidade 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"}]}]}
Validar o feed de amostra
As ferramentas a seguir estão disponíveis para ajudar você a validar um feed de exemplo com as especificações de dados estruturados do Google para feeds de mídia.
Ferramenta de validação do feed de dados
A ferramenta de validação do feed de dados pode validar uma única entidade por vez. Use essa ferramenta para validar uma entidade
de exemplo do seu catálogo em busca de erros estruturais e de conteúdo comuns. Saiba mais
sobre a ferramenta aqui.
Ferramenta de validação de esquema JSON
A ferramenta de validação do esquema JSON pode validar todos os arquivos em um feed. Use essa ferramenta durante o
desenvolvimento do feed para evitar erros estruturais comuns. Saiba mais sobre a ferramenta aqui.
Criar um feed de produção
Depois que todos os erros e avisos no feed de exemplo forem resolvidos, expanda o feed para incluir todas
as entidades no seu catálogo.
Use a ferramenta de validação do feed de dados
com frequência para validar um pequeno número de entidades no seu feed por vez. Colar um grande número de
entidades na ferramenta pode congelar o navegador da Web. Confirme se o feed inclui todas as entidades
no seu catálogo comparando o número de entidades no feed com o número de itens no
catálogo.
[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."]]
