Ver acciones propiedades comunes

En esta sección, se proporcionan los detalles de las propiedades comunes de las Acciones en Relojes.

Propiedades del lenguaje de marcado de acciones

Propiedad Tipo esperado Descripción
@type Texto Obligatorio: Siempre se establece 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 establece en EntryPoint.
target.urlTemplate URL Obligatorio: Es un vínculo directo que lleva a los usuarios a tu app o plataforma y, luego, inicia la reproducción del contenido.
target.inLanguage Texto Opcional: Es el 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 de escritorio
  • http://schema.org/MobileWebPlatform: Plataforma de búsqueda en navegadores web para dispositivos móviles
  • http://schema.org/AndroidPlatform: Plataformas de Search y PlayGuide en la app para Android
  • http://schema.org/AndroidTVPlatform: Plataforma de Android TV en la app para 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 transmisión (doblaje), en formato BCP 47. Si el contenido está doblado a otro idioma, esta propiedad es obligatoria. Usa un array para varios códigos de idioma.
  • subtitleLanguage: Son los idiomas de los subtítulos o las leyendas, en formato BCP 47. Usa un array para varios códigos de idioma.
  • cameraAngle: Es el ángulo de la cámara para el contenido, por ejemplo, "Al nivel de los ojos" y "Ángulo alto". Si el contenido está disponible en diferentes ángulos de cámara, esta propiedad es obligatoria. 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.
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 la especificación de acceso a la acción.

Consulta las siguientes páginas para ver los temas relacionados con estas propiedades:

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

Propiedad Tipo esperado Descripción
actionAccessibilityRequirement.@type Texto Obligatorio: Siempre se establece 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 configurar category en el requisito de acceso menos restrictivo de su contenido. Por ejemplo, si un TVSeries tiene cierto contenido TVEpisode establecido en nologinrequired y algunos que están configurados en subscription, establece este TVSeries en nologinrequired.
actionAccessibilityRequirement.availabilityStarts Fecha

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

  • La fecha se puede establecer en el futuro.

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

actionAccessibilityRequirement.availabilityEnds Fecha Obligatorio: Es la fecha en que dejará de estar disponible la acción, 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 fecha de disponibilidad final 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 availabilityEnds.

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 País, Ciudad, Estado o GeoShape Obligatorio si corresponde: Son las regiones en las que se restringe el contenido. 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 los usuarios necesitan para acceder al contenido. Consulta Propiedades de suscripción de contenido multimedia.

  • 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 por completo el objeto Offer y establece el category del objeto ActionAccessSpecification en free. Consulta Propiedades de la oferta.

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 establece 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 una 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 que aparece en 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 con tu autenticador de TVE. Es una cadena que identifica de forma única el nombre de tu servicio con el autenticador de TVE.
requiresSubscription.sameAs URL Es la 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 multimedia.
  • 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 derechos 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 Obligatorio si category es externalsubscription: Siempre se establece en Organization.
requiresSubscription.authenticator.name Texto Obligatorio si category es externalsubscription: Es el nombre del servicio de autenticación. Para 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 sobre los requisitos de nivel común.

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 tiene compatibilidad con complementos. No lo incluyas si tu suscripción es de un 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 ni 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 o la API.
  • La empresa C tiene una suscripción básica que proporciona acceso a cierto contenido y paquetes adicionales que proporcionan acceso a contenido de terceros: Se requiere el identificador de derechos o la API.

Consulta las siguientes páginas para ver los temas relacionados con estas propiedades:

Propiedades de la oferta

Propiedad Tipo esperado Descripción
expectsAcceptanceOf.@type Texto Obligatorio: Siempre se establece en Offer.
expectsAcceptanceOf.price Número Obligatorio: Es el precio de compra del contenido. El precio debe ser un valor positivo distinto de cero. Para las entidades con un precio de USD 0.00, especifica la categoría como "gratuito".
expectsAcceptanceOf.priceCurrency Texto Obligatorio: Es 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 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 ver los temas relacionados con estas propiedades:

Identificadores

Los feeds de acciones de contenido 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 Muy recomendable: 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 Acciones en Relojes.

En la siguiente tabla, se enumeran los identificadores y las subpropiedades aceptados de la propiedad identifier. Consulta el ejemplo de identificador o EIDR en la sección de ejemplos del feed de Acciones en Relojes.
Propiedad Tipo esperado Descripción
@type Texto Obligatorio: Siempre se establece en PropertyValue.
propertyID Texto Obligatorio: Admitimos los siguientes tipos de ID:
  • 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: El ID de variante de Gracenote (TMS) (por ejemplo, MV000398520000).
  • WIKIDATA_ID: El ID de WikiData (por ejemplo, Q134773).
  • IMDB_ID: El ID de IMDB (por ejemplo, tt0109830).
  • OPTA_ID: El ID de OPTA Sports
  • STATS_ID: El ID de rendimiento de STATS.
  • VIP_TIMES_ID: El ID de Japan VIPTimes (Nihon Tarento Meikan) para talentos japoneses.
  • DMA_ID: Es el código de área de marketing designada 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 use 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 de EIDR

El EIDR (abreviatura de Entertainment Identifier Registry) es un sistema de identificadores únicos a nivel global para una amplia variedad de contenido multimedia, incluidos largometrajes y programas de televisión. El sistema de identificación resuelve un identificador en 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 Texto Muy recomendable: Un identificador de EIDR (registro de identificadores de entretenimiento) representa, en el nivel más general o abstracto, una obra de cine o televisión.

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

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

Consulta el ejemplo de identificador o EIDR en la sección de ejemplos de feeds de Watch Actions.
editEIDR Texto Muy recomendable: Un identificador de EIDR (registro de identificadores de entretenimiento) representa una edición específica de una obra de cine o televisión.

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

Por ejemplo, la película conocida como "Ghostbusters", cuyo título EIDR 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 identificador o EIDR en la sección de ejemplos del feed de Acciones de reproducció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 con clasificación "R" en EE.UU. debe tener un valor Movie.contentRating de "MPAA R".
  • Una serie de TV con clasificación "TV-MA" en EE.UU. debe tener un valor 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 y 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
Mali (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
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 (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 URI.
@type Texto Obligatorio: Siempre se establece 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 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 establece en PropertyValue.
identifier.propertyID Texto Obligatorio: Siempre se establece en DMA_ID.
identifier.value Texto Obligatorio: Es el código DMA de la región.

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