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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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.
    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.
    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.
    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"
          }
        ]
      }
    }
    

    Consultez les pages suivantes pour les sujets liés à ces propriétés: