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 de 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 de télévision en direct.

Tableau de spécifications BroadcastService

Propriété Type attendu Description
@context Texte Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Où "xx" représente la langue des chaînes du flux. La balise @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 est l'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 remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • Statique ; L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée 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 l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire, le cas échéant – L'URL canonique du service de diffusion si la chaîne est disponible sur Internet. Il est facultatif pour un service fourni par câble/satellite/Over The Air. Google utilise cette URL pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit répondre aux 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 répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
broadcastDisplayName Texte Obligatoire : nom à afficher pour le réseau que les utilisateurs voient généralement dans les guides des programmes, etc. Cette valeur peut être identique à celle du nom.
callSign Texte Indicatif officiel du service de diffusion.
inLanguage Texte ou Langue Fortement recommandé Pourquoi ? Langue principale de diffusion 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 signes plus grands ou des barres obliques peuvent être utilisés pour indiquer de manière informelle une hiérarchie de catégories. ex.Sports, Sports > Football, Actualités, Cinéma, Musique, Documentaire.
contentRating Text ou Rating Obligatoire pour un service de diffusion de télévision réservée 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'agence de classification doit être ajoutée au début de la classification par un espace blanc. (par exemple, "TV-Y") note de l'agence "TVPG" aux États-Unis est dénommée "TVPG TV-Y". Consultez la liste des agences.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'agence de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent 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 caractères maximum. Utilisez un tableau pour fournir des descriptions dans plusieurs langues et/ou différentes longueurs.
slogan Texte Slogan du service de diffusion.
areaServed Pays, État, Ville ou GeoShape Obligatoire, le cas échéant : obligatoire si le changement de chaîne est effectué par le fournisseur de services de télévision : zone dans laquelle les utilisateurs peuvent s'attendre à bénéficier du service de diffusion. Utilisez le code pays ISO 3166-1 pour spécifier les pays.
  • Utilisez un tableau pour représenter plusieurs zones.
  • Ne mélangez pas Pays, État, Ville avec GeoShape.
  • logo ImageObject Obligatoire pour l'intégration à Google TV. Fortement recommandé, sinon Pourquoi ? Une image qui représente ce service de diffusion.
    • Les intégrations avec Google TV nécessitent un seul logo pouvant être utilisé sur un fond sombre. Son arrière-plan doit être transparent, avec un logo blanc ou coloré, et 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 pixels.
    • Utilisez la valeur forDarkBackground pour le nom de 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é.
    • Vous pouvez ajouter une marge intérieure en longueur ou en largeur (mais pas les deux) si vous l'ajoutez pour maintenir le format.
    • Consultez la section Images pour connaître les autres exigences et caractéristiques requises.
    Consultez l'exemple ci-dessous.
    potentialAction WatchAction Obligatoire, le cas échéant : 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 des actions.
    videoFormat Texte Définition de la plus haute qualité acceptée par ce service de diffusion. par exemple,
    • SD pour la définition standard.
    • "HD" pour la haute définition.
    • "2 K" 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 : réseau de télévision qui fournit les programmes du service de diffusion ou de l'organisation à laquelle ce service appartient.
    broadcastAffiliateOf.@id Texte Obligatoire : définissez la valeur 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é, tel que _PARTNER_ID_. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
    popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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é. un score élevé signifie une popularité plus élevée.
    popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).

    Exemple de service 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"}]
    • Où "xx" représente la langue des chaînes du flux. La balise @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 est l'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 remplir les conditions suivantes:
    • Unique au niveau mondial 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 l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
    name Texte Obligatoire : nom du service de télévision.
    • Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
    • Notez qu'un seul nom est accepté par langue (combinaison 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 : toujours 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 de l'identifiant.

    Exemples 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 de programmation vidéo multicanal 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 TelevisionChannel

    Propriété Type attendu Description
    @context Texte Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}]
    • Où "xx" représente la langue des chaînes du flux. La balise @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 est l'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 remplir les conditions suivantes:
    • Unique au niveau mondial 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 l'attribut url d'une entité en tant que @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, satellite ou Internet.
    • Aux États-Unis, il s'agit généralement d'un nombre 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 de la chaîne.
    channelOrder Number Obligatoire pour Google TV, facultatif dans les autres cas : utilisez cette propriété pour indiquer l'ordre dans lequel les chaînes doivent être affichées dans le guide électronique des programmes pour les intégrations Google TV.

    L'attribut channelOrder doit être unique pour l'ensemble des canaux du flux et, idéalement, commencer à partir de 1. channelOrder ne peut pas avoir de valeur négative ni nulle.
    broadcastServiceTier Texte Utilisez les valeurs suivantes:
    • Free pour la chaîne qui ne nécessite aucun 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 la CableOrSatelliteService qui fournit cette chaîne aux spectateurs.
    providesBroadcastService BroadcastService Obligatoire : @id du BroadcastService dont la programmation fournit 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"}]
    • Où "xx" représente la langue des chaînes du flux. La balise @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 est l'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 remplir les conditions suivantes:
    • Unique au niveau mondial 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 l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
    name Texte Obligatoire : nom du réseau de télévision, du fournisseur de contenu TV ou de l'opérateur TV.
    • Utilisez un tableau pour répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
    • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
    description Texte Description de l'organisation. 300 caractères maximum. Utilisez un tableau pour fournir des descriptions dans plusieurs langues et/ou différentes longueurs.
    sameAs URL Fortement recommandé Pourquoi ? URL d'une page Wikipédia pouvant identifier le réseau de télévision. Il doit être distinct de la propriété d'URL. Ne renseigner que les pages Wikipédia qui traitent d'une entité chaîne/réseau unique. Notez que les pages Wikipédia peuvent utiliser la terminologie "channel".
    potentialAction WatchAction Obligatoire, le cas échéant : obligatoire si vous disposez de plusieurs chaînes (BroadcastService) faisant 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 des actions.
    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 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 de l'identifiant.
    popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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é. un score élevé signifie une popularité plus élevée.
    popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
    Note: La popularité spécifique aux paramètres régionaux a priorité 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 en savoir plus sur les sujets liés à ces propriétés: