Cómo recopilar el ID, la URL y el nombre de tu contenido

Por lo general, las entidades de contenido de tu catálogo requieren las siguientes propiedades:

  • @id: Es un identificador global de la entidad.
  • url: Es una URL canónica para el contenido. No uses url en entidades BroadcastEvent, SportsEvent ni de selección de canales (TelevisionChannel y CableOrSatelliteService).
  • name: Es el nombre del contenido.

A continuación, se muestra un ejemplo de @id, url y name:

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

Identificador

Un identificador (@id) debe cumplir con los siguientes requisitos:

  • Debe ser único a nivel global en todo tu catálogo.
    • Por ejemplo, no uses el mismo @id para un TVSeries y un TVSeason.
  • Estático
    • No podrás cambiar @id más adelante.
  • En forma de identificador de recursos unificado (URI)
    • Si el identificador local (ID) de tu contenido no tiene el formato de un URI, antepón tu dominio al ID para cumplir con este requisito. Por ejemplo, si el ID de tu contenido es 1234abc y tu dominio es https://example.com, @id puede ser https://example.com/1234abc.
    • No es necesario que @id sea una URL que funcione, solo debe tener el formato de un URI.
    • El dominio que se usa en @id (por ejemplo, https://example.com) debe ser propiedad de tu organización.

Debido a que el url de una entidad cumple con todos los requisitos como identificador (es decir, es único a nivel global, estático y tiene el formato de un URI), te recomendamos que uses el url de una entidad como @id.

URL canónica

Una URL canónica (url) ayuda a Google a conciliar con precisión el contenido de tu catálogo con el de las bases de datos de Google.

"Una URL canónica es la URL de la página que Google identifica como la más representativa de un conjunto de páginas duplicadas de tu sitio. Por ejemplo, si tienes varias URLs para la misma página (como example.com?dress=1234 y example.com/dresses/1234), Google seleccionará una de ellas como la canónica". (Fuente: Consolida las URLs duplicadas)

Los siguientes son los requisitos para la URL canónica:

  • url debe ser único a nivel global.
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
  • (Solo para acciones de escucha) url debe apuntar a una página de descripción de contenido que no esté bloqueada por un muro de pago.
  • (TV en vivo) No incluyas url en las entidades BroadcastEvent. Para las transmisiones de TV y películas, proporciona url en la entidad Movie, TVSeries o TVEpisode subyacente.
  • (Deportes) No incluyas url en entidades SportsEvent. Proporciona vínculos de reproducción con SportsEvent.potentialAction.
  • (TV en vivo y deportes) Asegúrate de que BroadcastEvent.@id sea distinto del @id de la entidad Movie, TVSeries, TVEpisode o SportsEvent a la que se hace referencia.

Recopila el ID, la URL y el nombre

Puedes hacer lo siguiente:

  1. Reúne los nombres del contenido de tu catálogo.
  2. Identifica las URLs canónicas del contenido. (Te recomendamos que uses el url del contenido como su @id).