Actions de visionnage propriétés communes

Cette section fournit des informations détaillées sur les propriétés courantes des actions de visionnage.

Propriétés de balisage d'action

Propriété Type attendu Description
@type Texte Obligatoire : toujours défini sur WatchAction.
target EntryPoint Obligatoire : un objet cible qui fournit la cartographie profond des liens vers différentes plates-formes Google.
target.@type Texte Obligatoire : toujours défini sur EntryPoint.
target.urlTemplate URL Obligatoire : A profond qui redirige les utilisateurs vers votre application ou votre plate-forme, et qui lance la lecture du contenu.
target.inLanguage Texte Facultatif – Version originale de la série BCP 47 .
target.actionPlatform Texte Obligatoire : plates-formes mappées à urlTemplate Les actions multimédias sont compatibles avec les éléments suivants:
  • http://schema.org/DesktopWebPlatform: plate-forme de recherche sur les navigateurs Web pour ordinateur.
  • http://schema.org/MobileWebPlatform: plate-forme de recherche activée les navigateurs Web mobiles.
  • http://schema.org/AndroidPlatform: Recherche et PlayGuide plates-formes sur l'application Android.
  • http://schema.org/AndroidTVPlatform: Android TV sur l'application Android TV.
  • http://schema.org/IOSPlatform: plate-forme de recherche sur iOS l'application.
  • http://schema.googleapis.com/GoogleVideoCast: cast et Plates-formes Google Home sur un appareil Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: cast et Plates-formes pour la maison connectée sur un appareil Chromecast (Actions d'écoute uniquement).
Consultez le Plate-forme types pour connaître les exigences.
target.additionalProperty PropertyValue Obligatoire, le cas échéant : liste des paires propriété-valeur à représentent les propriétés supplémentaires du lien profond. Cela peut inclure le suivantes:
  • contentLanguage: langue de diffusion (doublon), en BCP 47 format. Si le contenu est doublé dans une autre langue, est obligatoire. Utilisez un tableau pour les codes de langue multiples.
  • subtitleLanguage: langues des sous-titres sous-titres, dans BCP 47 format. Utilisez un tableau pour les codes de langue multiples.
  • cameraAngle: angle de la caméra pour le contenu. pour Exemple : "Au niveau des yeux" et "Mode Grand angle". Si le contenu est disponible dans sous différents angles de caméra, cette propriété est obligatoire. Utiliser un tableau pour sous plusieurs angles.
  • videoFormat: format de fichier utilisé pour stocker les données date de la vidéo Exemple : "SD" pour la définition standard et la HD pour haute définition. Les formats vidéo acceptés sont les suivants : SD, HD, 2K, 4K et 8K. Utilisez un tableau pour plusieurs formats vidéo.
Consultez le additionalProperty à titre d'exemple.
actionAccessibilityRequirement ActionAccessSpecification Obligatoire : action un objet de spécification d'accès qui décrit les exigences d'accès le contenu. Voir Action Propriétés de la spécification d'accès.

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés:

Propriétés de spécification d'accès aux actions

Propriété Type attendu Description
actionAccessibilityRequirement.@type Texte Obligatoire : toujours défini sur ActionAccessSpecification.
actionAccessibilityRequirement.category Texte

Obligatoire : il s'agit d'une condition d'accès au contenu. Pour plus pour en savoir plus, consultez Type de paywall.

Si une entité représente un groupe de contenu, vous devez définir category à l'exigence d'accès la moins restrictive de son contenu. Par exemple, si un TVSeries a des Contenu TVEpisode défini sur nologinrequired et quelques autres avec subscription, définissez cette De TVSeries à nologinrequired.
actionAccessibilityRequirement.availabilityStarts Date

Obligatoire : date à partir de laquelle l'action est disponible, dans ISO Format 8601 (fuseau horaire compris).

  • La date peut être définie dans le futur.

L'entité correspondante doit obligatoirement figurer dans le flux à l'adresse au moins sept jours avant sa date de disponibilité. Cela permet d'améliorer les chances que le contenu s'affiche dans les temps sur les surfaces Google.

actionAccessibilityRequirement.availabilityEnds Date Obligatoire : date à partir de laquelle l'action n'est plus disponible. en ISO Format 8601 (fuseau horaire compris).
  • Doit être supérieur ou égal à 72 heures après availabilityStarts
  • Si le contenu est toujours disponible après sa publication, définissez ce à 20 ans de la date actuelle.

Vous devez mettre à jour la date "availabilityEnds" dans le flux au moins sept jours avant la date "availabilityEnds". Ce qui augmenteront les chances que le contenu cesse d'apparaître sur Google. sur la valeur "availabilityEnds".

actionAccessibilityRequirement.eligibleRegion Pays, Ville, État GeoShape, ou Texte Obligatoire : régions dans lesquelles le contenu est disponible. Utilisez le Chaîne spéciale EARTH si le contenu est disponible dans le monde entier.
actionAccessibilityRequirement.ineligibleRegion Pays, Ville, State ou GeoShape Obligatoire, le cas échéant : régions où le contenu est restreintes. Vous n'avez pas besoin de définir cette propriété si le contenu est disponible partout dans le pays suivant : eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Obligatoire, le cas échéant : détails des dont les utilisateurs ont besoin pour accéder au contenu. Voir Propriétés d'abonnement multimédia :

  • Spécifiez cette propriété si category est subscription ou externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offre Obligatoire si le contenu nécessite un achat : détails de l' associée au contenu. Indiquez les informations tarifaires pour le les cas suivants:
  • Contenu de type achat unique (rental ou purchase).
  • Contenus disponibles par abonnement nécessitant un achat supplémentaire auprès des abonnés (subscription ou externalsubscription).
Si le prix est de 0,00, supprimez entièrement l'objet Offer et définissez category de l'objet ActionAccessSpecification sur free. Voir Propriétés de l'offre :

Propriétés d'abonnement à des contenus multimédias

Obligatoire si actionAccessibilityRequirement.category est subscription ou externalSubscription.

Propriété Type attendu Description
requiresSubscription.@type Texte Obligatoire : toujours défini sur MediaSubscription
requiresSubscription.@id URL Obligatoire : identifiant unique de l'abonnement. Si le contenu est accessible via des abonnements différents, chaque abonnement doit un identifiant unique.
requiresSubscription.name Texte Obligatoire : nom de l'abonnement. Notez les points suivants:
  • Si le contenu est accessible via différents abonnements, le nom doit correspondre à celui utilisé dans votre système d'authentification des utilisateurs. Pour Par exemple, si un utilisateur peut accéder au contenu en fonction de l'abonnement nommé Package 1, mais le système d'authentification utilise le nom PKG1a, utilisez PKG1.
  • Pour les fournisseurs TVE, il s'agit du nom d'authentificateur enregistré auprès de votre authentificateur TVE. Il s'agit d'une chaîne qui identifie de manière unique votre nom du service avec TVE Authenticator.
requiresSubscription.sameAs URL Page de description de l'abonnement.
requiresSubscription.identifier Texte Obligatoire si category correspond à subscription ET commonTier est false – Chaîne unique pour cet abonnement qui représente l'accès à un groupe de contenus de votre catalogue multimédia.
  • Google vous recommande d'utiliser la syntaxe suivante pour l'identifiant:
    nom de domaine + deux-points (:) + niveau d'accès au contenu. Exemples : example.com:basic, example.com:premium, example.com:sports
  • Cette propriété sera la même que votre identifiant des droits d'accès si vous fournissez une API de droit d'accès
requiresSubscription.authenticator Entreprise Obligatoire si category est externalsubscription : conteneur qui fournit le les détails de l'authentificateur du fournisseur externe.
requiresSubscription.authenticator.@type Texte Obligatoire si category est externalsubscription : toujours défini sur Organization
requiresSubscription.authenticator.name Texte Obligatoire si category est externalsubscription : nom de l'authentification Google Cloud. Pour les fournisseurs de services télévisés, définissez ce paramètre sur TVE.
requiresSubscription.commonTier Valeur booléenne Obligatoire si applicable : obligatoire si la catégorie est définie sur abonnement. Pour en savoir plus sur le champ CommonTier, consultez le commun exigences de niveau de service.

Exigences concernant l'API Entitlement

Une API de droit d'accès est obligatoire si actionAccessibilityRequirement.category est subscription ou externalSubscription et votre offre d'abonnement comprend plusieurs des packages ou des niveaux ou propose une prise en charge complémentaire. N'incluez pas cet attribut si votre est à plusieurs niveaux et vous donne accès à tous les contenus de votre catalogue.

  • L'entreprise A propose une offre d'abonnement unique qui offre aux utilisateurs abonnés Accès à tous les contenus disponibles: l'identifiant / l'API du droit d'accès n'est pas obligatoire
  • L'entreprise B a un abonnement de base qui donne accès à certains contenus et un abonnement Premium qui donne accès à du contenu premium: Veuillez indiquer l'identifiant du droit d'accès / l'API
  • L'entreprise C dispose d'un abonnement de base qui donne accès à certains contenus et des packages qui permettent d'accéder à du contenu tiers: Veuillez indiquer l'identifiant du droit d'accès / l'API

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés:

Propriétés de l'offre

Propriété Type attendu Description
expectsAcceptanceOf.@type Texte Obligatoire : toujours défini sur Offer.
expectsAcceptanceOf.price Number Obligatoire : prix d'achat du contenu. Le prix doit être une valeur positive non nulle. Pour les entités dont le prix est de 0,00 €, veuillez spécifier la catégorie "sans frais".
expectsAcceptanceOf.priceCurrency Texte Obligatoire : indique la devise du prix, en trois lettres. ISO 4217.
expectsAcceptanceOf.seller Entreprise Organisation qui propose l'achat de contenu.
expectsAcceptanceOf.seller.@type Texte Toujours défini sur Organization.
expectsAcceptanceOf.seller.name Texte Nom du vendeur.
expectsAcceptanceOf.seller.sameAs Texte URL d'une page Web qui identifie le vendeur. par exemple, page d'accueil du vendeur.

Page liée à l'offre

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés:

Identifiants

Les flux d'actions média acceptent divers identifiants qui permettent d'identifier sans ambiguïté. Ces identifiants permettent d'accélérer le contenu de votre flux et celui de la plate-forme les bases de données. Même si la plupart de ces identifiants peuvent être ajoutés au flux à l'aide de l'attribut identifier sur différents types d'entités, les EIDR ont leur propre la propriété représentative. Ces deux points sont abordés ci-dessous.

Propriétés de l'identifiant

Propriété Type attendu Description
identifier Texte Fortement recommandé : identifiant, généralement externe, qui identifie sans ambiguïté une entité donnée. Plusieurs identifiants sont autorisés.

Cette propriété est disponible pour tous les types d'entités "Action de visionnage".

Le tableau ci-dessous liste les identifiants et les sous-propriétés acceptés de la propriété identifier. Consultez la section Exemple d'identifiant/EIDR dans la section consacrée aux exemples de flux pour les actions de visionnage.
Propriété Type attendu Description
@type Texte Obligatoire : toujours défini sur PropertyValue.
propertyID Texte Obligatoire – Nous acceptons les types d'ID suivants:
  • TMS_ROOT_ID: ID racine Gracenote (TMS) (par exemple, 15829).
    • pour en savoir plus. Cela ne s'applique pas à l'organisation Entités BroadcastService dans lesquelles seul TMS_ID doit être utilisé
  • TMS_ID: ID de la variante Gracenote (TMS) (par exemple, MV000398520000).
  • WIKIDATA_ID: ID WikiData (par exemple, Q134773).
  • IMDB_ID: ID IMDB (par exemple, tt0109830).
  • OPTA_ID: identifiant OPTA Sports.
  • STATS_ID: ID STATS Perform.
  • VIP_TIMES_ID: identifiant VIPTimes (Nihon Tarento Meikan) des talents japonais.
  • DMA_ID: indicatif de zone commerciale désignée des États-Unis, utilisé dans GeoShape.
  • _PARTNER_ID_: cette propriété doit contenir la chaîne "_PARTNER_ID_", la valeur doit être un identifiant unique utilisé par le fournisseur de services, en interne ou en externe, d'identifier l'entité. (par exemple, 12345 ou a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Texte Obligatoire : valeur du système d'identification spécifié.

Propriétés EIDR

Le registre EIDR (Entertainment Identifier Registry) est un système d'identification unique au niveau mondial pour un large éventail de contenus multimédias, y compris des films et des émissions télévisées. Le système d'identification résout un identifiant en un enregistrement de métadonnées associé aux titres de premier niveau, aux modifications, etc. Le tableau suivant liste les propriétés associées à l'EIDR et à leur utilisation.

Propriété Type attendu Description
titleEIDR Texte Fortement recommandé : identifiant EIDR (Entertainment Identifier Registry) qui représente, au niveau le plus général/abstrait, une œuvre de film ou de télévision.

Cette propriété est disponible sur les pages de spécifications d'entités TVSeries, TVSeason, TVEpisode et Movie.

Par exemple, le titre EIDR du film "SOS Fantômes" est "10.5240/7EC7-228A-510A-053E-CBB8-J".

Consultez l'exemple d'identifiant/EIDR dans la section "Exemples de flux pour les actions de visionnage".
editEIDR Texte Fortement recommandé : un identifiant EIDR (Entertainment Identifier Registry) représente le montage/l'édition d'une œuvre d'un film ou d'une émission télévisée.

Cette propriété est disponible sur les pages de spécification des entités TVEpisode et Movie.

Par exemple, un film appelé "SOS Fantômes" dont le titre EIDR est "10.5240/7EC7-228A-510A-053E-CBB8-J", a plusieurs modifications, par exemple "10.5240/1F2A-E1C5-680A-14C6-E76B-I" et "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

titleEIDR est obligatoire lorsque editEIDR est fourni.

Consultez l'exemple d'identifiant/EIDR dans la section dédiée aux exemples de flux d'actions de visionnage.

Agences de classification du contenu

Utilisez les valeurs de ce tableau pour BroadcastService.contentRating, Movie.contentRating et TVSeries.contentRating. L'agence de notation doit être ajoutée au début de la valeur de notation. Exemples :

  • Un film noté "R" aux États-Unis doit avoir la valeur Movie.contentRating "MPAA R".
  • Série télévisée notée "TV-MA" aux États-Unis doit avoir la valeur TVSeries.contentRating "TVPG TV-MA".

Pays Agence de classification TV Agence d'évaluation des films
Albanie (AL) Non disponible Non disponible
Angola (AO) Non disponible CCE
Antigua-et-Barbuda (AG) Non disponible MPAA
Argentine (AR) INCAA INCAA
Arménie (AM) Non disponible MKRF/RUSSIA
Aruba (AW) Non disponible Non disponible
Australie (AU) ACB TV ACB Movies
Autriche (AT) FSK FSK
Azerbaïdjan (AZ) Non disponible MKRF/RUSSIA
Bahreïn (BH) Non disponible MPAA
Biélorussie (BY) Non disponible MKRF/RUSSIA
Belgique (BE) Non disponible MPAA
Belize (BZ) Non disponible Non disponible
Bénin (BJ) Non disponible CNC
Bolivie (BO) Non disponible MPAA
Bosnie-Herzégovine (BA) Non disponible MPAA
Botswana (BW) Non disponible MPAA
Brésil (BR) CLASSÉ CLASSÉ
Burkina Faso (BF) Non disponible CNC
Cambodge (KH) Non disponible Non disponible
Canada (CA) CA_TV CHVRS
Cap-Vert (CV) Non disponible CCE
Chili (CL) Non disponible MPAA
Colombie (CO) Non disponible MPAA
Costa Rica (CR) Non disponible MPAA
Croatie (HR) Non disponible Non disponible
Chypre (CY) Non disponible GRFILM
Tchéquie (CZ) Non disponible CZFILM
Danemark (DK) Non disponible MCCYP
Équateur (CE) Non disponible MPAA
Égypte (EG) Non disponible MPAA
Salvador (SV) Non disponible MPAA
Estonie (EE) Non disponible EEFILM
Fidji (FJ) Non disponible Non disponible
Finlande (FI) Non disponible MEKU
France (FR) CSA CSA
Gabon (GA) Non disponible CNC
Allemagne (DE) FSK FSK
Grèce (GR) ESR GRFILM
Guatemala (GT) Non disponible MPAA
Haïti (HT) Non disponible Non disponible
Honduras (HN) Non disponible MPAA
Hong Kong (HK) CA FCO
Hongrie (HU) Non disponible MPAA
Islande (IS) Non disponible KIJKWIJZER
Inde (IN) CBFC CBFC
Indonésie (ID) KPI LSF
Irlande (IE) Non disponible IFCO
Italie (IT) AGCOM AGCOM
Côte d'Ivoire (CI) Non disponible CNC
Jamaïque (JM) Non disponible MPAA
Japon (JP) N/A EIRIN
Jordanie (JO) Non disponible MPAA
Kazakhstan (KZ) Non disponible MRKF
Corée (KR) KMRB KMRB
Koweït (KW) Non disponible MPAA
Kirghizstan (KG) Non disponible MKRF/RUSSIA
Laos (LA) Non disponible Non disponible
Lettonie (LV) Non disponible NKCLV
Liban (LB) Non disponible MPAA
Lituanie (LT) Non disponible Non disponible
Luxembourg (LU) Non disponible KIJKWIJZER
Macédoine (MK) Non disponible MPAA
Malaisie (MY) Non disponible FCBM
Mali (ML) Non disponible CNC
Malte (MT) Non disponible MCCAA
Maurice (MU) Non disponible BBFC
Mexique (MX) RTC RTC
Moldavie (MD) Non disponible Non disponible
Namibie (NA) Non disponible Non disponible
Népal (NP) Non disponible MPAA
Pays-Bas (NL) KIJKWIJZER KIJKWIJZER
Nouvelle-Zélande (NZ) BSA OFLC
Nicaragua (NI) Non disponible MPAA
Niger (NE) Non disponible CNC
Norvège (NO) Non disponible MEDIETILSYNET
Oman (OM) Non disponible MPAA
Panama (PA) Non disponible MPAA
Papouasie - Nouvelle-Guinée (PG) Non disponible MPAA
Paraguay (PY) Non disponible MPAA
Pérou (PE) Non disponible MPAA
Philippines (PH) MTRCB MTRCB
Pologne (PL) Non disponible MPAA
Portugal (PT) Non disponible CCE
Qatar (QA) Non disponible MPAA
Russie (RU) MKRF/RUSSIA MKRF/RUSSIA
Rwanda (RW) Non disponible CNC
Arabie saoudite (SA) Non disponible MPAA
Sénégal (SN) Non disponible MPAA
Singapour (SG) Non disponible MDA
Slovaquie (SK) Non disponible MPAA
Slovénie (SI) Non disponible MPAA
Afrique du Sud (ZA) FPB FPB
Espagne (ES) SETSI ICAA
Sri Lanka (LK) Non disponible Non disponible
Suède (SE) Non disponible SMSA
Suisse (CH) FSK FSK
Taïwan (TW) Non disponible MOCTW
Tadjikistan (TJ) Non disponible MKRF/RUSSIA
Tanzanie (TZ) Non disponible MPAA
Thaïlande (TH) Non disponible BFVC
Togo (TG) Non disponible CNC
Trinité-et-Tobago (TT) Non disponible Non disponible
Turquie (TR) RTÜK ECBMCT
Turkménistan (TM) Non disponible MKRF/RUSSIA
Ouganda (UG) Non disponible MPAA
Ukraine (UA) Non disponible Non disponible
Émirats arabes unis (AE) Non disponible MPAA
Royaume-Uni (GB) BBFC BBFC
États-Unis (US) TV_PG MPAA
Uruguay (UY) Non disponible MPAA
Ouzbékistan (UZ) Non disponible MKRF/RUSSIA
Venezuela (VE) Non disponible RESORTEVIOLENCIA
Vietnam (VN) Non disponible MCST
Zambie (ZM) Non disponible MPAA
Zimbabwe (ZW) Non disponible MPAA

Propriétés GeoShape

Un objet GeoShape contient l'un des types de données suivants:

Propriété Type attendu Description
@id URL Obligatoire : identifiant de la région géographique au format URI.
@type Texte Obligatoire : toujours défini sur GeoShape.
addressCountry Texte Obligatoire : il s'agit de l'URL à deux lettres ISO Code pays 3166-1 alpha-2.
postalCode Texte Facultatif : liste d'un ou plusieurs codes postaux et/ou codes RTA (zone de tri d'acheminement).
identifier PropertyValue Facultatif : A L'ID de la zone de marché désignée (DMA, Designated Market Area), qui est une identifiant d'une région aux États-Unis où les utilisateurs reçoivent le les mêmes chaînes et programmes de télévision.
identifier.@type Texte Obligatoire : toujours défini sur PropertyValue.
identifier.propertyID Texte Obligatoire : toujours défini sur DMA_ID.
identifier.value Texte Obligatoire : code de zone de marché désignée de la région.

Exemple d'objet GeoShape contenant une liste de codes postaux:

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

Exemple d'objet GeoShape contenant une combinaison de codes postaux et RTA:

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

Exemple d'objet GeoShape contenant un ID de zone de marché désignée:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}