Ver acciones propiedades comunes

En esta sección, se proporcionan detalles de las propiedades comunes de las Acciones de reproducción.

Propiedades de lenguaje de marcado de acciones

Propiedad Tipo esperado Descripción
@type Texto Obligatorio: Siempre se establece en WatchAction.
target EntryPoint Obligatorio: Un objeto de destino que ofrece la asignación de profundo vínculos a varias plataformas de Google.
target.@type Texto Obligatorio: Siempre se establece en EntryPoint.
target.urlTemplate URL Obligatoria: A profundo que lleve a los usuarios a tu aplicación o plataforma y que inicie reproducción del contenido.
target.inLanguage Texto Opcional: Idioma original de la serie en BCP 47 de un conjunto de datos tengan un formato común.
target.actionPlatform Texto Obligatorio: las plataformas con las que se asignan 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 activada navegadores web móviles.
  • http://schema.org/AndroidPlatform: Búsqueda y PlayGuide plataformas en la app para Android.
  • http://schema.org/AndroidTVPlatform: Android TV plataforma en la app de Android TV.
  • http://schema.org/IOSPlatform: Plataforma de búsqueda en iOS .
  • http://schema.googleapis.com/GoogleVideoCast: transmitir y Plataformas de Google Home en un dispositivo Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: transmitir y Plataformas de Home en un dispositivo Chromecast (solo Acciones de escucha)
Consulta la Plataforma de tipos 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 la lo siguiente:
  • contentLanguage: El idioma de la transmisión (dob), en BCP 47 formato. Si el contenido está doblado en un idioma diferente, este es obligatoria. Usa un array para varios códigos de idioma.
  • subtitleLanguage: Los idiomas de los subtítulos o subtítulos, en BCP 47 formato. Usa un array para varios códigos de idioma.
  • cameraAngle: El ángulo de la cámara para el contenido. para ejemplo, “A nivel del ojo” y “High-Angle”. Si el contenido está disponible en diferentes ángulos de cámara, esta propiedad es obligatoria. Usa un array para múltiples ángulos de cámara.
  • videoFormat: Es el formato de archivo que se usa para almacenar el fecha del video; por ejemplo, "SD" para definición estándar y "HD" para en alta definición. Entre los formatos de video válidos, se incluyen SD, HD, 2K, 4K y 8K. Usa un array para varios formatos de video.
Consulta la additionalProperty ejemplo.
actionAccessibilityRequirement ActionAccessSpecification Obligatoria: una acción objeto de especificación de acceso que describe el requisito de acceso de el contenido. Consulta la sección Acción Accede a las propiedades de especificación.

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

Propiedades de especificación de acceso a acciones

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

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

Si una entidad representa un grupo de contenido, debes establecer category al requisito de acceso menos restringido de su contenido. Por ejemplo, si un TVSeries tiene algunos Se estableció el contenido de TVEpisode en nologinrequired y algunos que están establecidos en subscription, establece este TVSeries a nologinrequired.
actionAccessibilityRequirement.availabilityStarts Fecha

Obligatorio: Es la fecha en la que la acción estará disponible, en ISO Formato 8601 (incluida la zona horaria)

  • La fecha se puede establecer en el futuro.

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

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

Es obligatorio realizar cualquier actualización en la fecha availabilityEnds en este campo. en el feed al menos 7 días antes de la fecha de availabilityEnds. Esta aumentará las posibilidades de que el contenido deje de aparecer en Google. disponibles en la fecha availabilityEnds.

actionAccessibilityRequirement.eligibleRegion País: Ciudad, Estado, GeoShape o Texto Obligatorio: Regiones en las que el contenido está disponible. Usa el una cadena especial EARTH si el contenido está disponible a nivel global.
actionAccessibilityRequirement.ineligibleRegion País: Ciudad, Estado o GeoShape Obligatorio si corresponde: Regiones en las que se muestra el contenido 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: Los detalles de que los usuarios necesitan para acceder al contenido. Consulta Propiedades de la suscripción a medios

  • Proporciona esta propiedad si category es subscription o externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Obligatorio si el contenido requiere una compra: Los detalles del oferta asociada con el contenido. Proporciona la información del precio de la los siguientes casos:
  • Contenido de compra única (rental o purchase)
  • Contenido basado en suscripciones que requiere una compra adicional 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 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: El ID único de la suscripción. Si el contenido se puede acceder a través de diferentes suscripciones, cada una debe tener con un ID único.
requiresSubscription.name Texto Obligatorio: Es el nombre de la suscripción. Observa lo siguiente:
  • Si se puede acceder al contenido a través de diferentes suscripciones, esta deben coincidir con el nombre en tu sistema de autenticación de usuarios. Para Por ejemplo, si un usuario puede acceder al contenido según la suscripción llamado Package 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 con tu autenticador de TVE. Es una cadena que identifica de forma única tu el nombre del 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 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:deportes
  • Esta propiedad será igual a tu identificador de derechos si proporcionas una API de derechos
requiresSubscription.authenticator Organization Obligatorio si category es externalsubscription: Es un contenedor que proporciona el elemento son 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 de la autenticación. servicio. Para proveedores de TVE, configúralo en TVE
requiresSubscription.commonTier Booleano Obligatorio si corresponde: Este campo es obligatorio si la categoría se establece en suscripción. Más información sobre commonTier en el común y de los requisitos de nivel.

Requisitos de la API de Entitlements

Una API de derechos es obligatorio si actionAccessibilityRequirement.category es subscription o externalSubscription y tu oferta de suscripción incluye múltiples paquetes o niveles, o tiene asistencia complementaria. No incluyas esto si tu 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 ofrece a los usuarios suscritos acceso a todo el contenido disponible: el identificador de derechos / la API no es obligatorio.
  • La Empresa B tiene una suscripción básica que brinda acceso a cierto contenido y una suscripción premium que brinda acceso a contenido premium: El identificador de derechos o la API es obligatorio
  • La Empresa C tiene una suscripción base que brinda acceso a cierto contenido y Complementos que brindan acceso a contenido de terceros: El identificador de derechos o la API es obligatorio

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

Propiedades de ofertas

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 de precio 0.00, especifica la categoría como “gratis”.
expectsAcceptanceOf.priceCurrency Texto Obligatorio: La moneda del precio en un formato de 3 letras ISO 4217.
expectsAcceptanceOf.seller Organization Corresponde a 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 La URL de una página web que identifica al vendedor por ejemplo, el 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 diversos identificadores que permiten identificar un de manera inequívoca. Estos identificadores pueden ayudar a acelerar la proceso de conciliación del contenido de su feed con el contenido de la bases de datos. Si bien la mayoría de estos identificadores se pueden agregar al feed mediante el identifier en varios tipos de entidades, los EIDR tienen sus propios propiedad representativa. Ambas opciones se analizan a continuación.

Propiedades de los identificadores

Propiedad Tipo esperado Descripción
identifier Texto Altamente recomendada: Es un identificador, generalmente externo, que identifica de manera inequívoca una entidad determinada. Se permiten varios identificadores.

Esta propiedad está disponible en todos los tipos de entidades de las acciones de observació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 reproducción.
Propiedad Tipo esperado Descripción
@type Texto Obligatorio: Siempre se establece en PropertyValue.
propertyID Texto Obligatorio: Se admiten los siguientes tipos de ID:
  • TMS_ROOT_ID: Es el ID raíz de Gracenote (TMS) (por ejemplo, 15829).
    • de Google Cloud. Esto no se aplica a la Organización ni Entidades BroadcastService en las que solo se debe usar TMS_ID
  • TMS_ID: Es 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 OPTA Sports.
  • STATS_ID: Es el ID de rendimiento de STATS.
  • VIP_TIMES_ID: Es el ID de Japan VIPTimes (Nihon Tarento Meikan) para los talentos japoneses.
  • DMA_ID: El código de área de marketing designado de EE.UU., que se utiliza en GeoShape.
  • _PARTNER_ID_: Esta propiedad debe contener la cadena. "_PARTNER_ID_", el valor debe ser un ID único que utilice un de forma interna o externa para identificar a 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

EIDR (abreviatura de Entertainment Identifier Registry) es un sistema de identificación único a nivel mundial 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 está asociado con títulos de nivel superior, ediciones y más. En la siguiente tabla, se enumeran las propiedades asociadas con EIDR y su uso.

Propiedad Tipo esperado Descripción
titleEIDR Texto Altamente recomendado: Un identificador EIDR (registro identificador de entretenimiento) representa, en el nivel más general o abstracto, una obra de cine o televisión.

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

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

Consulta Ejemplo de identificador/EIDR en la sección de ejemplos del feed de Acciones de reproducción.
editEIDR Texto Altamente recomendado: Un identificador EIDR (registro identificador de entretenimiento) representa una edición o edición específica de una obra de cine 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 "Ghostbusters" cuyo títuloEIDR 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”.

titleEIDR La propiedad es obligatoria cuando se proporciona editEIDR.

Consulta el ejemplo de identificador/EIDR en la sección de ejemplos del feed de acciones de reproducción.

Agencias de clasificación de contenido

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

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

País Agencia de calificación de TV Agencia de calificació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 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) CLASE CLASE
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 (CE) 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 (Georgia) 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 (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 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 (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 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 número de dos letras. ISO Código de país 3166-1 alpha-2
postalCode Texto Opcional: Lista de uno o más códigos postales o códigos FSA (área de clasificación directa).
identifier PropertyValue Opcional: A ID del Área de mercado designada (DMA), que es un identificador de una región de Estados Unidos donde las personas reciben el en los mismos canales y programas.
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 de DMA de 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 del 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"
    }
  ]
}