Acciones comunes del reloj

En esta sección, se proporcionan los detalles de las propiedades comunes de las acciones de visualización.

Propiedades del lenguaje de marcado de acciones

Propiedad Tipo esperado Descripción
@type Text Obligatorio: Siempre se debe configurar como WatchAction
target EntryPoint Obligatorio: Es un objeto de destino que proporciona la asignación de vínculos directos a varias plataformas de Google.
target.@type Text Obligatorio: Siempre se debe configurar como EntryPoint
target.urlTemplate URL Obligatorio: Es un vínculo directo que dirige a los usuarios a tu app o plataforma y que inicia la reproducción del contenido.
target.inLanguage Text Opcional: Es el idioma original de la serie en formato BCP 47.
target.actionPlatform Text Obligatorio: Las plataformas que se asignaron a urlTemplate. Las acciones multimedia admiten lo siguiente:
  • http://schema.org/DesktopWebPlatform: Es la plataforma de búsqueda en navegadores web para computadoras de escritorio.
  • http://schema.org/MobileWebPlatform: Es la plataforma de búsqueda en navegadores web para dispositivos móviles.
  • http://schema.org/AndroidPlatform: Plataformas de búsqueda y PlayGuide en la app para Android.
  • http://schema.org/AndroidTVPlatform: Plataforma de Android TV en la app de Android TV.
  • http://schema.org/IOSPlatform: Es la plataforma de búsqueda en la app para iOS.
  • http://schema.googleapis.com/GoogleVideoCast: Plataformas Cast y Home en un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Plataformas Cast y Home en un dispositivo Chromecast (solo acciones de escucha).
Consulta la sección Tipos de plataformas para conocer los requisitos.
target.additionalProperty PropertyValue Obligatorio si corresponde: Una lista de pares propiedad-valor para representar propiedades adicionales del vínculo directo. Esto puede incluir lo siguiente:
  • contentLanguage: El idioma de emisión (dub) en formato BCP 47. Si el contenido está doblado en otro idioma, esta propiedad es obligatoria. Usa una matriz para múltiples códigos de idioma.
  • subtitleLanguage: Son los idiomas de los subtítulos en formato BCP 47. Usa una matriz para múltiples códigos de idioma.
  • cameraAngle: El ángulo de la cámara para el contenido; por ejemplo, "Nivel de ojos" y "Ángulo alto". Si el contenido está disponible en diferentes ángulos de cámara, esta propiedad es obligatoria. Usa un arreglo para varios ángulos de cámara.
  • videoFormat: El formato de archivo que se usa para almacenar la fecha del video digital; por ejemplo, "SD" para la definición estándar y "HD" para la alta definición. Los formatos de video válidos incluyen SD, HD, 2K, 4K y 8K. Use un array para varios formatos de video.
Consulta el ejemplo de additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Obligatorio: Es un objeto de especificación de acceso a la acción que describe el requisito de acceso del contenido. Consulta Propiedades de las especificaciones de acceso a las acciones.

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

Propiedades de las especificaciones del acceso de acciones

Propiedad Tipo esperado Descripción
actionAccessibilityRequirement.@type Text Obligatorio: Siempre se debe configurar como ActionAccessSpecification
actionAccessibilityRequirement.category Text

Obligatorio: Es un requisito de acceso para el contenido. Para obtener más información, consulta Tipo de muro de pago.

Si una entidad representa un grupo de contenido, debes establecer category en el requisito de acceso menos restringido de su contenido. Por ejemplo, si un TVSeries tiene contenido TVEpisode establecido en nologinrequired y algunos configurado en subscription, establece TVSeries en nologinrequired.

actionAccessibilityRequirement.availabilityStarts Fecha

Obligatorio: Es la fecha después de la cual la acción está disponible, en formato ISO 8601 (incluida la zona horaria).

  • La fecha puede establecerse en el futuro.

Es obligatorio que la entidad correspondiente se proporcione en el feed al menos 7 días antes de su fecha availabilityStarts. Esto mejorará las posibilidades de que el contenido aparezca en las plataformas de Google a tiempo.

