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

Cette section fournit des informations sur 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 les concepts sur les chaînes Live TV.

Tableau des spécifications de BroadcastService

Propriété Type attendu Description
@context Texte Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
  • "xx" représente la langue des chaînes du flux. La valeur @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 définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres/du doublage est l'anglais.
@type Texte Obligatoire : doit toujours être défini sur BroadcastService.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit respecter les conditions suivantes :
  • Unique dans l'ensemble de votre catalogue
  • Statique : l'ID doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel.
  • Au format URI (Uniform Resource Identifier)
  • 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. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire si applicable : URL canonique du service de diffusion si la chaîne est disponible sur Internet. Il est facultatif pour un service diffusé par câble/satellite/TNT. Google utilise cette URL pour faire correspondre le contenu de votre flux à celui des bases de données de Google.
url doit respecter les conditions suivantes:
  • url doit être unique
  • 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 pays 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 à celle du nom.
callSign Texte Signaux d'appel officiels émis par le gouvernement pour le service de diffusion.
inLanguage Text ou Language 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 Vous pouvez utiliser des signes plus ou des barres obliques pour indiquer de manière informelle une hiérarchie de catégories (par exemple, "Sports", "Sports > Football", "Actualités", "Film", "Musique", "Documentaire").
contentRating Text ou Rating Obligatoire pour un service de diffusion télévisée réservé aux adultes : classification la plus restrictive pour le contenu diffusé sur la chaîne. Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, l'organisme de classification doit être placé devant la classification, avec un espace entre les deux. Par exemple, une classification "TV-Y" de l'organisme "TVPG" aux États-Unis est décrite comme "TVPG TV-Y". Consultez la liste des agences.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'organisme de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la classification.
contentRating.advisoryCode Texte Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu 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 de différentes longueurs.
slogan Texte Slogan du service de diffusion.
areaServed Pays, État, Ville ou GeoShape Obligatoire si applicable : cette information est obligatoire si le changement de chaîne est effectué par le fournisseur de services TV. Il s'agit de la zone dans laquelle les utilisateurs peuvent s'attendre à recevoir le service de diffusion. Utilisez le code pays ISO 3166-1 pour spécifier les pays.
  • Utilisez un tableau pour représenter plusieurs zones.
  • N'associez pas Country (Pays), State (État) ou City (Ville) à GeoShape.
  • logo ImageObject Obligatoire si vous intégrez Google TV. Recommandé vivement dans le cas contraire Pourquoi ? Image représentant ce service de diffusion.
    • Les intégrations Google TV nécessitent un logo pouvant être utilisé sur un arrière-plan sombre. Son arrière-plan doit être transparent, avec un logo de couleur ou blanc, clairement visible sur un arrière-plan sombre.
    • L'image du logo doit respecter les formats 1:1, 4:3 ou 16:9 (dans l'ordre de préférence) et avoir une résolution 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 pour indiquer le type d'arrière-plan sur lequel le logo doit être utilisé.
    • Les marges de longueur ou de largeur (mais pas les deux) sont acceptables si elles sont ajoutées pour conserver le format.
    • Pour connaître les autres exigences et spécifications, consultez la section Image.
    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 la section Propriétés de balisage d'action.
    videoFormat Texte La définition de la plus haute qualité compatible avec ce service de diffusion (par exemple,
    • "SD" pour "définition standard"
    • "HD" pour "haute définition"
    • "2K" pour la résolution 2K.
    • "4K" pour la résolution 4K.
    • "8K" pour la 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 : chaîne de télévision qui fournit la programmation de ce service de diffusion ou organisation à laquelle appartient ce service de diffusion.
    broadcastAffiliateOf.@id Texte Obligatoire : définissez la valeur sur @id du réseau TV.
    broadcastAffiliateOf.@type Texte Obligatoire : doit toujours être 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. Pour en savoir plus, consultez la section Propriétés d'identifiant.
    popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des 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, pour 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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
    popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité spécifique à une zone géographique prévaut 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"
                        ]
                    }
                ]
            }
        ]
    }
    

    Tableau des spécifications de CableOrSatelliteService

    Propriété Type attendu Description
    @context Texte Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
    • "xx" représente la langue des chaînes du flux. La valeur @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 définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres/du doublage est l'anglais.
    @type Texte Obligatoire : doit toujours être défini sur CableOrSatelliteService.
    @id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
    @id doit respecter les conditions suivantes :
    • Unique dans l'ensemble de votre catalogue
    • Statique
    • Au format URI (Uniform Resource Identifier)
    É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. Pour en savoir plus, consultez la section Identifiant.
    name Texte Obligatoire : nom du service TV.
    • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues.
    • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
    areaServed Pays, État, Ville ou GeoShape 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 : doit toujours être défini sur Organization.
    identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie cette entité, comme un ID TMS Gracenote pour ce service de diffusion. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés d'identifiant.

    Exemples de CableOrSatelliteService

    Exemple de service de télévision 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 de programmes vidéo multicanaux virtuel (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",
        }
      ]
    }
    

    Tableau des spécifications de TelevisionChannel

    Propriété Type attendu Description
    @context Texte Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
    • "xx" représente la langue des chaînes du flux. La valeur @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 définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres/du doublage est l'anglais.
    @type Texte Obligatoire : doit toujours être défini sur TelevisionChannel.
    @id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
    @id doit respecter les conditions suivantes :
    • Unique dans l'ensemble de votre catalogue
    • Statique
    • Au format URI (Uniform Resource Identifier)
    É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. Pour en savoir plus, consultez la section Identifiant.
    broadcastChannelId Texte Obligatoire : identifiant unique permettant d'identifier ce BroadcastService comme un service de télévision par câble, par satellite ou sur Internet.
    • Aux États-Unis, il s'agit généralement d'un numéro de télévision par câble ou satellite.
    • Pour un service de télévision sur Internet (par exemple, un vMVPD), indiquez le nom de la chaîne.
    channelOrder Number Obligatoire pour Google TV, facultatif dans le cas contraire : utilisez cette propriété pour indiquer l'ordre dans lequel les chaînes doivent s'afficher dans le guide électronique des programmes pour les intégrations Google TV.

    L'channelOrder doit être unique pour tous les canaux du flux et doit idéalement commencer à 1. channelOrder ne peut pas avoir une valeur négative ou 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 un abonnement de base.
    • Premium pour les chaînes nécessitant un paiement en plus de l'abonnement de base.
    Utilisez un tableau pour fournir plusieurs valeurs.
    inBroadcastLineup CableOrSatelliteService Obligatoire : @id de l'CableOrSatelliteService qui fournit cette chaîne aux spectateurs.
    providesBroadcastService BroadcastService Obligatoire : @id de l'BroadcastService dont la programmation est fournie par ce canal.

    Exemples de 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"
      }
    }
    

    Tableau des spécifications de l'organisation

    Propriété Type attendu Description
    @context Texte Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
    • "xx" représente la langue des chaînes du flux. La valeur @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 définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres/du doublage est l'anglais.
    @type Texte Obligatoire : doit toujours être défini sur Organization.
    @id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
    @id doit respecter les conditions suivantes :
    • Unique dans l'ensemble de votre catalogue
    • Statique
    • Au format URI (Uniform Resource Identifier)
    É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. Pour en savoir plus, consultez la section Identifiant.
    name Texte Obligatoire : nom du réseau, du fournisseur de contenus ou de l'opérateur de télévision.
    • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays 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 de différentes longueurs.
    sameAs URL Fortement recommandé Pourquoi ? URL d'une page Wikipédia permettant d'identifier la chaîne de télévision Elle doit être distincte de la propriété "url". Ne renseignez cette colonne que si la page Wikipédia concerne une entité de chaîne/chaîne unique. Notez que les pages Wikipédia peuvent utiliser le terme "chaîne".
    potentialAction WatchAction Obligatoire si applicable : cette valeur est obligatoire si vous possédez plusieurs chaînes (BroadcastService) faisant référence à l'organisation. Objet de balisage d'action qui fournit les détails de l'action. Pour en savoir plus, consultez la section Propriétés de balisage d'action.
    url URL URL de l'organisation. Google utilise cette URL pour faire le rapprochement entre cette organisation et celle figurant dans ses bases de données.
    identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie cette entité, comme un ID TMS pour cette organisation. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés d'identifiant.
    popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des 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, pour 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 qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
    popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité spécifique à une zone géographique prévaut 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"
          }
        ]
      }
    }
    

    Pour en savoir plus sur ces propriétés, consultez les pages suivantes: