Colete o ID, o URL e o nome do seu conteúdo

As entidades de conteúdo no seu catálogo geralmente exigem as seguintes propriedades:

• @id: um identificador global para a entidade.
• url: um URL canônico para o conteúdo. Não use url em entidades BroadcastEvent, SportsEvent ou de programação de canais (TelevisionChannel e CableOrSatelliteService).
• name: o nome do conteúdo.

Exemplo de @id, url e name:

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

Identificador

Um identificador (@id) precisa atender aos seguintes requisitos:

• Exclusivo globalmente em todo o catálogo
  • Por exemplo, não use o mesmo @id para um TVSeries e um TVSeason.
• Estático
  • Não será possível mudar o @id depois.
• No formato de identificador uniforme de recursos (URI)
  • Se o identificador (ID) local do seu conteúdo não estiver no formato de URI, adicione seu domínio ao ID para atender a esse requisito. Por exemplo, se o ID do seu conteúdo for 1234abc e seu domínio for https://example.com, o @id poderá ser https://example.com/1234abc.
  • @id não precisa ser um URL funcional, apenas estar no formato de URI.
  • O domínio usado em @id (por exemplo, https://example.com) precisa ser de propriedade da sua organização.

Como o url de uma entidade atende a todos os requisitos de um identificador (ou seja, é globalmente exclusivo, estático e está no formato de um URI), recomendamos que você use o url de uma entidade como @id.

URL canônico

Um URL canônico (url) ajuda o Google a reconciliar com precisão o conteúdo do seu catálogo com as informações dos bancos de dados do Google.

"Um URL canônico é o URL da página que o Google considera a mais representativa de um conjunto de páginas duplicadas em um site. Por exemplo, se você tiver URLs da mesma página (como example.com?dress=1234 e example.com/dresses/1234), o Google vai escolher um deles como canônico." (Fonte: Consolidar URLs duplicados)

Estes são os requisitos para o URL canônico:

• url precisa ser globalmente exclusivo.
• url precisa conter um URL canônico que funcione e que o Google possa rastrear.
• (Somente ações de áudio) url precisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
• (TV ao vivo) Não inclua url em entidades BroadcastEvent. Para transmissões de TV e filmes, forneça url na entidade Movie, TVSeries ou TVEpisode.
• (Esportes) Não inclua url em entidades SportsEvent. Forneça links de reprodução usando SportsEvent.potentialAction.
• (TV ao vivo e esportes) Verifique se BroadcastEvent.@id é diferente do @id da entidade Movie, TVSeries, TVEpisode ou SportsEvent referenciada.

Coletar o ID, o URL e o nome

Faça o seguinte:

1. Reúna os nomes do conteúdo no seu catálogo.
2. Identifique os URLs canônicos do conteúdo. Recomendamos que você use o url do conteúdo como @id.