Propriétés de balisage de contenu de MediaService (obligatoire)

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

Cette section fournit des détails sur les propriétés de balisage du contenu pour le type d'entité MediaService qui capture la configuration de votre intégration d'action média.

Table des spécifications

Propriété Type attendu Description
@type Texte

Obligatoire : toujours défini sur MediaService.

@context Texte

Obligatoire : toujours défini sur ["http://schema.org", {"@language": "xx"}].

@id URL

Obligatoire : identifiant unique pour votre marque, par exemple https://example.com.

L'identifiant doit répondre aux exigences suivantes:

  • Il est unique au niveau mondial dans votre catalogue.
  • C'est statique. Cet identifiant doit être stable et immuable dans le temps.
  • Il est au format URI (Uniform Resource Identifier).
  • Son domaine doit appartenir à votre organisation.
name Texte

Obligatoire : nom du fournisseur.

Si votre marque possède des noms propres à certains paramètres régionaux, répertoriez-les dans un tableau. Pour obtenir un exemple, consultez l'exemple MediaService.

brandIcon ImageObject

Obligatoire pour toutes les actions de visionnage et actions d'écoute : fichier image de votre icône de marque, répété, pour chaque taille. Dans le résultat de la section "Regarder/Écouter", Google associe les liens profonds de votre contenu à l'icône de votre marque.

Le fichier image de votre icône de marque doit respecter les exigences suivantes:

  • Il s'agit d'un fichier PNG.
  • Son arrière-plan est transparent.
  • Sa forme est ronde.
  • Assurez-vous que les images sont correctement ancrées et qu'elles ne sont pas déformées/pixelisées.

Cette propriété doit être répétée, car vous devez fournir cinq images, une pour chacune des dimensions suivantes:

  • 16 x 16 pixels, avec un fichier ne dépassant pas 1 Ko
  • 20 x 20 pixels, avec un fichier ne dépassant pas 1 Ko
  • 40 x 40 pixels, avec un fichier ne dépassant pas 1 Ko
  • 44 x 44 pixels, avec un fichier ne dépassant pas 1 Ko
  • 112 x 112 pixels, avec un fichier ne dépassant pas 3 Ko

Configuration supplémentaire requise pour les intégrations à Google TV : ces images de votre icône de marque s'afficheront en haut du guide de programmation, sur les boutons de lecture et dans les paramètres de Google TV. Fournissez trois icônes correspondant aux critères suivants:

  • Une icône carrée au format PNG. (avec une résolution de 512 x 512 pixels et des proportions de 1:1)
  • Une icône de marque blanche au format PNG. (meilleure résolution disponible, aucune préférence pour le format)
  • Icône d'une marque verbale colorée au format PNG. (meilleure résolution disponible, aucune préférence pour le format)

Assurez-vous que les images sont correctement ancrées et qu'elles ne sont pas déformées/pixelisées.

brandIcon.contentURL URL

Obligatoire : URL de l'image.

brandIcon.height Number

Obligatoire : hauteur de l'image, en pixels.

brandIcon.width Number

Obligatoire : largeur de l'image, en pixels.

brandIcon.additionalProperty PropertyValue

Obligatoire : propriété supplémentaire permettant de décrire le type de l'image et de définir les utilisations prévues.

brandIcon.additionalProperty.@type Texte

Obligatoire : défini sur PropertyValue.

brandIcon.additionalProperty.name Texte

Obligatoire : défini sur contentAttributes.

brandIcon.additionalProperty.value Texte

Obligatoire : adéquation avec le contexte

Pour qu'elle soit valide, définissez au moins l'une des valeurs suivantes:

  • forDarkBackground:image (généralement icône transparente) adaptée à un arrière-plan sombre.
  • forLightBackground : image, généralement icône transparente, adaptée à un arrière-plan clair.
application SotfwareApplication

Obligatoire si les applications iOS, Android, Cast ou Android TV sont fournies : liste des applications de votre marque parmi les suivantes :

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type Texte

Obligatoire : toujours défini sur SoftwareApplication.

application.operatingSystem Texte

Obligatoire : définissez l'une des options suivantes :

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadURL URL

Obligatoire, le cas échéant - Pour les plates-formes Android, Android TV et iOS, vous devez spécifier ce lien en tant que lien vers votre application dans l'App Store et le Play Store.

Pour toutes les autres plates-formes, cette propriété n'est pas obligatoire.

application.installURL URL

Obligatoire si applicable : si le fournisseur propose une lecture de contenus multimédias via une application Android TV, vous devez spécifier ce lien en tant que lien vers le fichier APK Android TV.

Si le fournisseur ne propose pas de lecture Android TV, cette propriété n'est pas obligatoire.

application.identifier

Texte

Obligatoire si applicable - Pour les plates-formes qui correspondent à l'une des valeurs suivantes, définissez-la en conséquence. Cette propriété n'est par ailleurs pas obligatoire:

  • iOS:identifiant de l'application sur la plate-forme de téléchargement d'applications. Exemple : 967093455.
  • Android:nom du package Android sur le Play Store. Par exemple, com.abc.media.android.
  • Cast : ID de l'application Cast. Exemple : ACDA4FDE.
  • AndroidTV:nom du package Android TV du Play Store. Par exemple, com.abc.media.atv.android.
parentOrganization Entreprise

Obligatoire : fournisseur parent du service.

parentOrganization.@type Texte

Obligatoire : toujours défini sur Organization.

parentOrganization.name Texte

Obligatoire : nom de l'organisation.

subscriptions Abonnement multimédia

Facultatif : liste des MediaSubscriptions disponibles compatibles avec le fournisseur de la montre.

baseSubscriptionTier Abonnement multimédia

Obligatoire si applicable - Si un fournisseur de montre et le fournisseur disposent d'un forfait d'abonnement de base, vous devez le définir sur l'instance d'abonnement pour le contenu disponible pour tous les abonnés. Cette propriété n'est par ailleurs pas obligatoire.

userRequestsFulfilledBy Texte

Facultatif - Définissez l'une des parties suivantes qui répondent aux requêtes de l'utilisateur:

  • Google : toutes les requêtes sont traitées par Google. Globalement, Google renvoie le lien profond pour le contenu demandé.
  • Provider : toutes les requêtes sont traitées par le fournisseur de contenu, à savoir le fournisseur cloud. En résumé, le fournisseur renvoie le lien profond pour le contenu demandé ou lance la lecture directement sur ses appareils.

Par défaut, cette propriété est définie sur Google.

mediaOffered Texte

Obligatoire : définissez l'un des éléments suivants, qui correspondent aux types de contenu de votre catalogue inclus dans le flux :

  • ["VoD"] : le fournisseur n'inclut que du contenu de vidéo à la demande dans le flux. Les contenus VoD incluent les films et les séries TV.
  • ["LiveTV"] : le fournisseur n'inclut que la télévision en direct, qui inclut le contenu des chaînes et BroadcastEvent, dans le flux.
  • ["VoD", "LiveTV"] : le fournisseur inclut à la fois des contenus VoD et Live TV dans le flux.
  • ["Music"] : le fournisseur n'inclut que les entités musicales dans le flux. Cela inclut les contenus Album, Artists, Songs et Playlist.
  • ["Radio"] : le fournisseur n'inclut que les entités Radio dans le flux.
  • ["Music", "Radio"] : le fournisseur inclut des entités musicales et radio dans le flux. Cela inclut le contenu des albums, artistes, titres, playlists et stations de radio.

Exemple de MediaService

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadURL": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadURL": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadURL": "https://google.play.store/com.abc.media.atv.android",
          "installURL": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}