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 :
|
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 :
|
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. |
Pages associées au balisage d'action
Consultez les pages suivantes pour en savoir plus sur les thèmes liés à ces propriétés :
- Présentation du balisage d'actions
- Identifier les liens profonds spécifiques à la plate-forme pour votre contenu
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
|
actionAccessibilityRequirement.availabilityStarts |
Date | Obligatoire : date après laquelle l'action est disponible, au format ISO 8601 (y compris le fuseau horaire).
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).
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.
|
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 :
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 :
|
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.
|
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
Pages liées aux abonnements aux contenus multimédias
Consultez les pages suivantes pour en savoir plus sur les thèmes liés à ces propriétés :
- Présentation des abonnements aux contenus multimédias
- Identifier les conditions d'accès à votre contenu
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). |
Page associée à l'offre
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 :
|
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 :
- Une liste de codes postaux (par exemple, des codes postaux américains, canadiens ou autres)
- Liste des zones de tri et d'acheminement canadiennes
- Un ID de zone de marché désignée (DMA) : identifiant d'une région des États-Unis où les utilisateurs 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 : 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"
}
]
}