Todas as entidades no seu catálogo exigem as seguintes propriedades:
@id: um identificador global do conteúdo.url: um URL canônico para o conteúdo.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 no seu catálogo
- Por exemplo, não use o mesmo
@idpara umTVSeriese umTVSeason.
- Por exemplo, não use o mesmo
- Estáticas
- Não é possível mudar
@iddepois.
- Não é possível mudar
- No formato de identificador uniforme de recursos (URI, na sigla em inglês)
- Se o identificador local (ID) do conteúdo não estiver em um formato de URI, adicione o domínio ao ID para atender a esse requisito. Por exemplo, se o ID do conteúdo for 1234abc e o domínio for https://example.com,
@idpode ser https://example.com/1234abc. - O
@idnão precisa ser um URL funcional. Ele só precisa estar em um formato de URI. - O domínio usado em
@id(por exemplo, https://example.com) precisa ser de propriedade da sua organização.
- Se o identificador local (ID) do conteúdo não estiver em um formato de URI, adicione o domínio ao ID para atender a esse requisito. Por exemplo, se o ID do conteúdo for 1234abc e o domínio for https://example.com,
Como o url de uma entidade atende a todos os requisitos como um identificador (ou seja, globalmente exclusivo, estático e na forma 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 o conteúdo 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 no seu site. Por exemplo, se você tiver URLs para a mesma página (por exemplo, example.com?dress=1234 e example.com/dresses/1234), o Google vai escolher um como canônico." (Fonte: Consolidar URLs duplicados)
Confira a seguir os requisitos para o URL canônico:
- O
urlprecisa ser globalmente exclusivo. - O
urlprecisa conter um URL canônico que funcione e que o Google possa rastrear. - (Apenas ações de ouvir)
urlprecisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
Coletar o ID, o URL e o nome
Faça o seguinte:
- Colete os nomes do conteúdo do seu catálogo.
- Identifique os URLs canônicos do conteúdo. Recomendamos que você use o
urldo conteúdo como@id.