Esta página foi traduzida pela API Cloud Translation.

Criar um feed

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.

Criar um arquivo de feed

Siga estas práticas recomendadas ao criar o feed:

Criar um feed de exemplo usando um pequeno conjunto de entidades

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.
Validar o feed de exemplo

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.
Criar um feed de produção

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.

Identificar o preço

Hospedar o feed