Propiedades de lenguaje de marcado del contenido de programas de TV

En esta sección, se proporcionan los detalles de las propiedades de 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 información.

Tabla de especificaciones

TVSeries

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
    .
  • Donde"xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en TVSeries.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser 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 hacer coincidir 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 que funcione y que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre del programa.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) que represente, en el nivel más general o abstracto, una obra de cine o televisión.

Por ejemplo, el titleEIDR 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 acción 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 LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de Varios idiomas y regiones.
sameAs URL Muy recomendable ¿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 Es el idioma original de la serie en formato BCP 47.
genre Texto Es una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palabras clave o 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 recomendable ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido por parte de un publicador, 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, además, incluye dónde y cuándo.

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

Para un PublicationEvent, esta es la región en la que se publicó el contenido.

Para FeaturedEvent y ExclusiveEvent, esta es la región en la que el contenido es destacado o exclusivo.

Usa los códigos ISO 3166 para los países. Para indicar todos los lugares del 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 una película se estrenó por primera vez en cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio de la exclusividad o la publicación destacada de la entidad.
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 destacó la entidad.

Si el contenido es exclusivo o destacado de forma perpetua, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o persona que publicó esta entidad.
description Texto Muy recomendable ¿Por qué? Un resumen del programa. Se prefieren los sinopsis de la trama a los resúmenes de hechos. Tiene un límite de 300 caracteres.
actor Person, PerformingGroup o PerformanceRole Muy recomendable ¿Por qué? Es un array de los miembros del elenco de la serie. Consulta la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Son los directores del programa.
producer Organization o Person Muy recomendable ¿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 tráiler. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Es el idioma del tráiler en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción o las fuentes autorizadas correspondientes.
trailer.regionsAllowed Place Indica 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 recomendable ¿Por qué? - ID externo o algún otro ID que identifica esta entidad de forma inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendable ¿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 el resto del 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 indica una mayor popularidad.
popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como 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 clasificaciones 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, muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación del contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • La agencia de calificación se agrega al principio de la calificación con un espacio en blanco en el medio. Por ejemplo, una clasificación "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse 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 obtener una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la calificación.
contentRating.advisoryCode Texto Es el código de advertencia para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual y V = Violencia.

TVEpisode

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
    .
  • Donde"xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en TVEpisode.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser 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 hacer coincidir 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 que funcione y que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es el nombre del episodio.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de representación de varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) que represente, en el nivel más general o abstracto, una obra de cine o televisión.

Por ejemplo, el titleEIDR 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 recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) 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 títuloEIDR 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 Es el idioma original de la serie 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 los 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/my_favorite_tv_show) y adjúntalo a un campo de consulta de marcador de posición (por ejemplo, ?season1) para crear un partOfSeason.@id único (por ejemplo, http://www.example.com/my_favorite_tv_show?season1).
  • Establece partOfSeason.seasonNumber en 1.
partOfSeason.@type Texto Obligatorio: Siempre se establece 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: Es la serie de TV a la que pertenece el episodio.
partOfSeries.@type Texto Obligatorio: Siempre se establece 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 acción 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 LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de Varios idiomas y regiones.
sameAs Muy recomendable ¿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 la duración del episodio en formato ISO 8601. Usa el formato "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendable ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido por parte de un publicador, 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, además, incluye dónde y cuándo.

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

Para un PublicationEvent, esta es la región en la que se publicó el contenido.

Para FeaturedEvent y ExclusiveEvent, esta es la región en la que el contenido es destacado o exclusivo.

Usa los códigos ISO 3166 para los países. Para indicar todos los lugares del 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 una película se estrenó por primera vez en cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio de la exclusividad o la publicación destacada de la entidad.
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 destacó la entidad.

Si el contenido es exclusivo o destacado de forma perpetua, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o persona que publicó esta entidad.
description Texto Muy recomendable ¿Por qué? Es un resumen del episodio. Se prefieren los sinopsis de la trama a los resúmenes de hechos. Tiene un límite de 300 caracteres.
genre Texto Es una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palabras clave o 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 recomendable ¿Por qué? Es un array de los miembros del elenco del episodio. Consulta la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Son los directores del episodio.
producer Organization o Person Muy recomendable ¿Por qué? Son los productores de la temporada.
image ImageObject Muy recomendable ¿Por qué? para Google TV: Varias imágenes relacionadas con el TVEpisode. 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 tráiler. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Es el idioma del tráiler en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción o las fuentes autorizadas correspondientes.
trailer.regionsAllowed Place Indica 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 Revisa las calificaciones del 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, muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación del contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • La agencia de calificación se agrega al principio de la calificación con un espacio en blanco en el medio. Por ejemplo, una clasificación "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse 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 obtener una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la calificación.
contentRating.advisoryCode Texto Es el código de advertencia para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual y V = Violencia.
identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o algún otro ID que identifica esta entidad de forma inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendable ¿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 el resto del 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 indica una mayor popularidad.
popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como 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 establece en ["http://schema.org", {"@language": "xx"}]
    .
  • Donde"xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es inglés.
@type Texto Obligatorio: Siempre se establece en TVSeason.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en tu catálogo.
  • El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser 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 hacer coincidir 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 que funcione y que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
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 de varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
titleEIDR Texto Muy recomendable ¿Por qué? - Un identificador de EIDR (registro de identificadores de entretenimiento) que represente, en el nivel más general o abstracto, una obra de cine o televisión.

Por ejemplo, el titleEIDR de la primera temporada de la serie de TV conocida como "Game of Thrones" 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: Es la serie de TV a la que pertenece esta temporada.
partOfSeries.@type Texto Obligatorio: Siempre se establece 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 acción 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 LiveTV.
Usa un array para especificar diferentes vínculos directos en varias regiones. Consulta el ejemplo de Varios idiomas y regiones.
sameAs URL Muy recomendable ¿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 recomendable ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido por parte de un publicador, 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, además, incluye dónde y cuándo.

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

Para un PublicationEvent, esta es la región en la que se publicó el contenido.

Para FeaturedEvent y ExclusiveEvent, esta es la región en la que el contenido es destacado o exclusivo.

Usa los códigos ISO 3166 para los países. Para indicar todos los lugares del 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 una película se estrenó por primera vez en cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio de la exclusividad o la publicación destacada de la entidad.
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 destacó la entidad.

Si el contenido es exclusivo o destacado de forma perpetua, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o persona que publicó esta entidad.
description Texto Muy recomendable ¿Por qué? Es un resumen de la temporada. Se prefieren los sinopsis de la trama a los resúmenes de hechos. Tiene un límite de 300 caracteres.
actor [Person o PerformingGroup o PerformanceRole Muy recomendable ¿Por qué? Es un array de los miembros del elenco de la temporada. Consulta la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Es un array de los directores del programa.
producer Organization o Person Muy recomendable ¿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 relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palabras clave o 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 tráiler. Consulta el ejemplo de Trailer.
trailer.inLanguage Texto Es el idioma del tráiler en formato BCP 47.
trailer.url URL Es la URL de un avance alojado públicamente y subido por los estudios de producción o las fuentes autorizadas correspondientes.
trailer.regionsAllowed Place Indica 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 recomendable ¿Por qué? - ID externo o algún otro ID que identifica esta entidad de forma inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore PopularityScoreSpecification Muy recomendable ¿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 el resto del 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 indica una mayor popularidad.
popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como 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, muy recomendable en otros casos: Clasificación general del contenido. Si la clasificación del contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • La agencia de calificación se agrega al principio de la calificación con un espacio en blanco en el medio. Por ejemplo, una clasificación "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse 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 obtener una lista de las agencias de clasificación aceptadas.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la calificación.
contentRating.advisoryCode Texto Es el código de advertencia para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual y 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 el nombre de sus personajes y los roles que desempeñan en el programa de TV. En las siguientes secciones, se captura lo mismo, junto con algunos ejemplos que aclaran el uso.

Propiedad Tipo esperado Descripción
actor Person, PerformingGroup o PerformanceRole Muy recomendable ¿Por qué? : Es un array de los miembros del elenco.
  • Usa el tipo PerformanceRole cuando se conozca el rol interpretado y, de manera opcional, el nombre del personaje de los miembros del elenco. En este caso, el actor Person o PerformingGroup está incorporado en el objeto PerformanceRole.
  • Usa el tipo Person para indicar a los actores individuales o PerformingGroup para proporcionar detalles de los grupos o bandas musicales cuando se desconocen los roles que desempeñan los miembros del elenco.

Usa un array para representar varias personas, grupos de artistas o roles de interpretación.

Usa los tipos Person o PerformingGroup

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

Propiedad Tipo esperado Descripción
@type Person o PerformingGroup Obligatorio: Siempre se establece en Person o PerformingGroup.
@id URL Muy recomendable ¿Por qué? - Los actores o el identificador del grupo de interpretación en formato 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 artistas.
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se considerará una cadena opaca que no necesariamente debe ser 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 con 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 recomendable ¿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 establece en PerformanceRole.
roleName Texto Muy recomendable ¿Por qué? - Un rol que interpreta o desempeña el miembro del elenco. Consulta la lista de valores aceptables aquí.
characterName Texto Es el nombre de un personaje que interpreta un rol actoral o de actuación. No configures este campo si el tipo de actor es PerformingGroup.
actor Person o PerformingGroup Obligatorio :
  • Los miembros del elenco del contenido cuando se usa el tipo de datos Person.
  • Los grupos o bandas que interpretan el contenido cuando se usa el tipo de datos PerformingGroup
actor.@type Person o PerformingGroup Obligatorio: Siempre se establece en Person o PerformingGroup.
actor.@id URL Muy recomendable ¿Por qué? - El identificador del actor o grupo de artistas en formato 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 artistas.
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se considerará una cadena opaca que no necesariamente debe ser 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 con 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 recomendable ¿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 papel de cameo, también llamado aparición breve, es la aparición breve de una persona conocida en una obra de las 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 encuentra 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 hace referencia 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.

Por lo general, estos valores se aceptan 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 medios modernos, como el cine, la radio y la televisión.
"GuestStar" "Una estrella invitada es un actor que interpreta un papel ficticio y aparece en uno o varios 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 "Invitado" cuando el elenco tenga una actuación como invitado o sea un invitado en el programa. Los actores invitados solo se deben proporcionar a nivel del episodio y no se deben agregar a nivel de la TVSeries.
"Invitado" “Un invitado en un programa de entrevistas. Ten en cuenta que, si bien “GuestStar” es un papel ficticio, “Guest” es una aparición no ficticia.
“Presentador” Un anunciador es una persona que presenta los discursos de apertura y cierre del programa, presenta al presentador, a los concursantes o a los invitados famosos, describe los premios disponibles y prepara al público antes de la grabación y lo entretiene durante las pausas.
"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 o impresionista es un artista cuyo acto consiste en imitar sonidos, voces y gestos de celebridades y personajes de dibujos animados.
"Host" Es una persona que presenta, introduce o conduce programas de televisión, y que a menudo actúa como mediador entre el programa y el público. Por lo general, el "presentador" es un rol de no ficción.
"CoHost" Es una persona que organiza un evento o programa junto con 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 este no está disponible.
"Presentador de noticias" Es una 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” Un corresponsal o reportero en el lugar de los hechos suele ser 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 suele considerarse un experto en el campo del programa y se le asigna el rol de “juez” para criticar a los participantes que audicionan y participan en la competencia de la serie de TV.
"Panelista" Un miembro de un panel de debate o de asesoramiento de un programa de radio o televisión.
"Contestant" Un concursante en una competencia o un programa de juegos es una persona que participa en ellos.
"StoryNarrator" El narrador es una persona que narra algo, en especial un personaje que cuenta los eventos de una novela o un poema narrativo.
"MusicalArtist" "Un artista musical puede ser una persona, un grupo o un personaje ficticio que, por lo general, se presenta ante un público con regularidad o que grabó 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 musicales permanentes, y músicos o grupos musicales invitados a los programas.

Diferenciar entre un papel principal y uno secundario de un actor

Para diferenciar entre los actores principales o habituales y los invitados o secundarios en un programa de TV, agrega el elenco principal solo en las entidades TVSeries y agrega solo el elenco de invitados o 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

El rol del actor es desconocido

Cuando se desconoce el rol de un actor, te recomendamos que solo proporciones 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, te recomendamos que proporciones 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 de los roles de interpretación, te recomendamos que proporciones la información del actor con el tipo Person o PerformingGroup . En el otro caso en el que se conoce esta información, usa el tipo PerformanceRole. Estos tipos se pueden agregar juntos 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 ver los temas relacionados con estas propiedades: