Raccogliere l'ID, l'URL e il nome dei tuoi contenuti

In genere, le entità di contenuti nel catalogo richiedono le seguenti proprietà:

• @id: un identificatore globale per l'entità.
• url: un URL canonico per i contenuti. Non utilizzare url su entità BroadcastEvent, SportsEvent o di selezione dei canali (TelevisionChannel e CableOrSatelliteService).
• name: il nome dei contenuti.

Esempio di @id, url e name:

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

Identificatore

Un identificatore (@id) deve soddisfare i seguenti requisiti:

• Univoco a livello globale nel tuo catalogo
  • Ad esempio, non utilizzare lo stesso @id per un TVSeries e un TVSeason.
• Statico
  • Non puoi modificare @id in un secondo momento.
• Sotto forma di URI (Unified Resource Identifier)
  • Se l'identificatore (ID) locale dei tuoi contenuti non è in formato URI, anteponi il tuo dominio all'ID per soddisfare questo requisito; ad esempio, se l'ID dei tuoi contenuti è 1234abc e il tuo dominio è https://example.com, @id può essere https://example.com/1234abc.
  • @id non deve essere un URL funzionante, ma deve solo essere in formato URI.
  • Il dominio utilizzato in @id (ad esempio https://example.com) deve essere di proprietà della tua organizzazione.

Poiché l'url di un'entità soddisfa tutti i requisiti di un identificatore (ovvero è univoco a livello globale, statico e sotto forma di URI), ti consigliamo di utilizzare l'url di un'entità come @id.

URL canonico

Un URL canonico (url) aiuta Google a riconciliare con precisione i contenuti del tuo catalogo con quelli dei database di Google.

"Un URL canonico è l'URL della pagina che Google ritiene più rappresentativo tra un insieme di pagine duplicate sul tuo sito. Ad esempio, se hai più URL per la stessa pagina (ad esempio: example.com?dress=1234 e example.com/dresses/1234), Google ne sceglie uno come canonico." (Fonte: Consolidare gli URL duplicati)

Di seguito sono riportati i requisiti per l'URL canonico:

• url deve essere univoco a livello globale.
• url deve contenere un URL canonico funzionante che Google può sottoporre a scansione.
• (Solo azioni di ascolto) url deve rimandare a una pagina di descrizione dei contenuti non bloccata da un paywall.
• (TV in diretta) Non includere url nelle entità BroadcastEvent. Per le trasmissioni TV e cinematografiche, fornisci url nell'entità Movie, TVSeries o TVEpisode sottostante.
• (Sport) Non includere entità url su SportsEvent. Fornisci i link di riproduzione utilizzando SportsEvent.potentialAction.
• (TV in diretta e sport) Assicurati che BroadcastEvent.@id sia diverso da @id dell'entità Movie, TVSeries, TVEpisode o SportsEvent di riferimento.

Raccogli l'ID, l'URL e il nome

Segui questi passaggi:

1. Raccogli i nomi dei contenuti del tuo catalogo.
2. Identifica gli URL canonici dei contenuti. (Ti consigliamo di utilizzare il url dei contenuti come @id.)