O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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 compatíveis para que o Google possa buscá-lo regularmente.

Requisitos de formato do arquivo de feed

Estes são 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 de feed.
Codifique o arquivo de feed em UTF-8 (verifique a configuração do editor de arquivos).
Divida o arquivo em vários arquivos se ele for maior que 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.).
- Desde que o tamanho do arquivo seja menor que 1 GB, não há limitação para o número de entidades que você pode incluir em um único arquivo.
Verifique se o arquivo está codificado sem BOM, de acordo com a especificação JSON. Para verificar 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

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 algumas vezes para atingir um nível de qualidade mais alto em relação à quantidade de informações capturadas e à correção delas antes de ser finalmente ingerido e lançado.

Feed de preparo

Há alguns 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 entidade, não lançados anteriormente.
- Expansão do feed para incluir um grande número de novas entidades/metadados para lançamento em novas regiões.
- Expansão do feed para novos tipos de plataforma. Por exemplo, quando o feed de produção é lançado apenas na Pesquisa Google e agora você quer expandir o lançamento para o Google TV.
Nesses casos, é necessário um feed de teste. 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 algumas vezes para alcançar um padrão de qualidade mais alto em relação à quantidade de informações capturadas e à precisão delas. Depois que o nível de qualidade é atingido, esse 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 não haja interrupções na experiência do usuário final.

Entre em contato com seu representante do Google para esclarecer qualquer dúvida sobre o que foi mencionado 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 que contenha todo o conteúdo do seu catálogo, recomendamos que você crie um feed de amostra 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 amostra

Oferecemos 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 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 típica para uma entidade no catálogo.

Use a ferramenta de validação de esquema JSON para verificar se há erros de sintaxe e 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 exemplo

As ferramentas a seguir estão disponíveis para ajudar você a validar um feed de amostra de acordo com as especificações de dados estruturados do Google para feeds de mídia:

Ferramenta de validação de esquema JSON

A ferramenta de validação de esquema JSON valida todos os arquivos em um feed localmente antes do upload. Use essa ferramenta durante o desenvolvimento do feed para evitar erros comuns de estrutura e tipo. Saiba mais sobre a ferramenta neste link.
Propriedades do catálogo no Search Console

Depois que o representante do Google ativar sua propriedade de catálogo do Search Console e seu feed de amostra ou de teste for ingerido, use as propriedades de catálogo no Search Console para inspecionar erros de validação, avisos e diagnósticos de ingestão no nível da entidade.

Criar um feed de produção

Depois que todos os erros e avisos estruturais no feed de amostra forem resolvidos, expanda o feed para incluir todas as entidades no seu catálogo.
Execute a ferramenta de validação de esquema JSON nos arquivos de feed expandidos e analise as propriedades do catálogo no Search Console após o upload para verificar se não há erros de validação. Confirme se o feed inclui todas as entidades do catálogo comparando o número de entidades no feed com o número de itens no catálogo.

Identificar o preço

Avançar

Hospedar o feed