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

Propriétés de balisage de contenu des chaînes de télévision en direct

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"}]` "xx" représente la langue des chaînes du flux. La propriété @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est l'espagnol, le système considère que les noms sont en espagnol, même si le sous-titre est en anglais.
`@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 : Unique dans votre catalogue Statique ; l'identifiant doit être stable et immuable dans le temps (même si la propriété url de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel. Sous la forme d'un identifiant de ressource unifié (URI) Le domaine utilisé pour la valeur @id doit appartenir à votre organisation. Étant donné que le `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: `url` doit être unique au niveau mondial `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour le lien profond de la lecture, consultez plutôt la propriété `urlTemplate` de l'objet cible.
`name`	Texte	Obligatoire : nom du réseau. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`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. Utilisez un tableau pour représenter plusieurs zones. Ne mélangez pas Country, State, City avec GeoShape.
`logo`	ImageObject	Obligatoire si l'intégration à Google TV Fortement recommandé Autre raison Une image représentant ce service de diffusion. Les intégrations Google TV nécessitent un logo utilisable sur un fond sombre. L'arrière-plan doit être transparent, avec un logo coloré ou blanc bien visible sur un fond sombre. L'image du logo doit respecter les proportions 1:1, 4:3 ou 16:9 (dans cet ordre de préférence) et sa résolution doit être d'au moins 80 x 80 pixels. Utilisez la valeur `forDarkBackground` pour le nom de la propriété personnalisée `contentAttributes` dans la propriété `additionalProperty` afin d'indiquer le type d'arrière-plan sur lequel le logo doit être utilisé. Le remplissage d'une longueur ou d'une largeur (mais pas les deux) est accepté s'il est ajouté pour conserver les proportions. Consultez la section Image pour connaître les autres exigences et spécifications. Voir l'exemple ci-dessous
`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. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues. Il est facultatif de fournir des liens profonds si le transfert de la chaîne est effectué par le fournisseur de services de télévision.
`videoFormat`	Texte	La meilleure définition possible pour ce service de diffusion. Par exemple : "SD" pour une définition standard. "HD" pour la haute définition. "2K" pour une résolution 2K. "4K" pour une résolution 4K "8K" pour une résolution 8K.
`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"}]` "xx" représente la langue des chaînes du flux. La propriété @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est l'espagnol, le système considère que les noms sont en espagnol, même si le sous-titre est en anglais.
`@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 : Unique dans votre catalogue Statique Sous la forme d'un identifiant de ressource unifié (URI) Étant donné que le `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. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`areaServed`	Pays, État, Ville ou Zone géographique	Obligatoire : 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. Utilisez un tableau pour représenter plusieurs zones. Ne mélangez pas Country, State, City avec GeoShape. Consultez la section Propriétés GeoShape pour en savoir plus.
`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"}]` "xx" représente la langue des chaînes du flux. La propriété @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est l'espagnol, le système considère que les noms sont en espagnol, même si le sous-titre est en anglais.
`@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 : Unique dans votre catalogue Statique Sous la forme d'un identifiant de ressource unifié (URI) Étant donné que le `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. Aux États-Unis, il s'agit généralement d'un numéro pour la télévision par câble ou satellite. Pour un service de télévision sur Internet (par exemple, vMVPD), indiquez le nom du canal.
`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 : `Free` pour la chaîne qui ne nécessite pas d'abonnement. `Standard` pour les chaînes incluses dans l'abonnement de base. `Premium` pour les chaînes qui nécessitent un paiement en plus de l'abonnement de base. Utilisez un tableau pour fournir plusieurs valeurs.
`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"}]` "xx" représente la langue des chaînes du flux. La propriété @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est l'espagnol, le système considère que les noms sont en espagnol, même si le sous-titre est en anglais.
`@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 : Unique dans votre catalogue Statique Sous la forme d'un identifiant de ressource unifié (URI) Étant donné que le `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. Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`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. Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues. Il est facultatif de fournir des liens profonds si le transfert de la chaîne est effectué par le fournisseur de services de télévision.
`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"
      }
    ]
  }
}