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:
|
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:
|
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. |
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 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
|
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).
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).
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.
|
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:
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:
|
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.
|
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
Páginas relacionadas con las suscripciones a medios
Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades:
- Descripción general de la suscripción a contenido multimedia
- Identifica el requisito de acceso para tu contenido
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. |
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. 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:
|
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:
- Una lista de códigos postales (por ejemplo, códigos de EE.UU., Canadá y otros)
- Una lista de las áreas de clasificación de Canadá
- Un ID de Área de mercado designada (DMA): Es un identificador de una región de los Estados Unidos en la que las personas reciben los mismos programas y canales de televisión.
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"
}
]
}