Propriétés communes des actions de visionnage

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette section décrit en détail les propriétés communes des actions de visionnage.

Propriétés du balisage d'action

Propriété Type attendu Description
@type Texte Obligatoire : toujours défini sur WatchAction.
target Point d'entrée Obligatoire : objet cible permettant de mapper les liens profonds avec différentes plates-formes Google.
target.@type Texte Obligatoire : toujours défini sur EntryPoint.
target.urlTemplate URL Obligatoire : lien profond qui redirige les utilisateurs vers votre application ou votre plate-forme, et lance la lecture du contenu.
target.inLanguage Texte Facultatif : langue d'origine de la série au format BCP 47.
target.actionPlatform Texte Obligatoire : plates-formes mappées avec 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 sur les navigateurs Web mobiles.
  • http://schema.org/AndroidPlatform: plates-formes de recherche et de PlayGuide dans l'application Android.
  • http://schema.org/AndroidTVPlatform : plate-forme Android TV dans l'application Android TV.
  • http://schema.org/IOSPlatform : plate-forme de recherche sur l'application iOS.
  • http://schema.googleapis.com/GoogleVideoCast : plates-formes Cast et Home sur un appareil Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast : plates-formes Cast et Home sur un appareil Chromecast (actions d'écoute uniquement).
Pour connaître les exigences, consultez la section Types de plates-formes.
target.additionalProperty PropertyValue Obligatoire si applicable : liste de paires propriété-valeur pour représenter les propriétés supplémentaires du lien profond. Voici quelques exemples :
  • contentLanguage: langue de diffusion (dub), au format BCP 47. Si le contenu est doublé dans une autre langue, cette propriété est obligatoire. Utilisez un tableau pour plusieurs codes de langue.
  • subtitleLanguage : langues des sous-titres au format BCP 47. Utilisez un tableau pour plusieurs codes de langue.
  • cameraAngle: angle de la caméra pour le contenu (par exemple, "Niveau des yeux" et "Grand angle"). Si le contenu est disponible sous différents angles, cette propriété est obligatoire. Utilisez un tableau pour plusieurs angles de caméra.
  • videoFormat: format de fichier utilisé pour stocker la date de la vidéo numérique. Par exemple, "SD" pour la définition standard et "HD" pour la 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 l'exemple additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification (ActionAccessSpecification) Obligatoire : objet de spécification d'accès aux actions qui décrit les exigences d'accès au contenu. Consultez Propriétés des spécifications d'accès aux actions.

Consultez les pages suivantes pour les sujets liés à ces propriétés:

Propriétés des spécifications des accès pour l'action

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

Obligatoire : exigence d'accès au contenu. Pour en savoir plus, consultez la section Type de paywall.

Si une entité représente un groupe de contenu, vous devez définir category sur les exigences d'accès les moins restrictives de son contenu. Par exemple, si TVSeries contient du contenu TVEpisode défini sur nologinrequired et quelques-uns sont définis sur subscription, définissez TVSeries sur nologinrequired.

actionAccessibilityRequirement.availabilityStarts Date

Obligatoire : date de fin de l'action, au format ISO 8601 (y compris le fuseau horaire).

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

L'entité correspondante doit être fournie dans le flux au moins sept jours avant la date de disponibilité de ce dernier. Vous augmenterez ainsi les chances que le contenu s'affiche sur les surfaces Google à temps.

actionAccessibilityRequirement.availabilityEnds Date Obligatoire : date de fin de l'action, au format ISO 8601 (y compris le fuseau horaire).
  • Doit être supérieure ou égale à 72 heures après availabilityStarts.
  • Si le contenu est toujours disponible après sa publication, fixez-le à 20 ans à compter de la date du jour.

Toute mise à jour de la date de disponibilité doit être effectuée dans le flux au moins sept jours avant la date de disponibilité. Vous augmenterez ainsi les chances que le contenu cesse d'apparaître sur les surfaces Google à la date de disponibilité.

actionAccessibilityRequirement.eligibleRegion Pays, Ville, État, GeoShape ou Texte Obligatoire : les régions où le contenu est disponible. Utilisez la chaîne spéciale EARTH si le contenu est disponible dans le monde entier.
actionAccessibilityRequirement.ineligibleRegion Pays, Ville, État ou GeoShape Obligatoire si applicable : régions où le contenu est soumis à des restrictions. Vous n'avez pas besoin de fournir cette propriété si le contenu est disponible partout dans le pays eligibleRegion.
actionAccessibilityRequirement.requiresSubscription Abonnement multimédia

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

  • Indiquez cette propriété si category est subscription ou externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offre Obligatoire si le contenu nécessite un achat : détails de l'offre associée au contenu. Fournissez les informations tarifaires dans les cas suivants :
  • Contenu à achat unique (rental ou purchase)
  • Contenu accessible sur abonnement nécessitant un achat supplémentaire de la part des abonnés (subscription ou externalsubscription)
Si le prix est de 0,00 €, supprimez complètement l'objet Offer et définissez category de l'objet ActionAccessSpecification sur free. Consultez la section Propriétés de l'offre.

Propriétés de l'abonnement multimédia

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 différents abonnements, chaque abonnement doit avoir un ID unique.
requiresSubscription.name Texte Obligatoire : nom de l'abonnement. Remarques :
  • Si le contenu est accessible via différents abonnements, ce nom doit correspondre à celui utilisé dans votre système d'authentification d'utilisateur. Par exemple, si un utilisateur peut accéder au contenu selon l'abonnement appelé Package 1, mais que le système d'authentification porte le nom PKG1a, utilisez PKG1.
  • Pour les fournisseurs de TVE, il s'agit du nom de l'authentificateur enregistré auprès de votre authentificateur TVE. Il s'agit d'une chaîne qui identifie de manière unique le nom de votre service avec l'authentificateur TVE.
requiresSubscription.sameAs URL Page décrivant l'abonnement.
requiresSubscription.identifier Texte Obligatoire si category est subscription ET commonTier est false : chaîne unique de cet abonnement qui représente l'accès à un groupe de contenu de votre catalogue de contenus multimédias.
  • 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 identique à votre identifiant de droit d'accès si vous fournissez une API Droits d'accès
requiresSubscription.authenticator Entreprise Obligatoire si category est externalsubscription : conteneur qui fournit les détails de l'authentificateur externe du fournisseur.
requiresSubscription.authenticator.@type Texte Obligatoire si category est externalsubscription : toujours défini sur Organization.
requiresSubscription.authenticator.name Texte Obligatoire si category est externalsubscription : nom du service d'authentification. Pour les fournisseurs de services télévisuels, sélectionnez TVE.
requiresSubscription.commonTier Booléen Obligatoire si applicable : obligatoire si la catégorie est définie sur "Abonnement". Pour en savoir plus sur "CommonTier", consultez la documentation sur les exigences concernant le niveau commun.

Exigences concernant l'API Entitlement

Une API Entitlement est requise si actionAccessibilityRequirement.category est subscription ou externalSubscription, et si votre offre d'abonnement comprend plusieurs packages ou niveaux, ou si elle est compatible avec des modules complémentaires. Ne l'incluez pas si votre abonnement comporte plusieurs niveaux et donne accès à tout le contenu de votre catalogue.

  • L'entreprise A propose une seule offre d'abonnement qui donne aux utilisateurs abonnés accès à tous les contenus disponibles: l'API ou l'identifiant de droit d'accès n'est pas obligatoire
  • L'entreprise B dispose d'un abonnement de base qui donne accès à certains contenus et d'un abonnement premium qui donne accès à des contenus premium : l'identifiant de droit d'accès / API est requis
  • L'entreprise C dispose d'un abonnement de base qui donne accès à certains contenus et ajoute des packages donnant accès à des contenus tiers : l'identifiant de droit d'accès ou l'API est requis.

Consultez les pages suivantes pour 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, spécifiez la catégorie "offert".
expectsAcceptanceOf.priceCurrency Texte Obligatoire : devise du prix au format ISO 4217 à trois lettres.
expectsAcceptanceOf.seller Entreprise Entreprise proposant 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, la page d'accueil du vendeur).

Consultez les pages suivantes pour les sujets liés à ces propriétés:

Identifiants

Les flux Media Action acceptent divers identifiants qui permettent d'identifier une entité de manière non ambiguë. Ces identifiants peuvent accélérer le rapprochement entre le contenu de votre flux et le contenu des bases de données de Google. Bien que la plupart de ces identifiants puissent être ajoutés au flux à l'aide de la propriété identifier sur différents types d'entités, les EIDR ont leur propre propriété représentative. Les deux points sont abordés ci-dessous.

Propriétés des identifiants

Propriété Type attendu Description
identifier Texte Fortement recommandé : un 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 répertorie les identifiants et sous-propriétés acceptés de la propriété identifier. Consultez la section Exemples de flux/identifiant dans la section "Exemples d'actions liées aux vidéos regardées".
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).
  • . Cela ne s'applique pas aux entités "Organization" et "BroadcastService" où 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: ID sportif OPTA.
  • STATS_ID : ID des performances des statistiques.
  • DMA_ID : indicatif de zone commerciale désignée des États-Unis, utilisé dans l'objet GeoShape.
  • _PARTNER_ID_: cette propriété doit contenir la chaîne "&_Partner_ID_ID", et la valeur doit être un ID unique utilisé par un fournisseur de services en interne ou en externe afin d'identifier l'entité (par exemple, 12345 ou a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Texte Obligatoire : valeur du système d'ID spécifié.

Propriétés EIDR

EIDR (abréviation de "Entertainment Identifier Registry") est un système d'identification unique au monde pour un large éventail de contenus multimédias, y compris les films et les programmes télévisés. Le système d'identification associe un identifiant à un enregistrement de métadonnées associé à des titres de premier niveau, à des 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é : l'identifiant EIDR (Entertainment Identifier Registry) représente, de manière plus générale ou abstraite, une œuvre de cinéma 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, titleEIDR pour le film animé, appelé "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J&Seet;" dans la section Actions Actions
.

editEIDR Texte Fortement recommandé : un identifiant EIDR (Entertainment Identifier Registry) correspond à une modification/une édition spécifique d'une œuvre cinématographique ou télévisée. Cette propriété est disponible sur les pages de caractéristiques.

Agences de classification de contenu

Utilisez les valeurs de cette table pour BroadcastService.contentRating, Movie.contentRating et TVSeries.contentRating. Le nom de l'organisme de classification doit être ajouté à la valeur de la note. Exemples :

  • Un film classé aux États-Unis doit avoir la valeur Movie.contentRating MPAA R&T.
  • Pour les séries télévisées classées "TV-MA" aux États-Unis, la valeur TVSeries.contentRating doit être définie sur "TVPG TV-MA".

Pays Agence de classification TV Agence d'évaluation de films
Albanie (AL) Non disponible Non disponible
Angola (AO) Non disponible CEI
Antigua-et-Barbuda (AG) Non disponible MPAA
Argentine (AR) INCAA INCAA
Arménie (AM) Non disponible MKRF/RUSSIE
Aruba (AW) Non disponible Non disponible
Australie (AU) ACB TV Films ACB
Autriche (AT) FSK FSK
Azerbaïdjan (AZ) Non disponible MKRF/RUSSIE
Bahreïn (BH) Non disponible MPAA
Biélorussie (BY) Non disponible MKRF/RUSSIE
Belgique (BE) Non disponible MPAA
Belize (BZ) Non disponible Non disponible
Bénin (BJ) Non disponible Code CNC
Bolivie (BO) Non disponible MPAA
Bosnie-Herzégovine (BA) Non disponible MPAA
Botswana (BW) Non disponible MPAA
Brésil (BR) CLASSEMENT CLASSEMENT
Burkina Faso (BF) Non disponible Code CNC
Cambodge (KH) Non disponible Non disponible
Canada (CA) Canada_TV CVRV
Cap-Vert (CV) Non disponible CEI
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 GRIPLM
Tchéquie (CZ) Non disponible CZFILM
Danemark (DK) Non disponible CMYP
Équateur (EC) 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 Code CNC
Allemagne (DE) FSK FSK
Grèce (GR) ESR GRIPLM
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 Code 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/RUSSIE
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 du Nord (MK) Non disponible MPAA
Malaisie (MY) Non disponible FCBM
Mali (ML) Non disponible Code CNC
Malte (MT) Non disponible CMAA
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) SA OFLC
Nicaragua (NI) Non disponible MPAA
Niger (NE) Non disponible Code 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 CEI
Qatar (QA) Non disponible MPAA
Russie (RU) MKRF/RUSSIE MKRF/RUSSIE
Rwanda (RW) Non disponible Code 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/RUSSIE
Tanzanie (TZ) Non disponible MPAA
Thaïlande (TH) Non disponible BFVC
Togo (TG) Non disponible Code CNC
Trinité-et-Tobago (TT) Non disponible Non disponible
Turquie (TR) RTÜK ECBMCT
Turkménistan (TM) Non disponible MKRF/RUSSIE
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/RUSSIE
Venezuela (VE) Non disponible RESORTEVIOLENCIE
Viêt Nam (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 : code pays à deux lettres ISO 3166-1 alpha-2.
postalCode Texte Facultatif : liste d'un ou de plusieurs codes postaux et/ou codes FSA (Forward Trier Area)
identifier PropertyValue Facultatif : ID de zone de marché désignée, qui identifie une région des États-Unis où les utilisateurs reçoivent les mêmes chaînes et programmes.
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 (FSA) et de codes postaux:

{
  "@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"
    }
  ]
}