Actions de visionnage propriétés communes

Cette section fournit des informations détaillées sur les propriétés communes des actions Watch.

Propriétés du balisage d'action

Propriété Type attendu Description
@type Texte Obligatoire : toujours défini sur WatchAction.
target EntryPoint Obligatoire : un objet cible qui fournit le mappage des liens profonds vers différentes plates-formes Google.
target.@type Texte Obligatoire : toujours défini sur EntryPoint.
target.urlTemplate URL Obligatoire : un lien profond qui redirige les utilisateurs vers votre application ou 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 sur urlTemplate. Les actions média 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 Recherche et PlayGuide sur l'application Android.
  • http://schema.org/AndroidTVPlatform : plate-forme Android TV sur 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).
Consultez la section Types de plates-formes pour connaître les exigences.
target.additionalProperty PropertyValue Obligatoire, le cas échéant : liste de paires propriété/valeur représentant les propriétés supplémentaires du lien profond. Voici quelques exemples :
  • contentLanguage : langue de diffusion (doublage), au format BCP 47. Cette propriété est obligatoire si le contenu est doublé dans une autre langue. Utilisez un tableau pour plusieurs codes de langue.
  • subtitleLanguage : langues des sous-titres ou 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, "Eye-Level" et "High-Angle"). Cette propriété est obligatoire si le contenu est disponible sous différents angles de caméra. Utilisez un tableau pour plusieurs angles de caméras.
  • videoFormat : format de fichier utilisé pour stocker les données vidéo numériques (par exemple, "SD" pour la définition standard et "HD" pour la haute définition). Les formats vidéo acceptés sont SD, HD, 2K, 4K et 8K. Utilisez un tableau pour plusieurs formats vidéo.
  • audioDescriptionLanguage : tableau des langues audio compatibles, au format BCP 47, qui acceptent la description audio. Il s'agit d'un sous-ensemble du tableau contentLanguage.
Consultez l'exemple additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Obligatoire : objet de spécification d'accès Action qui décrit les exigences d'accès au contenu. Consultez Propriétés de spécification d'accès aux actions.

Consultez les pages suivantes pour en savoir plus sur les thèmes 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 : condition d'accès au contenu. Pour en savoir plus, consultez Type de paywall.

Si une entité représente un groupe de contenus, vous devez définir category sur l'exigence d'accès la moins restrictive de ses contenus. Par exemple, si un TVSeries comporte du contenu TVEpisode défini sur nologinrequired et quelques-uns définis sur subscription, définissez ce TVSeries sur nologinrequired.

actionAccessibilityRequirement.availabilityStarts Date

Obligatoire : date après laquelle l'action est disponible, 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 début de sa disponibilité. Cela augmentera les chances que le contenu s'affiche à temps sur les surfaces Google.

actionAccessibilityRequirement.availabilityEnds Date Obligatoire : date après laquelle l'action ne sera plus disponible, au format ISO 8601 (y compris le fuseau horaire).
  • Doit être égale ou supérieure à 72 heures après availabilityStarts.
  • Si le contenu est toujours disponible après sa publication, définissez cette date sur 20 ans à compter de la date actuelle.

Toute modification de la date availabilityEnds doit être apportée au flux au moins sept jours avant la date availabilityEnds. Cela augmentera les chances que le contenu cesse d'apparaître sur les surfaces Google à la date de fin de disponibilité.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape ou Text Obligatoire : 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 Country, City, State ou GeoShape Obligatoire, le cas échéant : régions où le contenu est soumis à restriction. Vous n'avez pas besoin de fournir cette propriété si le contenu est disponible partout dans eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Obligatoire, le cas échéant : informations sur l'abonnement dont les utilisateurs ont besoin pour accéder au contenu. Consultez Propriétés d'abonnement aux contenus multimédias.

  • 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. Indiquez les informations tarifaires pour les cas suivants :
  • Contenu à achat unique (rental ou purchase)
  • Contenus par 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 Propriétés de l'offre.
actionAccessibilityRequirement.additionalProperty PropertyValue Obligatoire, le cas échéant : référence au forfait d'abonnement qui s'affichera dans l'expérience.
actionAccessibilityRequirement.additionalProperty.name Texte Obligatoire : toujours défini sur "DisplaySubscriptionIdentifier"
actionAccessibilityRequirement.additionalProperty.value Texte Obligatoire : requiresSubscription.@id qui sera affiché pour l'entité.

Propriétés d'abonnement aux contenus multimédias

Obligatoire si actionAccessibilityRequirement.category est défini sur 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, chacun d'eux 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 de votre système d'authentification des utilisateurs. Par exemple, si un utilisateur peut accéder au contenu en fonction de l'abonnement Package 1, mais que le système d'authentification utilise le nom PKG1a, utilisez PKG1.
  • Pour les fournisseurs 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 auprès de TVE Authenticator.
  • Si l'abonnement comporte plusieurs noms, veuillez les spécifier sous forme de tableau de valeurs. Consultez l'exemple suivant pour savoir comment ajouter un tableau de noms avec plusieurs traductions.
requiresSubscription.sameAs URL Page décrivant l'abonnement.
requiresSubscription.identifier Texte Obligatoire si category est défini sur subscription ET commonTier est défini sur 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, par exemple : 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 de droits d'accès.
requiresSubscription.authenticator Entreprise Obligatoire si category est défini sur externalsubscription : conteneur qui fournit les détails du système d'authentification du fournisseur externe.
requiresSubscription.authenticator.@type Texte Obligatoire si category est défini sur externalsubscription : toujours défini sur Organization.
requiresSubscription.authenticator.name Texte Obligatoire si category est défini sur externalsubscription : nom du service d'authentification. Pour les fournisseurs TVE, définissez-le sur TVE.
requiresSubscription.commonTier Valeur booléenne Obligatoire, si applicable : obligatoire si la catégorie est définie sur "subscription" (abonnement). Pour en savoir plus sur commonTier, consultez la documentation sur les exigences du niveau commun.

Exigences concernant l'API Entitlements

Une API d'habilitation est requise si actionAccessibilityRequirement.category est défini sur subscription ou externalSubscription, et si votre offre d'abonnement inclut plusieurs forfaits ou niveaux, ou si elle est compatible avec les modules complémentaires. N'incluez pas cette information si votre abonnement est à un seul niveau et donne accès à tous les contenus de votre catalogue.

  • L'entreprise A propose un seul abonnement qui donne accès à tous les contenus disponibles. L'identifiant de droit d'accès / l'API ne sont pas requis.
  • 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 d'habilitation / l'API est requis.
  • L'entreprise C dispose d'un abonnement de base qui donne accès à certains contenus et à des packs complémentaires qui donnent accès à des contenus tiers : Identifiant d'habilitation / API requis

Consultez les pages suivantes pour en savoir plus sur les thèmes 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 indiquer la catégorie "free" (sans frais).
expectsAcceptanceOf.priceCurrency Texte Obligatoire : devise du prix au format ISO 4217 à trois lettres.
expectsAcceptanceOf.seller Entreprise Organisation qui propose l'achat de contenus.
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 en savoir plus sur les thèmes liés à ces propriétés :

Identifiants

Les flux d'actions multimédias acceptent différents identifiants qui peuvent aider à identifier une entité de manière non ambiguë. Ces identifiants peuvent accélérer le processus de rapprochement entre le contenu de votre flux et celui 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. Ces deux éléments sont décrits ci-dessous.

Propriétés de l'identifiant

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

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

Le tableau ci-dessous liste les identifiants et les sous-propriétés acceptés de la propriété identifier. Consultez Exemple d'identifiant/EIDR dans la section "Exemples de flux d'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).
  •  Cela ne s'applique pas aux entités Organization et BroadcastService pour lesquelles seul TMS_ID doit être utilisé.
  • TMS_ID : ID de variante Gracenote (TMS) (par exemple, MV000398520000).
  • WIKIDATA_ID : ID WikiData (par exemple, Q134773).
  • IMDB_ID : ID IMDB (par exemple, tt0109830).
  • OPTA_ID : ID OPTA Sports.
  • STATS_ID : ID STATS Perform.
  • VIP_TIMES_ID : ID Japan VIPTimes (Nihon Tarento Meikan) pour les talents japonais.
  • DMA_ID : code de la zone marketing désignée aux États-Unis, utilisé dans l'objet GeoShape.
  • _PARTNER_ID_ : cette propriété doit contenir la chaîne "_PARTNER_ID_". La valeur doit être un ID unique utilisé par un fournisseur de services, en interne ou en externe, pour identifier l'entité (par exemple, 12345 ou a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Texte Obligatoire : valeur pour le système d'ID spécifié.

Propriétés EIDR

EIDR (Entertainment Identifier Registry) est un système d'identifiant unique universel 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 répertorie les propriétés associées à l'EIDR et leur utilisation.

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

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

Par exemple, le titleEIDR du film "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J".

Consultez l'exemple d'identifiant/EIDR dans la section des exemples de flux d'actions Watch.
editEIDR Texte Fortement recommandé : un identifiant EIDR (Entertainment Identifier Registry) représente un montage ou une édition spécifique d'un film ou d'une série télévisée.

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

Par exemple, le film "Ghostbusters" dont le titre EIDR est "10.5240/7EC7-228A-510A-053E-CBB8-J" comporte plusieurs montages, par exemple "10.5240/1F2A-E1C5-680A-14C6-E76B-I" et "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

La propriété titleEIDR est obligatoire lorsque editEIDR est fourni.

Consultez l'exemple d'identifiant/EIDR dans la section des exemples de flux d'actions de visionnage.

Organismes 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 avant la valeur de la note. Exemples :

  • Un film classé "R" aux États-Unis doit avoir une valeur Movie.contentRating de "MPAA R".
  • Une série TV classée "TV-MA" aux États-Unis doit avoir une valeur TVSeries.contentRating de "TV_PG TV-MA".

Pays Organisme de classification TV Organisme de classification 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/RUSSIE
Aruba (AW) Non disponible Non disponible
Australie (AU) ACB TV ACB Movies
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 CNC
Bolivie (BO) Non disponible MPAA
Bosnie-Herzégovine (BA) Non disponible MPAA
Botswana (BW) Non disponible MPAA
Brésil (BR) CLASSIND CLASSIND
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 (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 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
Kirghizistan (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 (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/RUSSIE MKRF/RUSSIE
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/RUSSIE
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/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 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 : code pays à deux lettres ISO 3166-1 alpha-2.
postalCode Texte Facultatif : liste d'un ou de plusieurs codes postaux et/ou codes RTA (région de tri d'acheminement).
identifier PropertyValue Facultatif : ID de zone de marché désignée (DMA), qui est un identifiant d'une région des États-Unis où les utilisateurs reçoivent 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 DMA 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 de régions de tri d'acheminement (RTA) :

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

Exemple d'objet GeoShape contenant un ID de ZMA :

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