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:
|
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:
|
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. |
Páginas relacionadas con el lenguaje de marcado de acciones
Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades:
- Descripción general del lenguaje de marcado de acciones
- Identifica los vínculos directos específicos de la plataforma para tu contenido
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
|
actionAccessibilityRequirement.availabilityStarts |
Fecha | Obligatorio: Es la fecha en la que la acción estará disponible, en ISO Formato 8601 (incluida la zona horaria)
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)
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
|
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:
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:
|
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.
|
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
Páginas relacionadas con suscripciones a medios
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:
|
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:
- Una lista de códigos postales (por ejemplo, Canadá, EE.UU. o cualquier otro código postal)
- Una lista de áreas de clasificación directa de Canadá
- Un ID de Área de mercado designada (DMA): Es un identificador de una región de Estados Unidos donde las personas reciben los mismos canales y programas de televisión.
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"
}
]
}