Cette section détaille les propriétés de balisage de contenu pour les types d'entités BroadcastService
, CableOrSatelliteService
, TelevisionChannel
et Organization
. Pour mieux comprendre la relation entre ces types, consultez la page sur les concepts de LiveTV.
Table des spécifications BroadcastService
Propriété | Type attendu | Description |
---|---|---|
@context |
Texte | Obligatoire - Toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : toujours défini sur BroadcastService . |
@id |
URL | Obligatoire : identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.@id doit répondre aux exigences suivantes :
url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id . Consultez la section Identifiant pour en savoir plus. |
url |
URL | Obligatoire si applicable : URL canonique du service de diffusion si la chaîne est disponible pour le visionnage sur Internet. Cette option est facultative pour un service fourni sur un câble, un satellite ou une liaison aérienne. Google utilise cette URL pour faire correspondre le contenu de votre flux au contenu de ses bases de données.url doit répondre aux exigences suivantes:
urlTemplate de l'objet cible. |
name |
Texte | Obligatoire : nom du réseau.
|
broadcastDisplayName |
Texte | Obligatoire : nom à afficher du réseau que les utilisateurs peuvent généralement voir dans les guides de programmes, etc. La valeur peut être identique à la valeur du nom. |
callSign |
Texte | Indicatif officiel officiel du service de diffusion. |
inLanguage |
Texte ou Langue | Fortement recommandé Pourquoi ? Langue de diffusion principale de la chaîne. Veuillez utiliser l'un des codes de langue de la norme IETF BCP 47. |
category |
Texte | Fortement recommandé Pourquoi ? Catégorie de l'article. Des barres ou des panneaux plus grands peuvent indiquer une hiérarchie de catégories informelle (par exemple, Sports, Sports > Football, News, Movie, Music ou Documentaire). |
contentRating |
Texte ou Note | Obligatoire pour les services de diffusion TV réservés aux adultes : classification la plus restrictive du contenu diffusé sur la chaîne. Si la classification du contenu est présentée sous la forme d'une chaîne de texte, l'agence de classification doit être précédée de la classification avec un espace entre les deux. Par exemple, la classification "TV-Y" de l'agence "TVPG" aux États-Unis est décrite comme "TV-Y TV-Y". Consultez la liste des agences. |
contentRating.author |
Texte ou Organisation | Obligatoire si contentRating utilise Rating : nom de l'agence d'évaluation. |
contentRating.ratingValue |
Texte | Obligatoire si contentRating utilise Rating : valeur de la note. |
contentRating.advisoryCode |
Texte | Code consultatif du contenu. Valeurs acceptées : D, F, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence. |
description |
Texte | Description du service de diffusion. (300 caractères maximum). Utilisez un tableau pour fournir les descriptions dans plusieurs langues et/ou dans différentes longueurs. |
slogan |
Texte | Un slogan du service de diffusion. |
areaServed |
Pays, État, Ville ou Zone géographique | Obligatoire, le cas échéant : ce paramètre est obligatoire si le transfert de la chaîne est effectué par le fournisseur de services de télévision. Il s'agit de la zone dans laquelle les utilisateurs peuvent s'attendre à recevoir le service de diffusion. Utilisez le code pays au format ISO 3166-1 pour spécifier les pays. |
logo |
ImageObject | Obligatoire si l'intégration à Google TV Fortement recommandé Autre raison Une image représentant ce service de diffusion.
|
potentialAction |
WatchAction | Obligatoire si applicable : objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés du balisage d'action.
|
videoFormat |
Texte | La meilleure définition possible pour ce service de diffusion. Par exemple :
|
broadcastTimezone |
Texte | Fuseau horaire de ce service de diffusion, au format IANA (par exemple, America/Los_Angeles). Utilisez un tableau pour plusieurs fuseaux horaires. |
broadcastAffiliateOf |
Entreprise | Obligatoire – Le réseau de télévision qui fournit la programmation de ce service de diffusion ou de l'organisation à laquelle ce service de diffusion appartient. |
broadcastAffiliateOf.@id |
Texte | Obligatoire : défini sur @id du réseau TV. |
broadcastAffiliateOf.@type |
Texte | Obligatoire : toujours défini sur Organization . |
identifier |
PropertyValue | Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie cette entité, par exemple _PARTNER_ID_. Plusieurs identifiants sont autorisés. Consultez la section Propriétés de l'identifiant pour en savoir plus. |
popularityScore |
PopularitéScoreScore | Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, parmi toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0. |
popularityScore.@type |
Texte | Toujours défini sur PopularityScoreSpecification . |
popularityScore.value |
Number | Valeur numérique non négative indiquant la popularité de l'entité. Plus elle est élevée, plus la popularité est élevée. |
popularityScore.eligibleRegion |
Pays | Région(s) dans laquelle le taux de popularité s'applique. Si le score de popularité est applicable dans le monde entier, définissez la valeur sur EARTH . Par défaut, cette propriété est définie sur EARTH . Note: La popularité selon les paramètres régionaux est prioritaire sur la popularité globale (EARTH) |
Exemple de BroadcastService
{
"@context": [
"http://schema.org",
{
"@language": "en"
}
],
"@type": "BroadcastService",
"@id": "http://example.com/stations/example-tv",
"name": "EXAMPLE-TV",
"broadcastDisplayName": "ABCD",
"url": "http://example.com/stations/example-tv",
"callSign": "EXA-TV",
"videoFormat": "SD",
"inLanguage": "en",
"broadcastTimezone": "America/Los_Angeles",
"broadcastAffiliateOf": {
"@type": "Organization",
"@id": "http://example.com/networks/abcd-network"
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12258"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-123456"
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/livestream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
"authenticator": {
"@type": "Organization",
"name": "TVE"
}
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"logo": [
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Light",
"contentUrl": "http://example.com/images/example-logo-light.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forLightBackground"
]
}
]
},
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Dark",
"contentUrl": "http://example.com/images/example-logo-dark.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground"
]
}
]
}
]
}
Table des spécifications CableOrSatelliteService
Propriété | Type attendu | Description |
---|---|---|
@context |
Texte | Obligatoire - Toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : toujours défini sur CableOrSatelliteService . |
@id |
URL | Obligatoire : identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.@id doit répondre aux exigences suivantes :
url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id . Consultez la section Identifiant pour en savoir plus. |
name |
Texte | Obligatoire : nom du service de télévision.
|
areaServed |
Pays, État, Ville ou Zone géographique | Obligatoire : zone dans laquelle les utilisateurs peuvent s'attendre à recevoir le service de diffusion.
|
provider |
Entreprise | Obligatoire : fournisseur parent du service, le cas échéant. Par exemple, ExampleTV est le fournisseur de ses services régionaux ExampleTV San Francisco et ExampleTV San Diego. |
provider.@id |
Texte | Obligatoire – ID de l'opérateur TV. |
provider.@type |
Texte | Obligatoire : toujours défini sur Organization . |
identifier |
PropertyValue | Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant cette entité, par exemple l'ID Gracenote TMS pour ce service de diffusion. Plusieurs identifiants sont autorisés. Consultez la section Propriétés de l'identifiant pour en savoir plus. |
Exemples de CableOrSatelliteService
Exemple de service par câble ou satellite:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/provider-lineups/exampletv-san-francisco",
"name":"ExampleTV San Francisco",
"provider": {
"@type": "Organization",
"@id": "http://example.com/providers/exampletv"
},
"areaServed":[
{
"@type":"GeoShape",
"@id": "http://example.com/area1"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
}
}
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
Exemple de distributeur virtuel de programmation vidéo (VMVPD):
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv",
"name":"My Online Example TV",
"provider": {
"@type": "Organization",
"@id": "http://my-online-tv.com"
},
"areaServed":[
{
"@type":"Country",
"name": "US",
},
{
"@type":"Country",
"name": "CA",
}
]
}
Table des spécifications TelevisionChannel
Propriété | Type attendu | Description |
---|---|---|
@context |
Texte | Obligatoire - Toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : toujours défini sur TelevisionChannel . |
@id |
URL | Obligatoire : identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.@id doit répondre aux exigences suivantes :
url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id . Consultez la section Identifiant pour en savoir plus. |
broadcastChannelId |
Texte | Obligatoire – Identifiant unique qui permet d'identifier l'appareil BroadcastService comme un service TV par câble, satellite ou Internet.
|
channelOrder |
Number | Obligatoire pour Google TV, facultatif : utilisez cette propriété pour indiquer l'ordre dans lequel les canaux doivent s'afficher dans le guide de programmation électronique pour les intégrations Google TV. La valeur de channelOrder doit être unique parmi les canaux du flux et doit idéalement commencer par 1. La valeur de channelOrder ne peut pas être négative ni nulle. |
broadcastServiceTier |
Texte | Utilisez les valeurs suivantes :
|
inBroadcastLineup |
CableOrSatelliteService | Obligatoire – @id de la CableOrSatelliteService qui fournit cette chaîne aux spectateurs. |
providesBroadcastService |
BroadcastService | Obligatoire – @id du BroadcastService dont la programmation est fournie par cette chaîne. |
Exemples pour TelevisionChannel
Exemple de chaîne de télévision par câble ou satellite:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/exampleTV/example-tv-7",
"broadcastChannelId":"7",
"channelOrder": 1,
"broadcastServiceTier":["Premium", "Standard"],
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/exampleTV-san-francisco"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/example-tv"
}
}
Exemple pour une chaîne de télévision en ligne:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/my-online-example-tv/sport-channel",
"broadcastChannelId":"sport-channel",
"channelOrder": 3,
"broadcastServiceTier":"Premium",
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/sport-channel"
}
}
Table des spécifications de l'organisation
Propriété | Type attendu | Description |
---|---|---|
@context |
Texte | Obligatoire - Toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@type |
Texte | Obligatoire : toujours défini sur Organization . |
@id |
URL | Obligatoire : identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.@id doit répondre aux exigences suivantes :
url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id . Consultez la section Identifiant pour en savoir plus. |
name |
Texte | Obligatoire : nom du réseau TV, du fournisseur de contenu TV ou de l'opérateur TV.
|
description |
Texte | Description de l'organisation. (300 caractères maximum). Utilisez un tableau pour fournir les descriptions dans plusieurs langues et/ou dans différentes longueurs. |
sameAs |
URL | Fortement recommandé Pourquoi ? URL vers une page Wikipédia permettant d'identifier la chaîne de télévision. Il doit être différent de la propriété url. Renseignez uniquement la page Wikipédia qui parle d'une seule entité/chaîne. Notez que les termes Wikipédia peuvent utiliser le terme "channel". |
potentialAction |
WatchAction | Obligatoire si applicable : obligatoire si plusieurs chaînes (BroadcastService) font référence à l'organisation. Un objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez les propriétés du balisage d'action.
|
url |
URL | URL de l'organisation. Google utilise cette URL pour rapprocher précisément cette entreprise de celle des bases de données de Google. |
identifier |
PropertyValue | Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie cette entité, par exemple un ID TMS pour cette organisation. Plusieurs identifiants sont autorisés. Consultez la section Propriétés de l'identifiant pour en savoir plus. |
popularityScore |
PopularitéScoreScore | Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, parmi toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0. |
popularityScore.@type |
Texte | Toujours défini sur PopularityScoreSpecification . |
popularityScore.value |
Number | Valeur numérique non négative indiquant la popularité de l'entité. Plus elle est élevée, plus la popularité est élevée. |
popularityScore.eligibleRegion |
Pays | Région(s) dans laquelle le taux de popularité s'applique. Si le score de popularité est applicable dans le monde entier, définissez la valeur sur EARTH . Par défaut, cette propriété est définie sur EARTH . Note: La popularité selon les paramètres régionaux est prioritaire sur la popularité globale (EARTH) |
Exemple d'organisation
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network",
"name":"ABCD",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-12345"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/networkstream",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast",
"http://schema.org/AndroidTVPlatform"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "externalsubscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2050-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
À lire également
Consultez les pages suivantes pour les sujets liés à ces propriétés: