Propiedades del lenguaje de marcado de contenido de programas de TV

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

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

Tabla de especificaciones

TVSeries

Propiedad Tipo esperado Descripción
@context Text Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
  • Donde"xx" representa el idioma de las strings 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, aunque el idioma de los subtítulos sea en inglés.
@type Text 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:
  • Único a nivel global en el catálogo
  • El ID debe ser estable y mantener el mismo formato con el paso del tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Debido a que la 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: La URL canónica del contenido, que Google utiliza 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 Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta en su lugar la propiedad urlTemplate del objeto target.
name Text Obligatorio: 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 de idioma-país).
titleEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente, de forma más general o abstracta, una obra de película o televisión.

Por ejemplo, el título EIDR para la serie de TV conocido como “Game of Thrones” es “10.5240/C1B5-3BA1-8991-A571-8472-W”.
potentialAction WatchAction Obligatorio si corresponde: Es un objeto de lenguaje de marcado de acciones 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 lenguaje 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. La entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVSeries puede estar disponible en VoD y en LiveTV.
Use 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é? Corresponde a una URL a 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 Text Corresponde al idioma original de la serie en formato BCP 47.
genre Text Una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Text 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é? - Un objeto PublicationEvent se usa para especificar el lanzamiento original (global o local) de un publicador, como la fecha de lanzamiento original de una película.

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

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

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

Para un PublicationEvent, es la región donde se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región donde el contenido se muestra o es exclusivo.

Usa códigos ISO 3166 para los países. Para indicar en cualquier lugar 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.

Para un PublicationEvent, esto indica la fecha de lanzamiento inicial de esta entidad, como la fecha de estreno en cines de una película por primera vez.

Para ExclusiveEvent y FeaturedEvent, esto representa la fecha de inicio de la creación o exhibición de la entidad.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

Para ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

Para FeaturedEvent, esto representa la última fecha en la que el proveedor presenta la entidad.

Si el contenido es exclusivo o se muestra de forma permanente, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organización o Persona Opcional: La organización o la persona que publicó esta entidad.
description Text Muy recomendable ¿Por qué? Una sinopsis del programa. Se prefiere la sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
actor Person, PerformingGroup o PerformanceRole Muy recomendable ¿Por qué? Un array de los miembros del reparto de la serie. Consulte la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Los directores del programa
producer Organización o Persona Muy recomendable ¿Por qué? Los productores del programa.
image ImageObject Obligatorio para Google TV: Son las imágenes relacionadas con la serie de TV. Si deseas obtener más detalles sobre las propiedades obligatorias y opcionales que debes incluir con image, consulta Propiedades de imágenes.
trailer.description Text Es la descripción del avance. Consulta el ejemplo de Avance.
trailer.inLanguage Text El idioma del avance en formato BCP 47.
trailer.url URL Una URL de un avance alojado públicamente y subido por estudios de producción respectivos o fuentes autorizadas
trailer.regionsAllowed Place Corresponde a las regiones donde se permite el contenido multimedia. Si no se especifica, se supone que se permite en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o de otro tipo que identifica inequívocamente esta entidad. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Text Siempre establecida en PopularityScoreSpecification.
popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala 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 las series de TV
review.reviewRating Calificación Obligatorio si se proporciona review. Se usa para especificar la clasificación que se otorga en la opinión.
contentRating Texto o Calificación Obligatorio para contenido para adultos; se recomienda en todo caso: Clasificación general del contenido. Si la clasificación del contenido se proporciona en una string de texto, se aceptan dos variaciones:
  • La agencia de calificación antepuesto a la calificación con un espacio en blanco en el medio. Por ejemplo, una calificación de "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse como "TVPG TV-MA". Consulte la lista de agencias.
  • Un valor de "CALIFICACIÓN NO SABE" (no distingue mayúsculas de minúsculas) para indicar que no conoce la clasificación del contenido.
contentRating.author Organización o texto Obligatorio si contentRating usa Rating: El nombre de la agencia de clasificación. Consulta la página Agencias de clasificación del contenido para obtener una lista de las agencias de calificación aceptadas.
contentRating.ratingValue Text Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Text Es el código de asesoramiento para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Dialogue, FV = Fantasy Violencia, L = Language, S = Sexual Content, V = Violencia.

TVEpisode

Propiedad Tipo esperado Descripción
@context Text Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
  • Donde"xx" representa el idioma de las strings 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, aunque el idioma de los subtítulos sea en inglés.
@type Text 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:
  • Único a nivel global en el catálogo
  • El ID debe ser estable y mantener el mismo formato con el paso del tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Debido a que la 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: La URL canónica del contenido, que Google utiliza 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 Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta en su lugar la propiedad urlTemplate del objeto target.
name Text Obligatorio: El nombre del episodio.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo Representación en varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par de idioma-país).
titleEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente, de forma más general o abstracta, una obra de película o televisión.

Por ejemplo, el título EIDR para el primer episodio de la primera temporada de TVSeries conocido como “Game of Thrones” es “10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”.
editEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente una edición o edición específica de una obra de cine o televisión.

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

La propiedad titleEIDR es obligatoria cuando se proporciona un EIDR de edición.
inLanguage Text Corresponde al idioma original de la serie en formato BCP 47.
episodeNumber Número entero Obligatorio: El número que indica la posición de este episodio en orden de temporada. episodeNumber debe reiniciarse cada temporada. Es decir, el primer episodio de cada temporada debe ser 1.
partOfSeason Temporada de TV Obligatorio: 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:
  • Usa partofSeries.@id (por ejemplo, http://www.example.com/my_favorite_tv_show) y adjunta 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).
  • Configura partOfSeason.seasonNumber en 1.
partOfSeason.@type Text Obligatorio: Siempre se establece en TVSeason.
partOfSeason.@id URL Obligatorio: Es el @id de los TVSeason de los que forma parte este episodio.
partOfSeason.seasonNumber Número entero Obligatorio: El número que indica la posición de esta temporada en el orden de las temporadas en la serie de TV.
partOfSeries TVSeries Obligatorio: La serie de TV a la que pertenece este episodio.
partOfSeries.@type Text Obligatorio: Siempre se establece en TVSeries.
partOfSeries.@id URL Obligatorio: Es el @id de los TVSeries de los que forma parte este episodio.
partOfSeries.name Text Obligatorio: El nombre de la serie de TV.
partOfSeries.sameAs Text Corresponde a una URL a 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 lenguaje de marcado de acciones 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 lenguaje 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. La entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVEpisode puede estar disponible en VoD y en LiveTV.
Use 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 Una URL a 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 Tiempo de ejecución del episodio en formato ISO 8601. Utilice el formato: "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendable ¿Por qué? - Un objeto PublicationEvent se usa para especificar el lanzamiento original (global o local) de un publicador, como la fecha de lanzamiento original de una película.

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

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

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

Para un PublicationEvent, es la región donde se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región donde el contenido se muestra o es exclusivo.

Usa códigos ISO 3166 para los países. Para indicar en cualquier lugar 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.

Para un PublicationEvent, esto indica la fecha de lanzamiento inicial de esta entidad, como la fecha de estreno en cines de una película por primera vez.

Para ExclusiveEvent y FeaturedEvent, esto representa la fecha de inicio de la creación o exhibición de la entidad.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

Para ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

Para FeaturedEvent, esto representa la última fecha en la que el proveedor presenta la entidad.

Si el contenido es exclusivo o se muestra de forma permanente, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organización o Persona Opcional: La organización o la persona que publicó esta entidad.
description Text Muy recomendable ¿Por qué? Una sinopsis del episodio. Se prefiere la sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
genre Text Una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Text 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é? Corresponde a la matriz de los miembros del reparto del episodio. Consulte la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Corresponde a los directores del episodio.
producer Organización o Persona Muy recomendable ¿Por qué? Los productores de la temporada.
image ImageObject Muy recomendado ¿Por qué? para Google TV: Varias imágenes relacionadas con TVEpisode. Si deseas obtener más detalles sobre las propiedades obligatorias y opcionales que debes incluir con image, consulta Propiedades de imágenes.
trailer.description Text Es la descripción del avance. Consulta el ejemplo de Avance.
trailer.inLanguage Text El idioma del avance en formato BCP 47.
trailer.url URL Una URL de un avance alojado públicamente y subido por estudios de producción respectivos o fuentes autorizadas
trailer.regionsAllowed Place Corresponde a las regiones donde se permite el contenido multimedia. Si no se especifica, se supone que se permite 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 clasificación que se otorga en la opinión.
contentRating Texto o Calificación Obligatorio para contenido para adultos; se recomienda en todo caso: Clasificación general del contenido. Si la clasificación del contenido se proporciona en una string de texto, se aceptan dos variaciones:
  • La agencia de calificación antepuesto a la calificación con un espacio en blanco en el medio. Por ejemplo, una calificación de "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse como "TVPG TV-MA". Consulte la lista de agencias.
  • Un valor de "CALIFICACIÓN NO SABE" (no distingue mayúsculas de minúsculas) para indicar que no conoce la clasificación del contenido.
contentRating.author Organización o texto Obligatorio si contentRating usa Rating: El nombre de la agencia de clasificación. Consulta la página Agencias de clasificación del contenido para obtener una lista de las agencias de calificación aceptadas.
contentRating.ratingValue Text Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Text Es el código de asesoramiento para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Dialogue, FV = Fantasy Violencia, L = Language, S = Sexual Content, V = Violencia.
identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o de otro tipo que identifica inequívocamente esta entidad. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Text Siempre establecida en PopularityScoreSpecification.
popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala 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 Text Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
  • Donde"xx" representa el idioma de las strings 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, aunque el idioma de los subtítulos sea en inglés.
@type Text 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:
  • Único a nivel global en el catálogo
  • El ID debe ser estable y mantener el mismo formato con el paso del tiempo (incluso si cambia la propiedad de URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Debido a que la 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: La URL canónica del contenido, que Google utiliza 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 Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta en su lugar la propiedad urlTemplate del objeto target.
name Text Obligatorio: El nombre de esta temporada de TV.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo Representación en varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par de idioma-país).
titleEIDR Text Muy recomendable ¿Por qué? - Un identificador EIDR (registro identificador de entretenimiento) que represente, de forma más general o abstracta, una obra de película o televisión.

Por ejemplo, el título EIDR de la primera temporada de TVSeries conocida como “Game of Thrones” es “10.5240/FD91-C72C-4161-FCBA-058B-1”.
seasonNumber Número entero Obligatorio: El número que indica la posición de esta temporada en el orden de las temporadas en la serie de TV.
partOfSeries TVSeries Obligatorio: La serie de TV a la que pertenece esta temporada.
partOfSeries.@type Text Obligatorio: Siempre se establece en TVSeries.
partOfSeries.@id URL Obligatorio: Es el @id de los TVSeries de los que forma parte esta temporada.
partOfSeries.name Text Obligatorio: El nombre de la serie de TV.
partOfSeries.sameAs Text Corresponde a una URL a 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 lenguaje de marcado de acciones 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 lenguaje 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. La entidad BroadcastService asociada proporciona el vínculo directo del canal.
  • Un TVSeason puede estar disponible en VoD y en LiveTV.
Use 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é? Una URL a 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é? - Un elemento PublicationEvent se usa para especificar el lanzamiento original (global o local) de un publicador, como la fecha de lanzamiento original de una película.

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

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

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

Para un PublicationEvent, es la región donde se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región donde el contenido se muestra o es exclusivo.

Usa códigos ISO 3166 para los países. Para indicar en cualquier lugar 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.

Para un PublicationEvent, esto indica la fecha de lanzamiento inicial de esta entidad, como la fecha de estreno en cines de una película por primera vez.

Para ExclusiveEvent y FeaturedEvent, esto representa la fecha de inicio de la creación o exhibición de la entidad.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent. Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

Para ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

Para FeaturedEvent, esto representa la última fecha en la que el proveedor presenta la entidad.

Si el contenido es exclusivo o se muestra de forma permanente, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organización o Persona Opcional: La organización o la persona que publicó esta entidad.
description Text Muy recomendable ¿Por qué? Una sinopsis de la temporada. Se prefiere la sinopsis de la trama a los resúmenes fácticos. Límite de 300 caracteres.
actor [Person o PerformingGroup o PerformanceRole Muy recomendable ¿Por qué? Un array de los miembros del reparto de la temporada. Consulte la guía de modelado aquí.
director Persona Muy recomendable ¿Por qué? Es una matriz de los directores del programa.
producer Organización o Persona Muy recomendable ¿Por qué? Los productores de la temporada.
image ImageObject Las imágenes relacionadas con la temporada de TV Si deseas obtener más detalles sobre las propiedades obligatorias y opcionales que debes incluir con image, consulta Propiedades de imágenes.
genre Text Una lista ordenada de todos los géneros relevantes. Por ejemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Text 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 Text Es la descripción del avance. Consulta el ejemplo de Avance.
trailer.inLanguage Text El idioma del avance en formato BCP 47.
trailer.url URL Una URL de un avance alojado públicamente y subido por estudios de producción respectivos o fuentes autorizadas
trailer.regionsAllowed Place Corresponde a las regiones donde se permite el contenido multimedia. Si no se especifica, se supone que se permite en todas partes. Especifica los países en formato ISO 3166.
identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o de otro tipo que identifica inequívocamente esta entidad. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
popularityScore.@type Text Siempre establecida en PopularityScoreSpecification.
popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala 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 clasificación que se otorga en la opinión.
contentRating Texto o Calificación Obligatorio para contenido para adultos; se recomienda en todo caso: Clasificación general del contenido. Si la clasificación del contenido se proporciona en una string de texto, se aceptan dos variaciones:
  • La agencia de calificación antepuesto a la calificación con un espacio en blanco en el medio. Por ejemplo, una calificación de "TV-MA" de la agencia "TVPG" en EE.UU. debe describirse como "TVPG TV-MA". Consulte la lista de agencias.
  • Un valor de "CALIFICACIÓN NO SABE" (no distingue mayúsculas de minúsculas) para indicar que no conoce la clasificación del contenido.
contentRating.author Organización o texto Obligatorio si contentRating usa Rating: El nombre de la agencia de clasificación. Consulta la página Agencias de clasificación del contenido para obtener una lista de las agencias de calificación aceptadas.
contentRating.ratingValue Text Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Text Es el código de asesoramiento para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Dialogue, FV = Fantasy Violencia, L = Language, S = Sexual Content, 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 incluye 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 reparto.
  • Usa el tipo PerformanceRole cuando se desempeñe el rol correspondiente y, de forma opcional, el nombre del personaje de los miembros del reparto. En este caso, el actor Person o PerformingGroup está incorporado en el objeto PerformanceRole.
  • Usa el tipo Person para indicar los actores individuales o PerformingGroup a fin de proporcionar los detalles de los grupos o las bandas en los que actúa(n) cuando se desconocen los roles que desempeñan los miembros del reparto.

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

Usa los tipos Person o PerformingGroup

Proporciona las siguientes propiedades cuando se usan los tipos Person o PerformingGroup.

Propiedad Tipo esperado Descripción
@type Person o PerformingGroup Obligatorio: Siempre se debe configurar como Person o PerformingGroup.
@id URL Muy recomendable ¿Por qué? - Son los actores o identificadores de grupos en ejecución en formato URI; por ejemplo, https://example.com/actor/abc. @id debe cumplir con los siguientes requisitos:
  • Único a nivel global en el catálogo por actor o grupo de rendimiento
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • Tu organización debe tener la propiedad del dominio para el valor @id.

Ten en cuenta que el elemento @id que se usa en la propiedad del actor se debe usar de forma coherente en todo el feed. Por ejemplo, si hay dos películas con el mismo actor, el valor @id se debe mantener igual en estos dos objetos de actor.

name Text Obligatorio: El nombre del actor/actor, el miembro del reparto o el grupo de rendimiento.
sameAs URL Muy recomendable ¿Por qué? - Una URL a una página web de referencia que pueda identificar al actor o al grupo que actúa en su nombre (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 use el tipo PerformanceRole.

Propiedad Tipo esperado Descripción
@type Función de rendimiento Obligatorio: Siempre establecido en PerformanceRole
roleName Text Muy recomendable ¿Por qué? - Una función que interpretó o realizó el miembro del reparto. Consulte la lista de valores aceptables aquí.
characterName Text Es el nombre de un personaje representado en una función o una actuación. No configures este campo si el tipo de actor es PerformingGroup.
actor Person o PerformingGroup Obligatorio :
  • Son los miembros del reparto del contenido cuando se usa el tipo de datos Person.
  • Los grupos o bandas de rendimiento del contenido cuando se usa el tipo de datos PerformingGroup.
actor.@type Person o PerformingGroup Obligatorio: Siempre se debe configurar como Person o PerformingGroup.
actor.@id URL Muy recomendable ¿Por qué? - El actor o identificador de grupo que realiza el archivo en formato URI; por ejemplo, https://example.com/actor/abc. @id debe cumplir con los siguientes requisitos:
  • Único a nivel global en el catálogo por actor o grupo de rendimiento
  • El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • Tu organización debe tener la propiedad del dominio para el valor @id.

Ten en cuenta que el elemento @id que se usa en la propiedad del actor se debe usar de forma coherente en todo el feed. Por ejemplo, si hay dos películas con el mismo actor, el valor @id se debe mantener igual en estos dos objetos de actor.

actor.name Text Obligatorio: El nombre del actor/actor, el miembro del reparto o el grupo de rendimiento.
actor.sameAs URL Muy recomendable ¿Por qué? - Una URL a una página web de referencia que pueda identificar al actor o al grupo que actúa en su nombre (por ejemplo, la página de Wikipedia del actor). Debe ser distinto de la propiedad actor.@id.

Nombres de roles aceptables

Estos valores requieren que actor.@type sea Person.

Valor roleName Descripción
"Cameo" Una aparición breve, también llamada "aparición", es la aparición breve de una persona reconocida en una obra de artes escénicas.
"Actor de voz" Una interpretación de voz es aquella en la que se usa la voz del actor, pero el actor no aparece en la pantalla. Por lo general, esto se encuentra en la animación, pero también ocurre cuando el doblaje de un actor aparece sobre la voz de otro actor.
“Double” Un doble es una persona que sustituye a otro actor, de modo que no se muestra su rostro.
"MotionCaptureActor"; MotionCaptureActor se refiere a una persona que graba acciones de actores humanos y que usa esa información para animar modelos digitales de personajes en animaciones informáticas en 2D o 3D.

En 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 representa a un personaje en una actuación en el medio tradicional del teatro o en medios de comunicación modernos, como una película, una radio y una televisión.
“GuestStar” “Una estrella invitada es un actor que interpreta un papel ficticio y aparece en uno o en varios episodios. En algunos casos, una estrella invitada puede interpretar un personaje recurrente importante y aparecer muchas veces en una serie, a pesar de no ser miembro del elenco principal. Establecer el valor en "GuestStar" cuando el reparto tiene un invitado o es un invitado en el programa. Las estrellas invitadas solo se deben proporcionar a nivel del episodio, no 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 apariencia ficticia.
"Locutor" Una persona que anuncia un discurso de apertura y un cierre del espectáculo, presenta al presentador, los concursantes o invitados famosos, describe los premios disponibles y calienta al público antes de grabar y mantiene la diversión durante los descansos.
"Comentarista" Un comentarista proporciona comentarios en tiempo real sobre un juego o un evento, por lo general, durante una transmisión en vivo.
"Impresionista" Un impresionista o un imitador es un artista cuyo acto consiste en imitar sonidos, voces y gestos de personajes de dibujos animados y celebridades.
"Host" Es una persona que presenta, presenta o presenta programas de televisión, que a menudo actúa como mediador del programa y del público. Por lo general, el "host" es una función de no ficción.
“Coorganizador” Es una persona que organiza un evento o programa de forma conjunta con otra persona.
“GuestHost” Un anfitrión invitado, por lo general, de un programa de entrevistas, que aloja el programa en lugar del presentador normal cuando no está disponible
"Newscaster" Es una persona que presenta o informa al público sobre noticias y eventos que ocurren a escala local, nacional e internacional a través de un programa de noticias de TV.
"Correspondiente" Un corresponsal o reportero en la escena suele ser un periodista o comentarista de una revista o un agente que contribuye a un periódico, noticias de radio o televisión, o de otro tipo de empresa, desde una ubicación remota, a menudo distante.
“ShowJudge” Un juez es una persona que a menudo se considera un experto en el campo del programa y recibe la función de "juez" para criticar a los concursantes que participan en la competencia de la serie de TV y la presentan.
"Panelista" Miembro de un panel de debate o asesoramiento de un panel de radio o televisión.
“Concursante” Un concursante en una competencia o un programa de juegos es una persona que participa en él.
"StoryNarrator" El narrador es una persona que narra algo, especialmente un personaje que relata los eventos de una novela o un poema narrativo.
"Artista musical" "Un artista musical puede ser una persona, un grupo o un personaje ficticio que, por lo general, se presenta frente al público de manera habitual o que grabó pistas musicales o álbumes musicales. Los compositores y letristas solo deben tener este tipo de video si los créditos de alguna obra musical implican que también contribuyen como artistas principales. Se puede usar para asociar a músicos permanentes o grupos de músicos, así como a músicos invitados o grupos de músicos a los programas.

Diferenciar entre un rol principal y uno de asistencia de un actor

Para diferenciar entre los actores principales, normales y los invitados o asistentes de un programa de TV, agrega el elenco principal solo a las entidades TVSeries y agrega solo el elenco invitado o la transmisión con los roles de apoyo de las entidades TVEpisode. Asegúrate de que la transmisión principal o normal 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 de Actor

Se desconoce el rol del actor

Cuando se desconoce la función de un actor, nuestra recomendación es solo proporcionar la información del actor mediante 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"
    }
  ]

El rol del actor es conocido

Cuando se conoce el rol de un actor, nuestra recomendación es que proporcione la información del actor por medio del PerformanceRole type.

"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"
      }
  }
]

Funciones conocidas para un subconjunto de actores

Cuando no se conocen los metadatos de función de rendimiento, nuestra recomendación es proporcionar la información del actor mediante el tipo Person o PerformingGroup . En el otro caso en el que se conoce esta información, use 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 sobre los temas relacionados con estas propiedades: