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

Cette section fournit des informations détaillées sur les propriétés de balisage du contenu pour les types d'entités BroadcastService, CableOrSatelliteService, TelevisionChannel et Organization. Pour mieux comprendre la relation entre ces types, consultez les concepts des chaînes LiveTV.

Table de la spécification 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 dans le flux. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
@type Texte Obligatoire : cette valeur est toujours définie sur BroadcastService.
@id URL Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
@id doit répondre aux exigences suivantes :
  • Unique au niveau global dans votre catalogue
  • Statique ; l'identifiant doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un 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. Consultez la section Identifiant pour en savoir plus.
url URL Obligatoire, le cas échéant : URL canonique du service de diffusion si la chaîne est disponible sur Internet. Ce service est facultatif pour les services fournis par câble, satellite ou Over The Air. Google utilise cette URL pour faire correspondre le contenu de votre flux au contenu de ses bases de données.
url doit respecter les exigences 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 régions et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue/pays).
broadcastDisplayName Texte Obligatoire : nom à afficher pour le réseau que les utilisateurs peuvent généralement consulter dans les guides de programme, etc. La valeur peut être identique à celle du nom.
callSign Texte Indicatif officiel officiel du service de diffusion.
inLanguage Texte ou Langue Fortement 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 pourquoi Catégorie de l'article Des barres obliques ou des panneaux de plus grande taille permettent d'indiquer de manière informelle une hiérarchie de catégories (Sports, Sports > Football, Actualités, Films, Musique, Documentaire, etc.)
contentRating Texte ou Note Obligatoire pour les services de diffusion télévisée réservés aux adultes : classification la plus restrictive pour les contenus diffusés 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 précédé de la classification avec un espace blanc. Par exemple, la classification "TV-Y" pour l'agence "TVPG" aux États-Unis est décrite comme "TV-TV-Y". Consultez la liste des agences.
contentRating.author Texte ou Organisation Obligatoire si contentRating utilise Rating : nom de l'organisme 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, FV, 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 Utilisez un tableau pour fournir des descriptions dans plusieurs langues et/ou dans différentes longueurs.
slogan Texte Un slogan du service de diffusion.
areaServed Pays, État, Ville ou GeoShape Obligatoire, le cas échéant : ce champ est obligatoire si le transfert de la chaîne est traité 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 des pays.
  • Utilisez un tableau pour représenter plusieurs zones.
  • Ne mélangez pas Pays, État, Ville avec GeoShape.
  • logo ImageObject Obligatoire si avec Google TV. Fortement recommandé Sinon 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. L'arrière-plan doit être transparent, avec un logo coloré ou blanc, clairement visible sur un fond sombre.
    • L'image du logo doit respecter le format 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 px.
    • Utilisez la valeur forDarkBackground du nom de 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é.
    • Une marge intérieure de longueur ou de largeur (mais pas les deux) est acceptable si vous conservez les proportions.
    • Consultez la section Image pour connaître les autres exigences et spécifications.
    Voir l'exemple ci-dessous
    potentialAction WatchAction Obligatoire, le cas échéant : 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 Définition de qualité la plus élevée acceptée pour ce service de diffusion (
    • "SD" pour une définition standard
    • "HD" pour une vidéo 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 : réseau de télévision qui programme le service de diffusion.
    broadcastAffiliateOf.@id Texte Obligatoire : spécifiez @id du réseau TV.
    broadcastAffiliateOf.@type Texte Obligatoire : cette valeur est toujours définie sur Organization.
    identifier PropertyValue Fortement pourquoi - ID externe ou autre qui identifie cette entité, comme _PARTNER_ID_. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
    popularityScore PopularitéScoreScore Fortement 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 entre les flux de 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 le score est élevé, plus la popularité est élevée.
    popularityScore.eligibleRegion Country Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (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 de spécification 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 dans le flux. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
    @type Texte Obligatoire : cette valeur est toujours définie sur CableOrSatelliteService.
    @id URL Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
    @id doit répondre aux exigences suivantes :
    • Unique au niveau global dans votre catalogue
    • Statique
    • Sous la forme d'un 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. 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 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 : cette valeur est toujours définie sur Organization.
    identifier PropertyValue Fortement pourquoi - ID externe ou autre qui identifie cette entité, comme l'ID Gracenote TMS pour ce service de diffusion. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.

    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 de spécification 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 dans le flux. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
    @type Texte Obligatoire : cette valeur est toujours définie sur TelevisionChannel.
    @id URL Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
    @id doit répondre aux exigences suivantes :
    • Unique au niveau global dans votre catalogue
    • Statique
    • Sous la forme d'un 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. Consultez la section Identifiant pour en savoir plus.
    broadcastChannelId Texte Obligatoire : identifiant unique permettant d'identifier ce BroadcastService en tant que câble, satellite ou service de télévision par Internet.
    • Aux États-Unis, il s'agit généralement du numéro de la télévision par câble ou satellite.
    • Pour un service de télévision par Internet (vMVPD, par exemple), indiquez le nom de la chaîne.
    channelOrder Number Obligatoire pour Google TV (facultatif) : utilisez cette propriété pour indiquer l'ordre dans lequel les chaînes doivent être affichées dans le guide de programmation électronique pour les intégrations Google TV.

    Le champ channelOrder doit être unique sur l'ensemble des canaux du flux et, idéalement, commencer par 1. La valeur de channelOrder ne peut pas être 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 standard.
    • 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 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 de spécification 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 dans le flux. Le contexte @language de chaque contexte racine doit être défini sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être en espagnol, même si la langue du sous-titre est en anglais.
    @type Texte Obligatoire : cette valeur est toujours définie sur Organization.
    @id URL Obligatoire : l'identifiant du contenu au format URI. Par exemple, https://example.com/1234abc.
    @id doit répondre aux exigences suivantes :
    • Unique au niveau global dans votre catalogue
    • Statique
    • Sous la forme d'un 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. Consultez la section Identifiant pour en savoir plus.
    name Texte Obligatoire : nom du réseau de télévision, fournisseur de contenu TV ou 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 Utilisez un tableau pour fournir des descriptions dans plusieurs langues et/ou dans différentes longueurs.
    sameAs URL Fortement pourquoi URL d'une page Wikipédia permettant d'identifier la chaîne de télévision. Il doit être différent de la propriété d'URL. Renseignez uniquement la page Wikipédia qui concerne une seule chaîne ou entité de réseau. Notez que les pages Wikipédia peuvent utiliser le terme "canal".
    potentialAction WatchAction Obligatoire, le cas échéant : 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 organisation de celle de ses bases de données.
    identifier PropertyValue Fortement 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 des identifiants.
    popularityScore PopularitéScoreScore Fortement 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 entre les flux de 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 le score est élevé, plus la popularité est élevée.
    popularityScore.eligibleRegion Country Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (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: