Esta página foi traduzida pela API Cloud Translation.

Criar um feed

O feed de mídia é um objeto JSON que contém um conjunto 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 no processo de integração é começar a desenvolver feeds. Quando os arquivos estiverem prontos, você precisará hospedar o feed usando um dos métodos de hospedagem compatíveis para que o Google busque regularmente.

Requisitos de formato do arquivo do feed

Veja a seguir os requisitos para os arquivos de feed:

O arquivo de feed precisa ter a extensão de nome de arquivo .json.
Não criptografe o arquivo do feed.
Codifique o arquivo do feed em UTF-8 (verifique a configuração do editor de arquivos).
Divida o arquivo em vários se o arquivo do feed for maior que 1 GB (não compactado).
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.).
- Desde que o tamanho do arquivo seja inferior a 1 GB, não há limite para o número de entidades que você pode incluir em um único arquivo.
Confira se o arquivo está codificado sem BOM, de acordo com a especificação JSON. Para verificar em um SO Linux, o hexdump file.json | head -n 1 não pode começar com BBEF no endereço 0x00.

Tipos de feed

Feed de produção

Isso representa o conjunto de arquivos de feed JSON que, juntos, representam seu catálogo inteiro 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 o feed é enviado ao Google, ele é analisado e iterado extensivamente algumas vezes para alcançar uma barra de qualidade superior com a quantidade de informações capturadas e a correção antes de ser ingerido e lançado.

Feed de preparo

Certos casos de uso exigem a expansão do feed de produção. Veja alguns exemplos de cenários desse tipo:
- Expansão do feed para incluir novos tipos de entidade que ainda não foram lançados.
- Expansão do feed para incluir um grande número de entidades/metadados novos 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 somente na Pesquisa Google e agora você quer expandi-lo para o Google TV.
Nesses casos, é necessário ter um feed de preparo. 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.
Semelhante ao feed de produção, ele será analisado e iterado extensivamente algumas vezes para alcançar uma barra de qualidade superior com a quantidade de informações capturadas e a exatidão delas. Quando a barra de qualidade é alcançada, este feed substitui o feed de produção atual para se tornar o novo feed de produção.
Esse feed permite separar o lançamento inicial dos lançamentos adicionais 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.

Trabalhe com seu representante do Google para esclarecer possíveis dúvidas sobre as informações acima.

Criar um arquivo de feed

Siga estas práticas recomendadas ao criar o feed:

Criar um feed de amostra usando um pequeno conjunto de entidades

Antes de criar um feed com todo o conteúdo do seu catálogo, recomendamos criar uma amostra de feed com apenas um pequeno conjunto de entidades. Ao trabalhar no seu feed, você provavelmente terá problemas. Ao limitar o tamanho do conjunto de entidades, você poderá depurar esses erros e avisos com mais facilidade.
Validar o feed de amostra

Oferecemos ferramentas que garantem que seu feed esteja em conformidade com as especificações. Recomendamos usar essas ferramentas para resolver todos os erros e avisos encontrados no 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 amostra

Selecione uma entidade representativa do seu catálogo. Escolha uma entidade com uma estrutura razoavelmente complexa, mas que ainda seja comum para uma entidade no catálogo.

Use a ferramenta de validação de feed de dados para verificar se há erros de sintaxe e se há propriedades obrigatórias ausentes. Consulte a próxima seção para mais detalhes.

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 amostra com as especificações dos dados estruturados do Google para feeds de mídia.

Ferramenta de validação de 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 amostra do seu catálogo em busca de erros estruturais e de conteúdo comum. Veja mais detalhes sobre a ferramenta aqui.
Ferramenta de validação de esquema JSON

A ferramenta de Validação de esquema JSON pode validar todos os arquivos em um feed. Use essa ferramenta durante o desenvolvimento do feed para evitar erros estruturais comuns. Veja mais detalhes sobre a ferramenta aqui.

Criar um feed de produção

Depois que todos os erros e avisos no feed de amostra forem resolvidos, expanda o feed para incluir todas as entidades no seu catálogo.
Use a ferramenta de validação de feed de dados com frequência para validar um pequeno número de entidades no seu feed por vez (Colar uma grande quantidade de entidades na ferramenta pode congelar o navegador da Web). Confirme se o feed inclui todas as entidades no seu catálogo, comparando a quantidade de entidades no seu feed com o número de itens do catálogo.

Identificar o preço

Hospedar o feed