Ver acciones propiedades comunes

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 Texto Obligatorio: Siempre se debe establecer en 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 Texto Obligatorio: Siempre se debe establecer en EntryPoint.
target.urlTemplate URL Obligatorio: Un vínculo directo que lleva a los usuarios a tu app o plataforma y que inicia la reproducción del contenido.
target.inLanguage Texto Opcional: Idioma original de la serie en formato BCP 47.
target.actionPlatform Texto Obligatorio: Son las plataformas que se asignan a urlTemplate. Las Acciones multimedia admiten lo siguiente:
  • http://schema.org/DesktopWebPlatform: Plataforma de búsqueda en navegadores web para computadoras
  • http://schema.org/MobileWebPlatform: 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: Plataforma de búsqueda en la app para iOS.
  • http://schema.googleapis.com/GoogleVideoCast: Plataformas de Cast y Home en un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Plataformas de 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: Es una lista de pares propiedad-valor para representar propiedades adicionales del vínculo directo. Esto puede incluir lo siguiente:
  • contentLanguage: Es el idioma de la transmisión (doblaje), en formato BCP 47. Esta propiedad es obligatoria si el contenido está doblado a otro idioma. Usa un array para varios códigos de idioma.
  • subtitleLanguage: Los idiomas de los subtítulos, en formato BCP 47. Usa un array para varios códigos de idioma.
  • cameraAngle: Ángulo de la cámara para el contenido; por ejemplo, "A nivel de los ojos" y "Ángulo alto". Esta propiedad es obligatoria si el contenido está disponible en diferentes ángulos de cámara. Usa un array para varios ángulos de cámara.
  • videoFormat: Es el formato de archivo que se usa para almacenar la fecha del video digital; por ejemplo, "SD" para definición estándar y "HD" para alta definición. Los formatos de video válidos incluyen SD, HD, 2K, 4K y 8K. Usa un array para varios formatos de video.
  • audioDescriptionLanguage: Es un array de idiomas de audio admitidos, en formato BCP 47, que admiten la audiodescripción. Este es un subconjunto del array contentLanguage.
Consulta el ejemplo de additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Obligatorio: Es un objeto de especificación de acceso a Action que describe el requisito de acceso del contenido. Consulta Propiedades de especificación de acceso a la acción.

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

Propiedades de especificación de acceso a la acción

Propiedad Tipo esperado Descripción
actionAccessibilityRequirement.@type Texto Obligatorio: Siempre se debe establecer en ActionAccessSpecification.
actionAccessibilityRequirement.category Texto

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 restrictivo de su contenido. Por ejemplo, si un TVSeries tiene contenido TVEpisode establecido en nologinrequired y algunos establecidos en subscription, establece este TVSeries en nologinrequired.
actionAccessibilityRequirement.availabilityStarts Fecha

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

  • La fecha se puede establecer en el futuro.

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

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

Es obligatorio que las actualizaciones de la fecha availabilityEnds se realicen en el feed al menos 7 días antes de esa fecha. Esto aumentará las probabilidades de que el contenido deje de aparecer en las plataformas de Google en la fecha de disponibilidadEnds.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape o Text Obligatorio: Son las regiones en las que está disponible el contenido. Usa la cadena especial EARTH si el contenido está disponible a nivel global.
actionAccessibilityRequirement.ineligibleRegion Country, City, State o GeoShape Obligatorio si corresponde: Son las regiones en las que el contenido está restringido. No es necesario que proporciones esta propiedad si el contenido está disponible en todas partes dentro de eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Obligatorio si corresponde: Son los detalles de la suscripción que necesitan los usuarios para acceder al contenido. Consulta Propiedades de suscripción de medios.

  • Proporciona esta propiedad si category es subscription o externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Obligatorio si el contenido requiere una compra: Son los detalles de la oferta asociada con el contenido. Proporciona la información de precios para los siguientes casos:
  • Contenido de compra única (rental o purchase)
  • Contenido basado en suscripciones que requiere una compra adicional de los 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 la oferta.
actionAccessibilityRequirement.additionalProperty PropertyValue Obligatorio si corresponde: Es una referencia al paquete de suscripción que se mostrará en la experiencia.
actionAccessibilityRequirement.additionalProperty.name Texto Obligatorio: Siempre se debe establecer en "DisplaySubscriptionIdentifier".
actionAccessibilityRequirement.additionalProperty.value Texto Obligatorio: Es el requiresSubscription.@id que se mostrará para la entidad.

Propiedades de suscripción de contenido multimedia

Obligatorio si actionAccessibilityRequirement.category es subscription o externalSubscription.

Propiedad Tipo esperado Descripción
requiresSubscription.@type Texto Obligatorio: Siempre se debe establecer en MediaSubscription.
requiresSubscription.@id URL Obligatorio: Es 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 Texto Obligatorio: Es el nombre de la suscripción. Ten en cuenta lo siguiente:
  • Si se puede acceder al contenido a través de diferentes suscripciones, este nombre debe coincidir con el nombre de tu sistema de autenticación de usuarios. Por ejemplo, si un usuario puede acceder al contenido según la suscripción llamada Paquete 1, pero el sistema de autenticación usa el nombre PKG1a, usa PKG1.
  • En el caso de los proveedores de TVE, este es el nombre del autenticador registrado en tu autenticador de TVE. Es una cadena que identifica de forma única el nombre de tu servicio con el autenticador de TVE.
  • Si la suscripción tiene varios nombres, especifícalos como un array de valores. Consulta el siguiente ejemplo para saber cómo agregar un array de nombres con varias traducciones.
requiresSubscription.sameAs URL Página que describe la suscripción.
requiresSubscription.identifier Texto Obligatorio si category es subscription Y commonTier es false - Es una cadena ú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. Ejemplos : example.com:basic, example.com:premium, example.com:sports
  • Esta propiedad será la misma que tu identificador de derecho si proporcionas una API de derechos.
requiresSubscription.authenticator Organization Obligatorio si category es externalsubscription: Es un contenedor que proporciona los detalles del autenticador del proveedor externo.
requiresSubscription.authenticator.@type Texto Se requiere si category es externalsubscription: Siempre se debe establecer en Organization.
requiresSubscription.authenticator.name Texto Obligatorio si category es externalsubscription: Es 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 se establece como suscripción. Obtén más información sobre commonTier en la documentación de los requisitos de nivel comunes.

Requisitos de la API de Entitlements

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 bien admite complementos. No incluyas esta información si tu suscripción tiene un solo nivel y brinda acceso a todo el contenido de tu catálogo.

  • La empresa A tiene una sola oferta de suscripción que les brinda a los usuarios suscritos acceso a todo el contenido disponible: No se requiere el identificador de derechos o la API.
  • La empresa B tiene una suscripción básica que proporciona acceso a cierto contenido y una suscripción premium que proporciona acceso a contenido premium: Se requiere el identificador de derechos / la API.
  • La empresa C tiene una suscripción básica que proporciona acceso a cierto contenido y paquetes complementarios que brindan acceso a contenido de terceros: Se requiere el identificador de derechos / 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 Texto Obligatorio: Siempre se debe establecer en Offer.
expectsAcceptanceOf.price Número Obligatorio: Es el precio de compra del contenido. El precio debe ser un valor positivo distinto de cero. En el caso de las entidades con un precio de 0.00, especifica la categoría como "free".
expectsAcceptanceOf.priceCurrency Texto Obligatorio: 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 Texto Siempre se establece en Organization.
expectsAcceptanceOf.seller.name Texto Es el nombre del vendedor.
expectsAcceptanceOf.seller.sameAs Texto Es la URL de una página web que identifica al vendedor, por ejemplo, la página principal del vendedor.

Página relacionada con la oferta

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. Ambos se analizan a continuación.

Propiedades del identificador

Propiedad Tipo esperado Descripción
identifier Texto Altamente recomendado: Es un identificador, por lo general externo, que identifica de forma inequívoca una entidad determinada. 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 de identificador/EIDR en la sección de ejemplos del feed de Acciones de visualización.
Propiedad Tipo esperado Descripción
@type Texto Obligatorio: Siempre se debe establecer en PropertyValue.
propertyID Texto Obligatorio: Admitimos los siguientes tipos de documentos de identidad:
  • TMS_ROOT_ID: Es el ID raíz de Gracenote (TMS) (por ejemplo, 15829).
    • . Esto no se aplica a las entidades Organization y BroadcastService, en las que solo se debe usar TMS_ID.
  • TMS_ID: Es el ID de 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 OPTA Sports.
  • STATS_ID: Es el ID de STATS Perform.
  • VIP_TIMES_ID: Es el ID de VIPTimes (Nihon Tarento Meikan) de Japón para 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 cadena "_PARTNER_ID_". El valor debe ser un ID único que utilice un proveedor de servicios, de forma interna o externa, para identificar la entidad (por ejemplo, 12345 o a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Texto Obligatorio: Es el valor del sistema de ID especificado.

Propiedades del EIDR

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

Propiedad Tipo esperado Descripción
titleEIDR Texto Altamente recomendado: Un identificador EIDR (Entertainment Identifier Registry) representa, en el nivel más general o abstracto, una obra cinematográfica o televisiva.

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

Por ejemplo, el EIDR del título de la película conocida como "Los Cazafantasmas" es "10.5240/7EC7-228A-510A-053E-CBB8-J".

Consulta el ejemplo de identificador/EIDR en la sección de ejemplos del feed de acciones de reloj.
editEIDR Texto Altamente recomendado: Un identificador de EIDR (Entertainment Identifier Registry) representa una edición específica de una obra cinematográfica o televisiva.

Esta propiedad está disponible en las páginas de especificación de entidades TVEpisode y Movie.

Por ejemplo, la película conocida como "Los Cazafantasmas", cuyo EIDR de título es "10.5240/7EC7-228A-510A-053E-CBB8-J", tiene varias ediciones, p.ej., "10.5240/1F2A-E1C5-680A-14C6-E76B-I" y "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

La propiedad titleEIDR es obligatoria cuando se proporciona editEIDR.

Consulta el ejemplo de Identifier/EIDR en la sección de ejemplos del feed de Acciones de visualización.

Agencias de clasificación del contenido

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

  • Una película clasificada como "R" en EE.UU. debe tener un valor de Movie.contentRating de "MPAA R".
  • Una serie de TV clasificada como "TV-MA" en EE.UU. debe tener un valor de TVSeries.contentRating de "TV_PG TV-MA".

País Agencia de clasificación de contenido de TV Agencia de clasificación de películas
Albania (AL) No disponible No disponible
Angola (AO) No disponible CCE
Antigua y Barbuda (AG) No disponible MPAA
Argentina (AR) INCAA INCAA
Armenia (AM) No disponible MKRF/RUSSIA
Aruba (AW) No disponible No disponible
Australia (AU) ACB TV ACB Movies
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-Herzegovina (BA) No disponible MPAA
Botsuana (BW) No disponible MPAA
Brasil (BR) CLASSIND CLASSIND
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 CZFILM
Dinamarca (DK) No disponible MCCYP
Ecuador (EC) No disponible MPAA
Egipto (EG) No disponible MPAA
El Salvador (SV) No disponible MPAA
Estonia (EE) No disponible EEFILM
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 IFCO
Italia (IT) AGCOM AGCOM
Costa de Marfil (CI) No disponible CNC
Jamaica (JM) No disponible MPAA
Japón (JP) NA EIRIN
Jordania (JO) No disponible MPAA
Kazajistán (KZ) No disponible MRKF
Corea (KR) KMRB KMRB
Kuwait (KW) No disponible MPAA
Kirguistán (KG) No disponible MKRF/RUSSIA
Laos (LA) 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í (ML) 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 MEDIETILSYNET
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
Türkiye (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 (US) 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: Es el identificador de la región geográfica en formato de URI.
@type Texto Obligatorio: Siempre se debe establecer en GeoShape.
addressCountry Texto Obligatorio: Es el código de país ISO 3166-1 alpha-2 de dos letras.
postalCode Texto Opcional: Es una lista de uno o más códigos postales o códigos de FSA (área de clasificación avanzada).
identifier PropertyValue Opcional: Es 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 canales y programas de televisión.
identifier.@type Texto Obligatorio: Siempre se debe establecer en PropertyValue.
identifier.propertyID Texto Obligatorio: Siempre se debe establecer en DMA_ID.
identifier.value Texto Obligatorio: Es el código de DMA de la región.

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

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

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

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

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