actionAccessibilityRequirement.availabilityEnds Fecha Obligatorio: Fecha después de la cual la acción ya no está disponible, en formato ISO 8601 (incluida la zona horaria).
  • Debe ser igual o superior a 72 horas después de availabilityStarts.
  • Si el contenido siempre está disponible después de su publicación, establece esta fecha en 20 años a partir de la fecha actual.

Es obligatorio que las actualizaciones de la disponibilidad availabilityEnds se realicen en el feed al menos 7 días antes de la availabilityavailabilityEnds. Esto mejorará las posibilidades de que el contenido deje de aparecer en las plataformas de Google en la fecha availabilityEnd.

actionAccessibilityRequirement.eligibleRegion País, Ciudad, Estado, GeoShape o Texto Obligatorio: Regiones donde el contenido está disponible. Usa la string especial EARTH si el contenido está disponible de manera global.
actionAccessibilityRequirement.ineligibleRegion País, Ciudad, Estado o GeoShape Obligatorio si corresponde: Regiones donde el contenido está restringido. No es necesario que proporciones esta propiedad si el contenido está disponible en cualquier lugar dentro de eligibleRegion.
actionAccessibilityRequirement.requiresSubscription Suscripción multimedia

Obligatorio si corresponde: Los detalles de la suscripción que los usuarios necesitan para acceder al contenido. Consulta Propiedades de las suscripciones multimedia.

  • Proporciona esta propiedad si category es subscription o externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Obligatorio si el contenido requiere una compra: los detalles de la oferta asociada con el contenido. Proporciona la información sobre los precios en los siguientes casos:
  • Contenido de compra única (rental o purchase)
  • Contenido basado en suscripciones que requiere la compra de suscriptores (subscription o externalsubscription)
Si el precio es 0.00, quita el objeto Offer por completo y establece category del objeto ActionAccessSpecification en free. Consulta Propiedades de ofertas.

Propiedades de suscripción a medios

Es obligatorio si actionAccessibilityRequirement.category es subscription o externalSubscription.

Propiedad Tipo esperado Descripción
requiresSubscription.@type Text Obligatorio: Siempre establecer en MediaSubscription
requiresSubscription.@id URL Obligatorio: El ID único de la suscripción. Si se puede acceder al contenido a través de diferentes suscripciones, cada suscripción debe tener un ID único.
requiresSubscription.name Text Obligatorio: El nombre de la suscripción. Ten en cuenta lo siguiente:
  • Si se puede acceder al contenido mediante diferentes suscripciones, este nombre debe coincidir con el que figura en tu sistema de autenticación de usuarios. Por ejemplo, si un usuario puede acceder al contenido en función de la suscripción llamada Paquete 1, pero el sistema de autenticación usa el nombre PKG1a, usa PKG1.
  • Para los proveedores de TVE, este es el nombre del autenticador registrado en el autenticador de TVE. Es una string que identifica de forma única el nombre del servicio con el autenticador de TVE.
requiresSubscription.sameAs URL La página que describe la suscripción.
requiresSubscription.identifier Text Obligatorio si category es subscription Y commonTier es false: Es una string única para esta suscripción que representa el acceso a un grupo de contenido en tu catálogo de medios.
  • Google recomienda que uses la siguiente sintaxis para el identificador:
    nombre de dominio + dos puntos (:) + nivel de acceso al contenido, por ejemplo : example.com:basic, example.com:premium, example.com:deportes
  • Esta propiedad será la misma que tu identificador de derecho si proporcionas una API de derechos.
requiresSubscription.authenticator Organization Obligatorio si category es externalsubscription: un contenedor que proporciona los detalles del autenticador del proveedor externo.
requiresSubscription.authenticator.@type Text Obligatorio si category es externalsubscription: Siempre se establece en Organization.
requiresSubscription.authenticator.name Text Obligatorio si category es externalsubscription: el nombre del servicio de autenticación. Para los proveedores de TVE, configúralo como TVE
requiresSubscription.commonTier Booleano Obligatorio si corresponde: Es obligatorio si la categoría está configurada como suscripción. Obtén más información sobre commonTier en la documentación de requisitos de nivel común.

Requisitos de la API de Entitlement

Se requiere una API de derechos si actionAccessibilityRequirement.category es subscription o externalSubscription, y tu oferta de suscripción incluye varios paquetes o niveles, o tiene compatibilidad de complementos. No incluyas esta opción si tu suscripción es de un nivel y brinda acceso a todo el contenido de tu catálogo.

  • La empresa A tiene una única oferta de suscripción que brinda a los usuarios suscritos acceso a todo el contenido disponible: no se requiere el API o el identificador de derechos
  • La empresa B tiene una suscripción base que proporciona acceso a cierto contenido y una suscripción premium que proporciona acceso a contenido premium: se requiere el identificador de derechos o la API.
  • La empresa C tiene una suscripción base que brinda acceso a cierto contenido y agrega paquetes que proporcionan acceso a contenido de terceros: se requiere el identificador de derechos o la API

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

Propiedades de la oferta

Propiedad Tipo esperado Descripción
expectsAcceptanceOf.@type Text Obligatorio: Siempre se debe configurar como Offer
expectsAcceptanceOf.price Número Obligatorio: El precio de compra del contenido. El precio debe ser un valor positivo distinto de cero. Para entidades con un precio de 0.00, especifica la categoría "free" (gratis).
expectsAcceptanceOf.priceCurrency Text Obligatorio: La moneda del precio en formato ISO 4217 de 3 letras.
expectsAcceptanceOf.seller Organization Es la organización que ofrece la compra de contenido.
expectsAcceptanceOf.seller.@type Text Siempre establecer en Organization.
expectsAcceptanceOf.seller.name Text El nombre del vendedor.
expectsAcceptanceOf.seller.sameAs Text Corresponde a la URL de una página web que identifica al vendedor; por ejemplo, la página principal del vendedor.

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

Identificadores

Los feeds de acciones multimedia aceptan una variedad de identificadores que pueden ayudar a identificar una entidad de manera inequívoca. Estos identificadores pueden ayudar a acelerar el proceso de conciliación del contenido de tu feed con el contenido de las bases de datos de Google. Si bien la mayoría de estos identificadores se pueden agregar al feed con la propiedad identifier en varios tipos de entidades, los EIDR tienen su propia propiedad representativa. Ambas se analizan a continuación.

Propiedades del identificador

Propiedad Tipo esperado Descripción
identifier Text Recomendación: Un identificador, generalmente uno externo, que identifica una entidad determinada de manera clara. Se permiten varios identificadores.

Esta propiedad está disponible en todos los tipos de entidades de Acción de visualización.

En la siguiente tabla, se enumeran los identificadores y las subpropiedades aceptados de la propiedad identifier. Consulta el ejemplo del identificador o EIDR en la sección de ejemplos del feed de acciones de visualización.
Propiedad Tipo esperado Descripción
@type Text Obligatorio: Siempre se debe configurar como PropertyValue
propertyID Text Obligatorio: Admitimos los siguientes tipos de ID:
  • TMS_ROOT_ID: El ID raíz de Gracenote (TMS) (por ejemplo, 15829).
  • Esto no se aplica a las entidades de Organización y BroadcastService en las que solo se debe usar TMS_ID.
  • TMS_ID: El ID de la variante de Gracenote (TMS) (por ejemplo, MV000398520000).
  • WIKIDATA_ID: Es el ID de WikiData (por ejemplo, Q134773).
  • IMDB_ID: Es el ID de IMDB (por ejemplo, tt0109830).
  • OPTA_ID: Es el ID de deportes de OPTA.
  • STATS_ID: el ID de estadísticas.
  • VIP_TIMES_ID: Es el ID de VIP Times de Japón (Nihon Tarento Meikan) para los talentos japoneses.
  • DMA_ID: Es el código de área de marketing designado de EE.UU. que se usa en el objeto GeoShape.
  • _PARTNER_ID_: Esta propiedad debe contener la string "_PARTNER_ID_", el valor debe ser un ID único que un proveedor de servicios usa a nivel interno o externo para identificar la entidad (por ejemplo, 12345 o a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Text Obligatorio: El valor para el sistema de ID especificado.

Propiedades de EIDR

EIDR (abreviatura de "Entertainment Identifier Registry") es un sistema de identificación único a nivel global para una gran variedad de contenido multimedia, que incluye películas y programas de televisión. El sistema de identificación resuelve un identificador para un registro de metadatos asociado con títulos de nivel superior, ediciones y mucho más. En la siguiente tabla, se enumeran las propiedades asociadas con EIDR y su uso.

Propiedad Tipo esperado Descripción
titleEIDR Text Recomendación: Un identificador EIDR (registro identificador de entretenimiento) representa, en el nivel más general o abstracto, una obra de película o televisión.

Esta propiedad está disponible en las páginas de especificaciones de entidades de TVSeries, TVSeason, TVEpisode y Movie.

Por ejemplo, titleEIDR para la película conocida como "Cazafantasmas" es "10.5240/7EC7-228A-510A-053E-CBB8-J".

Consulta Ejemplo de feed de acciones del reloj.
editEIDR Text Recomendación: Un identificador EIDR (registro identificador de entretenimiento) representa una edición o edición específica de una obra de película o televisión.

Esta propiedad está disponible en las páginas de especificaciones de entidades de TVEpisode y Movie.

Por ejemplo, la película conocida como "Cazafantasmas" cuyo títuloEIDR es "10.5240/7EC7-228A-510A-053E-CBB8-J"8"8.

Agencias de clasificación de contenido

Usa los valores de esta tabla para BroadcastService.contentRating, Movie.contentRating y TVSeries.contentRating. La agencia de clasificación debe estar antepuesta al valor de la calificación. Ejemplos:

  • Una película con la clasificación "R" en EE.UU. debe tener un valor Movie.contentRating de "MPAA R".
  • Una serie de TV calificada como "TV-MA" en EE.UU. debería tener un valor de TVSeries.contentRating de "TVPG TV-MA".

País Agencia de clasificación de TV Agencia de calificación de películas
Albania (Alabama) No disponible No disponible
Angola (AO) No disponible CCE
Antigua y Barbuda (AG) No disponible MPAA
Argentina (RA) INCAA INCAA
Armenia (AM) No disponible MKRF/RUSSIA
Aruba (AW) No disponible No disponible
Australia (AU) ACB TV Películas de ACB
Austria (AT) FSK FSK
Azerbaiyán (AZ) No disponible MKRF/RUSSIA
Baréin (BH) No disponible MPAA
Bielorrusia (BY) No disponible MKRF/RUSSIA
Bélgica (BE) No disponible MPAA
Belice (BZ) No disponible No disponible
Benín (BJ) No disponible CNC
Bolivia (BO) No disponible MPAA
Bosnia y Herzegovina (BA) No disponible MPAA
Botsuana (BW) No disponible MPAA
Brasil (BR) CLASIFICACIÓN CLASIFICACIÓN
Burkina Faso (BF) No disponible CNC
Camboya (KH) No disponible No disponible
Canadá (CA) CA_TV CHVRS
Cabo Verde (CV) No disponible CCE
Chile (CL) No disponible MPAA
Colombia (CO) No disponible MPAA
Costa Rica (CR) No disponible MPAA
Croacia (HR) No disponible No disponible
Chipre (CY) No disponible GRFILM
República Checa (CZ) No disponible CZFIL
Dinamarca (DK) No disponible MCCP
Ecuador (EC) No disponible MPAA
Egipto (EG) No disponible MPAA
El Salvador (SV) No disponible MPAA
Estonia (EE) No disponible PELÍCULA
Fiyi (FJ) No disponible No disponible
Finlandia (FI) No disponible MEKU
Francia (FR) CSA CSA
Gabón (GA) No disponible CNC
Alemania (DE) FSK FSK
Grecia (GR) ESR GRFILM
Guatemala (GT) No disponible MPAA
Haití (HT) No disponible No disponible
Honduras (HN) No disponible MPAA
Hong Kong (HK) CA FCO
Hungría (HU) No disponible MPAA
Islandia (IS) No disponible KIJKWIJZER.
India (IN) CBFC CBFC
Indonesia (ID) KPI LSF
Irlanda (IE) No disponible SI.CONJUNTO
Italia (IT) AGCOM AGCOM
Costa de Marfil (CI) No disponible CNC
Jamaica (JM) No disponible MPAA
Japón (JP) N/A EIRIN
Jordania (JO) No disponible MPAA
Kazajistán (KZ) No disponible MRK
Corea (KR) KMRB KMRB
Kuwait (KW) No disponible MPAA
Kirguistán (KG) No disponible MKRF/RUSSIA
Laos (Luisiana) No disponible No disponible
Letonia (LV) No disponible NKCLV
Líbano (LB) No disponible MPAA
Lituania (LT) No disponible No disponible
Luxemburgo (LU) No disponible KIJKWIJZER.
Macedonia (MK) No disponible MPAA
Malasia (MY) No disponible FCBM
Malí (AA) No disponible CNC
Malta (MT) No disponible MCCAA
Mauricio (MU) No disponible BBFC
México (MX) RTC RTC
Moldavia (MD) No disponible No disponible
Namibia (NA) No disponible No disponible
Nepal (NP) No disponible MPAA
Países Bajos (NL) KIJKWIJZER. KIJKWIJZER.
Nueva Zelanda (NZ) BSA OFLC
Nicaragua (NI) No disponible MPAA
Níger (NE) No disponible CNC
Noruega (NO) No disponible MEDIETIL.SINET
Omán (OM) No disponible MPAA
Panamá (PA) No disponible MPAA
Papúa Nueva Guinea (PG) No disponible MPAA
Paraguay (PY) No disponible MPAA
Perú (PE) No disponible MPAA
Filipinas (PH) MTRCB MTRCB
Polonia (PL) No disponible MPAA
Portugal (PT) No disponible CCE
Catar (QA) No disponible MPAA
Rusia (RU) MKRF/RUSSIA MKRF/RUSSIA
Ruanda (RW) No disponible CNC
Arabia Saudita (SA) No disponible MPAA
Senegal (SN) No disponible MPAA
Singapur (SG) No disponible MDA
Eslovaquia (SK) No disponible MPAA
Eslovenia (SI) No disponible MPAA
Sudáfrica (ZA) FPB FPB
España (ES) SETSI ICAA
Sri Lanka (LK) No disponible No disponible
Suecia (SE) No disponible SMSA
Suiza (CH) FSK FSK
Taiwán (TW) No disponible MOCTW
Tayikistán (TJ) No disponible MKRF/RUSSIA
Tanzania (TZ) No disponible MPAA
Tailandia (TH) No disponible BFVC.
Togo (TG) No disponible CNC
Trinidad y Tobago (TT) No disponible No disponible
Turquía (TR) RTÜK ECBMCT;
Turkmenistán (TM) No disponible MKRF/RUSSIA
Uganda (UG) No disponible MPAA
Ucrania (UA) No disponible No disponible
Emiratos Árabes Unidos (AE) No disponible MPAA
Reino Unido (GB) BBFC BBFC
Estados Unidos (EE.UU.) TV_PG; MPAA
Uruguay (UY) No disponible MPAA
Uzbekistán (UZ) No disponible MKRF/RUSSIA
Venezuela (VE) No disponible RESORTEVIOLENCIA
Vietnam (VN) No disponible MCST
Zambia (ZM) No disponible MPAA
Zimbabue (ZW) No disponible MPAA

Propiedades de GeoShape

Un objeto GeoShape contiene uno de los siguientes tipos de datos:

Propiedad Tipo esperado Descripción
@id URL Obligatorio: el identificador de la región geográfica en formato de URI.
@type Text Obligatorio: Siempre se debe configurar como GeoShape
addressCountry Text Obligatorio: Es el código de país ISO 3166-1 alpha-2 de dos letras.
postalCode Text Opcional: Lista de uno o más códigos postales o códigos de área de clasificación directa (FSA).
identifier PropertyValue Opcional: Un ID de Área de mercado designada (DMA), que es un identificador de una región de Estados Unidos en la que las personas reciben los mismos programas y canales de televisión.
identifier.@type Text Obligatorio: Siempre se debe configurar como PropertyValue
identifier.propertyID Text Obligatorio: Siempre se debe configurar como DMA_ID
identifier.value Text Obligatorio: El código de DMA para la región.

Ejemplo del objeto GeoShape que contiene una lista de códigos postales:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Ejemplo de un objeto GeoShape que contiene una combinación de FSA (área de clasificación directa) y códigos postales:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Ejemplo de un objeto GeoShape que contiene un ID de DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}