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 :
|
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 :
|
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. |
Pages liées au balisage d'actions
Consultez les pages suivantes pour les sujets liés à ces propriétés:
- Présentation du balisage d'action
- Identifier les liens profonds spécifiques à une plate-forme pour votre contenu
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
|
actionAccessibilityRequirement.availabilityStarts |
Date | Obligatoire : date de fin de l'action, 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 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).
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.
|
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 :
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 :
|
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.
|
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.
Pages liées aux abonnements à des services multimédias
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). |
Page liée à l'offre
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 :
|
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:
- Une liste de codes postaux (par exemple, les États-Unis, le Canada ou d'autres codes postaux)
- Une liste des zones de tri avant canadienne
- Identifiant de zone de marché désignée : identifiant d'une région des États-Unis où les utilisateurs reçoivent les mêmes chaînes et les mêmes programmes.
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"
}
]
}