Propiedades de lenguaje de marcado del contenido de programas de TV

En esta sección, se proporcionan los detalles de las propiedades del lenguaje de marcado del contenido para los tipos de entidades TVSeries, TVEpisode y TVSeason.

Proporcionar TVSeason como una entidad completa es opcional. Consulta la sección Relaciones entre TVSeries, TVSeason y TVEpisode para obtener más detalles.

Tabla de especificaciones

TVSeries

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe establecer en ["http://schema.org", {"@language": "xx"}]
.
  • Donde"xx" representa el idioma de las cadenas en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, incluso si el idioma de los subtítulos o el doblaje está en inglés.
@type Texto Obligatorio: Siempre se debe establecer en TVSeries.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una cadena opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio: Es la URL canónica del contenido, que Google usa para correlacionar el contenido de tu feed con el contenido de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica activa que Google pueda rastrear.
Para el vínculo directo de reproducción, consulta la propiedad urlTemplate del objeto target.
name Texto Obligatorio: Es el nombre del programa.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de varias regiones y varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa, en el nivel más general o abstracto, una obra cinematográfica o televisiva.

Por ejemplo, el EIDR del título de la serie de TV conocida como "Game of Thrones" es "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de marcado de acción que proporciona los detalles de la acción.
  • Si el contenido está disponible en video on demand (VoD), esta propiedad es obligatoria. El objeto de marcado de Action debe proporcionar el vínculo directo del contenido.
  • Si el contenido está disponible en un canal de LiveTV, esta propiedad es opcional. En su lugar, la entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVSeries puede estar disponible en VoD y en LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de varias regiones y varios idiomas.
sameAs URL Muy recomendada ¿Por qué? Es la URL de una página web de referencia que puede identificar el programa, por ejemplo, la página de Wikipedia del programa. Debe ser diferente de la propiedad url.
inLanguage Texto Altamente recomendado: Idioma original de la serie en formato BCP 47.
genre Texto Es una lista ordenada de todos los géneros pertinentes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Son las palabras clave o las etiquetas que se usan para describir este contenido. También se permite un array de palabras clave. Por ejemplo, ["feature, biography"] puede ser un array de palabras clave para describir el contenido.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido por parte de un editor, como la fecha de lanzamiento original en cines de una película.

Además, usa FeaturedEvent para indicar que tu servicio comercializa este contenido como original, destacado, especial, etcétera.

ExclusiveEvent especifica que tu servicio tiene derechos de distribución exclusivos y dónde y cuándo.

Consulta la sección de ejemplos para obtener detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de configurar siempre esta propiedad en uno de los siguientes valores:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas a este evento.

En el caso de PublicationEvent, es la región en la que se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región en la que el contenido es destacado o exclusivo.

Usa códigos ISO 3166 para los países. Para indicar que es en todo el mundo, configúralo como EARTH.
releasedEvent.startDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Es la fecha de inicio de la publicación de la entidad.

En el caso de un PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha en que se estrenó una película en los cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en la que la entidad es exclusiva o destacada.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

En el caso de ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

En el caso de FeaturedEvent, representa la última fecha en la que el proveedor destaca la entidad.

Si el contenido es perpetuamente exclusivo o destacado, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o la persona que publicó esta entidad.
description Texto Muy recomendada ¿Por qué? Sinopsis del programa Se prefieren las sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
actor Person, PerformingGroup o PerformanceRole Muy recomendada ¿Por qué? Es un array de los miembros del elenco de la serie. Consulta la guía de modelado aquí.
director Persona Muy recomendada ¿Por qué? Son los directores del programa.
producer Organization o Person Muy recomendada ¿Por qué? Son los productores del programa.
image ImageObject Obligatorio para Google TV: Son las imágenes relacionadas con la serie de TV. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de imagen.
trailer.description Texto Es la descripción del avance. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Altamente recomendado: Es el idioma del avance en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción respectivos o las fuentes autorizadas.
trailer.regionsAllowed Place Son las regiones en las que se permite el contenido multimedia. Si no se especifica, se supone que está permitido en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendada ¿Por qué? - ID externo o de otro tipo que identifica esta entidad de manera inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendada ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta significa mayor popularidad.
popularityScore.eligibleRegion País Regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, se debe establecer en EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH)
review Revisión Revisa las calificaciones de la serie de TV
review.reviewRating Calificación Obligatorio si se proporciona review Se usa para especificar la calificación que se otorga en la opinión.
contentRating Text o Rating Obligatorio para el contenido para adultos y muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación de contenido se proporciona en forma de cadena de texto, se aceptan dos variaciones:
  • Es la agencia de calificación que se antepone a la calificación con un espacio en blanco entre ellas. Por ejemplo, la clasificación "TV-MA" de la agencia "TVPG" en EE.UU. se debe describir como "TVPG TV-MA". Consulta la lista de agencias.
  • Un valor de "RATING NOT KNOWN" (sin distinción entre mayúsculas y minúsculas) para indicar que no conoces la clasificación del contenido.
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de clasificación. Consulta la página Agencias de clasificación de contenido para ver una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la clasificación.
contentRating.advisoryCode Texto Es el código de advertencia del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual, V = Violencia.

TVEpisode

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe establecer en ["http://schema.org", {"@language": "xx"}]
.
  • Donde"xx" representa el idioma de las cadenas en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, incluso si el idioma de los subtítulos o el doblaje está en inglés.
@type Texto Obligatorio: Siempre se debe establecer en TVEpisode.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una cadena opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio: Es la URL canónica del contenido, que Google usa para correlacionar el contenido de tu feed con el contenido de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica activa que Google pueda rastrear.
Para el vínculo directo de reproducción, consulta la propiedad urlTemplate del objeto target.
name Texto Obligatorio: Es el nombre del episodio.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Representación en varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa, en el nivel más general o abstracto, una obra cinematográfica o televisiva.

Por ejemplo, el EIDR del título del primer episodio de la primera temporada de la serie de TV conocida como "Game of Thrones" es "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Texto Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa una edición específica de una obra cinematográfica o televisiva.

Por ejemplo, el primer episodio de la primera temporada de la serie de TV conocida como "Game of Thrones", cuyo EIDR de título es "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", tiene una edición, p.ej., "10.5240/FB97-C847-2969-D0AB-ECD1-C". La propiedad

titleEIDR es obligatoria cuando se proporciona editEIDR.
inLanguage Texto Altamente recomendado: Idioma original del episodio en formato BCP 47.
episodeNumber Número entero Obligatorio: Es el número que indica la posición de este episodio en el orden de episodios de una temporada. episodeNumber debe reiniciarse para cada temporada, es decir, el primer episodio de cada temporada debe ser 1.
partOfSeason TVSeason Obligatorio: Es la temporada de TV a la que pertenece este episodio.

Incluso si un TVEpisode no tiene un TVSeason correspondiente, debes proporcionar las propiedades partOfSeason.@id y partOfSeason.seasonNumber. Una solución alternativa es la siguiente:
  • Toma partofSeries.@id (por ejemplo, http://www.example.com/mi_programa_de_TV_favorito) y adjunta un campo de consulta de marcador de posición (por ejemplo, ?temporada1) para crear un partOfSeason.@id único (por ejemplo, http://www.example.com/mi_programa_de_TV_favorito?temporada1).
  • Establece partOfSeason.seasonNumber en 1.
partOfSeason.@type Texto Obligatorio: Siempre se debe establecer en TVSeason.
partOfSeason.@id URL Obligatorio: Es el @id del TVSeason del que forma parte este episodio.
partOfSeason.seasonNumber Número entero Obligatorio: Es el número que indica la posición de esta temporada en el orden de las temporadas de la serie de TV.
partOfSeries TVSeries Obligatorio: Serie de TV a la que pertenece este episodio.
partOfSeries.@type Texto Obligatorio: Siempre se debe establecer en TVSeries.
partOfSeries.@id URL Obligatorio: Es el @id del TVSeries del que forma parte este episodio.
partOfSeries.name Texto Obligatorio: Es el nombre de la serie de TV.
partOfSeries.sameAs Texto Es la URL de una página web de referencia que puede identificar el programa, por ejemplo, la página de Wikipedia del programa. Debe ser diferente de la propiedad url.
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de marcado de acción que proporciona los detalles de la acción.
  • Si el contenido está disponible en video on demand (VoD), esta propiedad es obligatoria. El objeto de marcado de Action debe proporcionar el vínculo directo del contenido.
  • Si el contenido está disponible en un canal de LiveTV, esta propiedad es opcional. En su lugar, la entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVEpisode puede estar disponible en VoD y en LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de varias regiones y varios idiomas.
sameAs Muy recomendada ¿Por qué? URL Es la URL de una página web de referencia que puede identificar el episodio, por ejemplo, la página de Wikipedia del episodio. Debe ser diferente de la propiedad url.
duration Duración Es el tiempo de ejecución del episodio en formato ISO 8601. Usa el formato "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido por parte de un editor, como la fecha de lanzamiento original en cines de una película.

Además, usa FeaturedEvent para indicar que tu servicio comercializa este contenido como original, destacado, especial, etcétera.

ExclusiveEvent especifica que tu servicio tiene derechos de distribución exclusivos y dónde y cuándo.

Consulta la sección de ejemplos para obtener detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de configurar siempre esta propiedad en uno de los siguientes valores:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas a este evento.

En el caso de PublicationEvent, es la región en la que se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región en la que el contenido es destacado o exclusivo.

Usa códigos ISO 3166 para los países. Para indicar que es en todo el mundo, configúralo como EARTH.
releasedEvent.startDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Es la fecha de inicio de la publicación de la entidad.

En el caso de un PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha en que se estrenó una película en los cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en la que la entidad es exclusiva o destacada.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

En el caso de ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

En el caso de FeaturedEvent, representa la última fecha en la que el proveedor destaca la entidad.

Si el contenido es perpetuamente exclusivo o destacado, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o la persona que publicó esta entidad.
description Texto Muy recomendada ¿Por qué? Es una sinopsis del episodio. Se prefieren las sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
genre Texto Es una lista ordenada de todos los géneros pertinentes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Son las palabras clave o las etiquetas que se usan para describir este contenido. También se permite un array de palabras clave. Por ejemplo, ["feature, biography"] puede ser un array de palabras clave para describir el contenido.
actor Person, PerformingGroup o PerformanceRole Muy recomendada ¿Por qué? Es un array de los miembros del elenco del episodio. Consulta la guía de modelado aquí.
director Persona Muy recomendada ¿Por qué? Son los directores del episodio.
producer Organization o Person Muy recomendada ¿Por qué? Son los productores de la temporada.
image ImageObject Altamente recomendado ¿Por qué? para Google TV: Varias imágenes relacionadas con el episodio de TV. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de imagen.
trailer.description Texto Es la descripción del avance. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Altamente recomendado: Es el idioma del avance en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción respectivos o las fuentes autorizadas.
trailer.regionsAllowed Place Son las regiones en las que se permite el contenido multimedia. Si no se especifica, se supone que está permitido en todas partes. Especifica los países en formato ISO 3166.
review Revisión Calificaciones de la opinión sobre el episodio de TV
review.reviewRating Calificación Obligatorio si se proporciona review Se usa para especificar la calificación que se otorga en la opinión.
contentRating Text o Rating Obligatorio para el contenido para adultos y muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación de contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • Agencia de calificación antepuesta a la calificación con un espacio en blanco entre ellas. Por ejemplo, la clasificación "TV-MA" de la agencia "TVPG" en EE.UU. se debe describir como "TVPG TV-MA". Consulta la lista de agencias.
  • Un valor de "RATING NOT KNOWN" (sin distinción entre mayúsculas y minúsculas) para indicar que no conoces la clasificación del contenido.
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de clasificación. Consulta la página Agencias de clasificación de contenido para ver una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la clasificación.
contentRating.advisoryCode Texto Es el código de advertencia del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual, V = Violencia.
identifier PropertyValue Muy recomendada ¿Por qué? - ID externo o de otro tipo que identifica esta entidad de manera inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendada ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta significa mayor popularidad.
popularityScore.eligibleRegion País Regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, se debe establecer en EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH)

TVSeason

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe establecer en ["http://schema.org", {"@language": "xx"}]
.
  • Donde"xx" representa el idioma de las cadenas en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, incluso si el idioma de los subtítulos o el doblaje está en inglés.
@type Texto Obligatorio: Siempre se debe establecer en TVSeason.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una cadena opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio: Es la URL canónica del contenido, que Google usa para correlacionar el contenido de tu feed con el contenido de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica activa que Google pueda rastrear.
Para el vínculo directo de reproducción, consulta la propiedad urlTemplate del objeto target.
name Texto Obligatorio: Es el nombre de esta temporada de TV.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Representación en varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendada ¿Por qué? - Un identificador EIDR (Entertainment Identifier Registry) que representa, en el nivel más general o abstracto, una obra cinematográfica o televisiva.

Por ejemplo, el EIDR del título de la primera temporada de la serie de TV conocida como "Juego de Tronos" es "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Número entero Obligatorio: Es el número que indica la posición de esta temporada en el orden de las temporadas de la serie de TV.
partOfSeries TVSeries Obligatorio: Serie de TV a la que pertenece esta temporada.
partOfSeries.@type Texto Obligatorio: Siempre se debe establecer en TVSeries.
partOfSeries.@id URL Obligatorio: Es el @id del TVSeries del que forma parte esta temporada.
partOfSeries.name Texto Obligatorio: Es el nombre de la serie de TV.
partOfSeries.sameAs Texto Es la URL de una página web de referencia que puede identificar el programa, por ejemplo, la página de Wikipedia del programa. Debe ser diferente de la propiedad url.
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de marcado de acción que proporciona los detalles de la acción.
  • Si el contenido está disponible en video on demand (VoD), esta propiedad es obligatoria. El objeto de marcado de Action debe proporcionar el vínculo directo del contenido.
  • Si el contenido está disponible en un canal de LiveTV, esta propiedad es opcional. En su lugar, la entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVSeason puede estar disponible en VoD y en LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de varias regiones y varios idiomas.
sameAs URL Muy recomendada ¿Por qué? Es la URL de una página web de referencia que puede identificar la temporada, por ejemplo, la página de Wikipedia de la temporada. Debe ser diferente de la propiedad url.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido por parte de un editor, como la fecha de lanzamiento original en cines de una película.

Además, usa FeaturedEvent para indicar que tu servicio comercializa este contenido como original, destacado, especial, etcétera.

ExclusiveEvent especifica que tu servicio tiene derechos de distribución exclusivos y dónde y cuándo.

Consulta la sección de ejemplos para obtener detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de configurar siempre esta propiedad en uno de los siguientes valores:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas a este evento.

En el caso de PublicationEvent, es la región en la que se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región en la que el contenido es destacado o exclusivo.

Usa códigos ISO 3166 para los países. Para indicar que es en todo el mundo, configúralo como EARTH.
releasedEvent.startDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Es la fecha de inicio de la publicación de la entidad.

En el caso de un PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha en que se estrenó una película en los cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en la que la entidad es exclusiva o destacada.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

En el caso de ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

En el caso de FeaturedEvent, representa la última fecha en la que el proveedor destaca la entidad.

Si el contenido es perpetuamente exclusivo o destacado, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o la persona que publicó esta entidad.
description Texto Muy recomendada ¿Por qué? Es una sinopsis de la temporada. Se prefieren las sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
actor [Person o PerformingGroup o PerformanceRole] Muy recomendada ¿Por qué? Es un array de los miembros del elenco de la temporada. Consulta la guía de modelado aquí.
director Persona Muy recomendada ¿Por qué? Es un array de los directores del programa.
producer Organization o Person Muy recomendada ¿Por qué? Son los productores de la temporada.
image ImageObject Son las imágenes relacionadas con la temporada de TV. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de imagen.
genre Texto Es una lista ordenada de todos los géneros pertinentes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Son las palabras clave o las etiquetas que se usan para describir este contenido. También se permite un array de palabras clave. Por ejemplo, ["feature, biography"] puede ser un array de palabras clave para describir el contenido.
trailer.description Texto Es la descripción del avance. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Altamente recomendado: Es el idioma del avance en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción respectivos o las fuentes autorizadas.
trailer.regionsAllowed Place Son las regiones en las que se permite el contenido multimedia. Si no se especifica, se supone que está permitido en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendada ¿Por qué? - ID externo o de otro tipo que identifica esta entidad de manera inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendada ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta significa mayor popularidad.
popularityScore.eligibleRegion País Regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, se debe establecer en EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH)
review Revisión Revisa las calificaciones de la temporada de TV
review.reviewRating Calificación Obligatorio si se proporciona review Se usa para especificar la calificación que se otorga en la opinión.
contentRating Text o Rating Obligatorio para el contenido para adultos y muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación de contenido se proporciona en forma de cadena de texto, se aceptan dos variaciones:
  • Es la agencia de calificación que se antepone a la calificación con un espacio en blanco entre ellas. Por ejemplo, la clasificación "TV-MA" de la agencia "TVPG" en EE.UU. se debe describir como "TVPG TV-MA". Consulta la lista de agencias.
  • Un valor de "RATING NOT KNOWN" (sin distinción entre mayúsculas y minúsculas) para indicar que no conoces la clasificación del contenido.
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de clasificación. Consulta la página Agencias de clasificación de contenido para ver una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la clasificación.
contentRating.advisoryCode Texto Es el código de advertencia del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual, V = Violencia.

Especificaciones del actor

La propiedad actor en los tipos de entidades TVSeries, TVEpisode y TVSeason te permite especificar más detalles sobre los actores, incluidos los nombres de sus personajes y los roles que desempeñan en el programa de TV. En las siguientes secciones, se explica lo mismo, junto con algunos ejemplos que aclaran el uso.

Propiedad Tipo esperado Descripción
actor Person, PerformingGroup o PerformanceRole Muy recomendada ¿Por qué? : Es un array de los miembros del elenco.
  • Usa el tipo PerformanceRole cuando se conozca el rol interpretado y (opcionalmente) el nombre del personaje de los miembros del elenco. En este caso, el actor Person o PerformingGroup está incorporado dentro del objeto PerformanceRole.
  • Usa el tipo Person para indicar los actores individuales o PerformingGroup para proporcionar detalles sobre los grupos o bandas de artistas cuando se desconocen los roles que interpretan los miembros del elenco.

Usa un array para representar varias Personas, PerformingGroups o PerformanceRoles.

Usa los tipos Person o PerformingGroup

Proporciona las siguientes propiedades cuando se use el tipo Person o PerformingGroup.

Propiedad Tipo esperado Descripción
@type Person o PerformingGroup Obligatorio: Siempre se debe establecer en Person o PerformingGroup
@id URL Muy recomendada ¿Por qué? - El identificador de los actores o el grupo de artistas en formato de URI; por ejemplo, https://example.com/actor/abc. @id debe cumplir con los siguientes requisitos:
  • Es único a nivel global en todo tu catálogo por actor o grupo de interpretación.
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se tratará como una cadena opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • Tu organización debe ser propietaria del dominio que se usa para el valor @id.

Ten en cuenta que el @id que se usa en la propiedad actor debe usarse de manera coherente en todo el feed. Por ejemplo, si hay dos películas en las que aparece el mismo actor, el valor de @id debe ser el mismo en estos dos objetos de actor.

name Texto Obligatorio: Es el nombre del actor, la actriz, el miembro del elenco o el grupo de artistas.
sameAs URL Muy recomendada ¿Por qué? - Una URL a una página web de referencia que pueda identificar al actor o al grupo de artistas. Por ejemplo, la página de Wikipedia del actor. Debe ser diferente de la propiedad @id.

Usa el tipo PerformanceRole

Proporciona las siguientes propiedades cuando se usa el tipo PerformanceRole.

Propiedad Tipo esperado Descripción
@type PerformanceRole Obligatorio: Siempre se debe establecer en PerformanceRole.
roleName Texto Muy recomendada ¿Por qué? - Un papel interpretado o desempeñado por el miembro del elenco Consulta la lista de valores aceptables aquí.
characterName Texto Es el nombre de un personaje que se interpreta en algún rol de actuación o interpretación. No configures este campo si el tipo de actor es PerformingGroup.
actor Person o PerformingGroup Obligatorio -
  • Miembros del elenco del contenido cuando se usa el tipo de datos Person.
  • Son los grupos o bandas intérpretes del contenido cuando se usa el tipo de datos PerformingGroup.
actor.@type Person o PerformingGroup Obligatorio: Siempre se debe establecer en Person o PerformingGroup
actor.@id URL Muy recomendada ¿Por qué? - Es el identificador del actor o grupo de artistas en formato de URI, por ejemplo, https://example.com/actor/abc. @id debe cumplir con los siguientes requisitos:
  • Es único a nivel global en todo tu catálogo por actor o grupo de interpretación.
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se tratará como una cadena opaca y no es necesario que sea un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • Tu organización debe ser propietaria del dominio que se usa para el valor @id.

Ten en cuenta que el @id que se usa en la propiedad actor debe usarse de manera coherente en todo el feed. Por ejemplo, si hay dos películas en las que aparece el mismo actor, el valor de @id debe ser el mismo en estos dos objetos de actor.

actor.name Texto Obligatorio: Es el nombre del actor, la actriz, el miembro del elenco o el grupo de artistas.
actor.sameAs URL Muy recomendada ¿Por qué? - Una URL a una página web de referencia que pueda identificar al actor o al grupo de artistas. Por ejemplo, la página de Wikipedia del actor. Debe ser diferente de la propiedad actor.@id.

Nombres de roles aceptables

Estos valores requieren que actor.@type sea Person.

Valor roleName Descripción
“Cameo” Un cameo es una aparición breve de una persona conocida en una obra de artes escénicas.
"VoiceActor" Una interpretación de voz es aquella en la que se usa la voz del actor, pero este no aparece en pantalla. Esto se ve con mayor frecuencia en la animación, pero también ocurre cuando la voz de un actor se dobla sobre el discurso de otro.
"Doble" Un doble es una persona que reemplaza a otro actor de modo que no se muestre su rostro.
"MotionCaptureActor" Un MotionCaptureActor se refiere a una persona que graba las acciones de actores humanos y usa esa información para animar modelos de personajes digitales en animación por computadora en 2D o 3D.

Estos valores se aceptan generalmente para los tipos Person y PerformingGroup.

Valor roleName Descripción
"Actor" Un actor o una actriz es una persona que interpreta a un personaje en una actuación en el medio tradicional del teatro o en los medios modernos, como el cine, la radio y la televisión.
"GuestStar" "Un invitado especial es un actor que interpreta un papel ficticio y aparece en uno o algunos episodios. En algunos casos, una estrella invitada puede interpretar a un personaje recurrente importante y aparecer muchas veces en una serie, a pesar de no ser miembro del elenco principal. Establece el valor en "GuestStar" cuando el elenco tenga una participación especial o sea invitado en el programa. Los artistas invitados solo se deben proporcionar a nivel del episodio y no se deben agregar a nivel de la serie de TV.
"Invitado" "Un invitado en un programa de entrevistas. Ten en cuenta que, si bien "GuestStar" es un rol ficticio, "Guest" es una aparición no ficticia.
“Anunciador” Un locutor es una persona que presenta y cierra el programa, presenta al anfitrión, a los concursantes o a los invitados famosos, describe los premios disponibles y entretiene al público antes de la grabación y durante los descansos.
"Comentarista" Un comentarista proporciona comentarios en tiempo real sobre un partido o evento, por lo general, durante una transmisión en vivo.
"Impresionista" Un imitador es un artista cuya actuación consiste en imitar los sonidos, las voces y los manierismos de celebridades y personajes de dibujos animados.
"Host" Persona que presenta o conduce programas de televisión y que, a menudo, actúa como mediadora entre el programa y el público. Por lo general, el "anfitrión" es un rol de no ficción.
"CoHost" Persona que organiza un evento o programa junto con otra u otras personas.
"GuestHost" Un presentador invitado es un presentador, por lo general de un programa de entrevistas, que presenta el programa en lugar del presentador habitual cuando no está disponible.
"Presentador de noticias" Persona que presenta o informa al público sobre noticias y eventos que ocurren a nivel local, nacional e internacional a través de un programa de noticias de TV.
"Corresponsal" Por lo general, un corresponsal o reportero en el lugar es un periodista o comentarista de una revista, o un agente que contribuye con informes a un periódico, a noticias de radio o televisión, o a otro tipo de empresa, desde una ubicación remota, a menudo distante.
"ShowJudge" Un juez es una persona que a menudo se considera experta en el campo del programa y se le asigna el rol de "juez" para criticar a los concursantes que audicionan y participan en la competencia de la serie de TV.
"Panelista" Ser miembro de un panel de debate o asesoramiento de un programa de radio o televisión
"Participante" Un concursante en un concurso o programa de juegos es una persona que participa en él.
"StoryNarrator" Un narrador es una persona que narra algo, especialmente un personaje que relata los eventos de una novela o un poema narrativo.
"MusicalArtist" "Un artista musical puede ser una persona, un grupo o un personaje ficticio que suele presentarse ante el público de forma regular o que ha grabado pistas o álbumes musicales. Los compositores y letristas solo deben tener este tipo si los créditos de alguna obra musical implican que también contribuyen como intérpretes principales. Este tipo se puede usar para asociar músicos o grupos de músicos permanentes, y músicos o grupos de músicos invitados a los programas.

Cómo diferenciar entre el papel principal y el secundario de un actor

Para diferenciar entre los actores principales o habituales y los actores invitados o secundarios en un programa de TV, agrega el elenco principal solo en las entidades TVSeries y agrega solo el elenco invitado o el elenco con roles secundarios en las entidades TVEpisode. Asegúrate de que el elenco principal o habitual no se agregue a las entidades TVEpisode.

Ejemplos

Ejemplo de TVSeries, TVEpisode y TVSeason

TVSeries 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Ejemplos de propiedades Actor

Se desconoce el rol del actor

Cuando se desconoce el rol de un actor, recomendamos proporcionar la información del actor con el tipo Person o PerformingGroup.

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Se conoce el rol del actor

Cuando se conoce el rol de un actor, recomendamos proporcionar la información del actor con el tipo PerformanceRole.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Roles conocidos para un subconjunto de actores

Cuando no se conocen los metadatos del rol de interpretación, recomendamos proporcionar la información del actor con el tipo Person o PerformingGroup. Para el otro caso en el que se conoce esta información, usa el PerformanceRole tipo. Estos tipos se pueden agregar en el mismo array.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades: