Cette page a été traduite par l'API Cloud Translation.

Actions de visionnage propriétés communes

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

Propriétés du balisage d'action

Propriété	Type attendu	Description
`@type`	Texte	Obligatoire : doit toujours être défini sur `WatchAction`.
`target`	EntryPoint	Obligatoire : objet cible qui fournit la mise en correspondance des liens profonds avec diverses plates-formes Google.
`target.@type`	Texte	Obligatoire : doit toujours être 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 sur `urlTemplate`. Media Actions est compatible avec les éléments suivants : `http://schema.org/DesktopWebPlatform`: plate-forme de recherche dans les navigateurs Web pour ordinateur. `http://schema.org/MobileWebPlatform`: plate-forme de recherche dans les navigateurs Web mobiles. `http://schema.org/AndroidPlatform`: plates-formes Search et 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 dans 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 si applicable : liste de paires propriété-valeur pour représenter des propriétés supplémentaires du lien profond. Voici quelques exemples : `contentLanguage`: langue de diffusion (doublage), 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 ou des sous-titres codés au format BCP 47. Utilisez un tableau pour plusieurs codes de langue. `cameraAngle`: angle de vue de la caméra pour le contenu (par exemple, "Niveau des yeux" et "Angle élevé"). Si le contenu est disponible sous différents angles de vue, 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	Obligatoire : objet de spécification d'accès à l'action qui décrit les exigences d'accès au contenu. Consultez la section Propriétés de la spécification d'accès aux actions.

Pages associées au balisage d'action

Pour en savoir plus sur ces propriétés, consultez les pages suivantes:

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

Propriété	Type attendu	Description
`actionAccessibilityRequirement.@type`	Texte	Obligatoire : doit toujours être 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 contenus, vous devez définir `category` sur l'exigence d'accès la moins restrictive de son contenu. Par exemple, si un `TVSeries` contient du contenu `TVEpisode` défini sur `nologinrequired` et quelques éléments définis sur `subscription`, définissez ce `TVSeries` sur `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	Date	Obligatoire : date à partir de 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 disponibilité. Cela augmentera les chances que le contenu s'affiche à temps sur les surfaces Google.
`actionAccessibilityRequirement.availabilityEnds`	Date	Obligatoire : date à partir de laquelle l'action n'est plus disponible, au format ISO 8601 (y compris le fuseau horaire). Doit être égal ou supérieur à 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 de fin de disponibilité doit être effectuée dans le flux au moins sept jours avant cette date. Cela augmentera les chances que le contenu cesse d'apparaître sur les surfaces Google à la date de fin de disponibilité.
`actionAccessibilityRequirement.eligibleRegion`	Country (Pays), City (Ville), State (État), GeoShape (Forme géographique) ou Text (Texte)	Obligatoire : régions dans lesquelles 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 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 `eligibleRegion`.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	Obligatoire si applicable : informations sur l'abonnement dont les utilisateurs ont besoin pour accéder au contenu. Consultez la section Propriétés d'abonnement multimédia. Fournissez 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 sur les prix pour les cas suivants : Contenu à acheter une seule fois (`rental` ou `purchase`) Contenu 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 d'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 disposer d'un ID unique.
`requiresSubscription.name`	Texte	Obligatoire : nom de l'abonnement. Notez les points suivants : 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 appelé Package 1, mais que le système d'authentification utilise 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 que `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 identique à votre identifiant d'accès si vous fournissez une API d'accès.
`requiresSubscription.authenticator`	Entreprise	Obligatoire si `category` est `externalsubscription` : conteneur fournissant les informations sur 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 du service d'authentification. Pour les fournisseurs de TV Everywhere, définissez cette valeur 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 commonTier, consultez la documentation sur les exigences concernant le niveau commun.

Conditions applicables à l'API Entitlements

Une API d'autorisation est requise si actionAccessibilityRequirement.category est subscription ou externalSubscription, et si votre offre d'abonnement inclut plusieurs packages ou niveaux, ou est compatible avec les modules complémentaires. N'incluez pas cette information si votre abonnement est unique et donne accès à tous les contenus 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'identifiant d'accès / l'API n'est pas obligatoire
L'entreprise B dispose d'un abonnement de base qui permet d'accéder à certains contenus et d'un abonnement premium qui permet d'accéder à des contenus premium : l'identifiant d'accès / API est requis.
L'entreprise C dispose d'un abonnement de base qui permet d'accéder à certains contenus et de packages complémentaires qui permettent d'accéder à des contenus tiers : un identifiant d'accès / API est requis.

Pages associées aux abonnements multimédias

Pour en savoir plus sur ces propriétés, consultez les pages suivantes:

Propriétés de l'offre

Propriété	Type attendu	Description
`expectsAcceptanceOf.@type`	Texte	Obligatoire : doit toujours être 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 : 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, sa page d'accueil).

Page associée à l'offre

Pour en savoir plus sur ces propriétés, consultez les pages suivantes:

Identifiants

Les flux d'actions multimédias acceptent divers identifiants qui peuvent aider à identifier une entité de manière non ambiguë. Ces identifiants peuvent aider à 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 pour différents types d'entités, les EIDR ont leur propre propriété représentative. Ces deux méthodes sont décrites ci-dessous.

Propriétés de l'identifiant

Propriété	Type attendu	Description
`identifier`	Texte	Très recommandé : identifiant, généralement externe, qui identifie de manière unique 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 sous-propriétés acceptés de la propriété `identifier`. Consultez l'exemple d'identifiant/EIDR dans la section "Exemples de flux d'actions de visionnage".

Propriété	Type attendu	Description
`@type`	Texte	Obligatoire : doit toujours être défini sur `PropertyValue`.
`propertyID`	Texte	Obligatoire : nous acceptons les types d'identifiants 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 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 de la fonctionnalité STATS Perform. `VIP_TIMES_ID`: ID Japan VIPTimes (Nihon Tarento Meikan) pour les talents japonais. `DMA_ID`: code de 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 du système d'ID spécifié.

Propriétés EIDR

L'EIDR (Entertainment Identifier Registry) est un système d'identifiants uniques globaux pour un large éventail de contenus multimédias, y compris les films et les programmes télévisés. Le système d'identification résout un identifiant en enregistrement de métadonnées associé à des titres de niveau supérieur, 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	Très 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écification des entités TVSeries, TVSeason, TVEpisode et Movie. Par exemple, le titreEIDR du film "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J". Voir l'exemple d'identifiant/EIDR dans la section "Exemples de flux Watch Actions".
`editEIDR`	Texte	Très recommandé : un identifiant EIDR (Entertainment Identifier Registry) représente un montage spécifique d'une œuvre cinématographique ou télévisuelle. Cette propriété est disponible sur les pages de spécification des entités TVEpisode et Movie. Par exemple, le film "Ghostbusters", dont le titreEIDR 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. Voir l'exemple d'identifiant/EIDR dans la section "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. Le nom de l'organisme de classification doit être placé avant la valeur de la classification. Exemples :

Un film classé "R" aux États-Unis doit avoir une valeur Movie.contentRating de "MPAA R".
Une série télévisée 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 (CE)	Non disponible	MPAA
Égypte (EG)	Non disponible	MPAA
El 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/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
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:

Liste de codes postaux (par exemple, codes postaux américains, canadiens ou autres)
Liste des zones de tri avant canadiennes
ID de zone de marché désignée (DMA) : identifiant d'une région des États-Unis où les spectateurs reçoivent les mêmes chaînes et programmes de télévision.

Propriété	Type attendu	Description
`@id`	URL	Obligatoire : identifiant de la région géographique au format URI.
`@type`	Texte	Obligatoire : doit toujours être défini sur `GeoShape`.
`addressCountry`	Texte	Obligatoire : code pays ISO 3166-1 alpha-2 à deux lettres.
`postalCode`	Texte	Facultatif : liste d'un ou de plusieurs codes postaux et/ou de codes RTA (région de tri d'acheminement).
`identifier`	PropertyValue	Facultatif : ID de zone de marché désignée (DMA), qui identifie 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 : doit toujours être défini sur `PropertyValue`.
`identifier.propertyID`	Texte	Obligatoire : doit toujours être 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 RTA (région de tri d'acheminement) 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 DMA:

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