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 do 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 buscas regulares.

Requisitos de formato de arquivo do feed

Confira a seguir os requisitos dos arquivos de feed:

O arquivo de feed precisa ter a extensão de nome de arquivo .json.
Não criptografe seu arquivo de feed.
Codifique o arquivo do feed em UTF-8 (verifique a configuração do editor de arquivos).
Divida o arquivo em vários arquivos se o arquivo de 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 (por exemplo, tvepisodes_01.json, tvepisodes_02.json etc.).
- Desde que o arquivo seja menor que 1 GB, não há limite para o número de entidades que podem ser incluídas em um único arquivo.
Verifique se o arquivo está codificado sem BoM, de acordo com 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

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 de que você precisa se estiver fazendo a integração com o Google pela primeira vez.
Depois que o feed é enviado ao Google, ele é amplamente analisado e iterado em alguns para atingir um padrão de qualidade mais alto com a quantidade de informações capturadas a precisão deles antes de serem ingeridos e iniciados.

Feed de preparo

Alguns casos de uso exigem a expansão do feed de produção. Alguns exemplos desses cenários:
- Expansão do feed para incluir novos tipos de entidade ainda não lançados.
- Expansão do feed para incluir um grande número de novas entidades/metadados para lançar em novos localidades.
- Expansão do feed para novos tipos de plataforma. Por exemplo, quando o feed de produção é foi lançado na Pesquisa Google e agora deseja expandir o lançamento para o Google TV.
Nesses casos, é necessário um feed de preparo. Este feed é uma cópia do feed de produção, exceto pelo fato de que Ele tem metadados adicionais, como links diretos para uma nova plataforma e metadados para uma nova localidade. e assim por diante.
Semelhante ao feed de produção, ele será amplamente analisado e iterado algumas vezes para a melhorar a qualidade das informações capturadas e a correção delas. Uma vez que a barra de qualidade seja alcançada, esse feed substitui o feed de produção atual para se tornar a novo feed de produção.
Esse feed nos permite separar o lançamento inicial dos lançamentos adicionais, realizar todas os testes exigidos, sem afetar o feed de produção. Assim, não há interrupções até o final. experiência do usuário.

Converse com seu representante do Google para esclarecer possíveis dúvidas 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 com todo o conteúdo do catálogo, recomendamos que você crie um feed de amostra com apenas um pequeno conjunto de entidades. Ao trabalhar no seu feed, você provavelmente se depara com problemas. Ao limitar o tamanho do conjunto de entidades, você poderá depurar esses erros e e alertas com mais facilidade.
Validar o feed de amostra

Oferecemos ferramentas para garantir que seu feed esteja em conformidade com as especificações. Recomendamos 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 no 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 erros de sintaxe e falta de propriedades obrigatórias. 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 dados estruturados do Google especificações 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 esta ferramenta para validar uma amostra entidade do seu catálogo em busca de erros estruturais e de conteúdo comuns. Saiba 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 a desenvolvimento do feed para evitar erros estruturais comuns. Você pode encontrar mais detalhes sobre o 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 todos as entidades no seu catálogo.
Use a ferramenta de Validação do feed de dados. para validar um pequeno número de entidades em seu feed ao mesmo tempo (colar um grande número de entidades na ferramenta pode congelar o navegador da web). Confirmar se o feed inclui todas as entidades do seu catálogo comparando o número de entidades no seu feed com o número de itens nos seus catálogo.

Identificar o preço

Hospedar o feed