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

Cette section fournit des informations détaillées sur les propriétés de balisage de contenu pour Type d'entité MediaService qui capture la configuration de votre action multimédia intégration

Tableau 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 de votre marque Exemple : https://example.com

Cet identifiant doit respecter les exigences suivantes:

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

Obligatoire : nom du fournisseur.

Si votre marque utilise des noms spécifiques à certains paramètres régionaux, répertoriez-les dans un tableau. Par exemple, consultez l'exemple MediaService.
brandIcon ImageObject

Obligatoire pour toutes les actions de visionnage et d'écoute : le fichier image de votre marque plusieurs fois pour chaque taille. Dans le résultat de l'action "Regarder/Écouter", Google associe votre les liens profonds vers l'icône de votre marque.

Le fichier image de l'icône de votre 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 anticrénelées et qu'elles ne sont pas déformées ni 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 d'une taille maximale de 1 Ko
  • 20 x 20 pixels, avec un fichier d'une taille maximale de 1 Ko
  • 40 x 40 pixels, avec un fichier d'une taille maximale de 1 Ko
  • 44 x 44 pixels, avec un fichier d'une taille maximale de 1 Ko
  • 112 x 112 pixels, avec un fichier d'une taille maximale de 3 Ko

Exigence supplémentaire pour les intégrations Google TV : ces images de votre marque s'affiche en haut du guide de programmation, sur les boutons Actions de la montre et dans les paramètres Google TV. Fournissez trois icônes répondant aux exigences suivantes:

  • Une icône carrée au format PNG. (avec une résolution de 512 x 512 pixels, format 1:1)
  • Une icône de marque verbale blanche au format PNG. (résolution la plus élevée disponible, aucune préférence de format)
  • Une icône de marque verbale colorée au format PNG. (résolution la plus élevée disponible, aucune préférence de format)

Assurez-vous que les images sont anticrénelées et qu'elles ne sont pas déformées ni 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 définit sa les utilisations prévues.
brandIcon.additionalProperty.@type Texte

Obligatoire : définissez la valeur sur PropertyValue.
brandIcon.additionalProperty.name Texte

Obligatoire : définissez la valeur sur contentAttributes.
brandIcon.additionalProperty.value Texte

Obligatoire : adéquation d'arrière-plan.

Pour être valide, définissez au moins l'une des valeurs suivantes:

  • forDarkBackground:image (généralement une icône transparente) dont le format convient à une utilisation sur un fond sombre.
  • forLightBackground:image (généralement une icône transparente) dont le format sur un fond clair.
application SotfwareApplication

Obligatoire si des applications iOS, Android, Cast ou AndroidTV sont fournies : la liste de vos applications de marque dans les éléments suivants :

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

Obligatoire : toujours défini sur SoftwareApplication.
application.operatingSystem Texte

Obligatoire : Définissez ce paramètre sur l'une des valeurs suivantes :

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

Obligatoire, le cas échéant. Pour les plates-formes Android, AndroidTV et iOS, vous devez : spécifiez-le comme lien vers votre application sur l'App Store et le Play Store.

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

Obligatoire, le cas échéant : si le fournisseur propose la lecture de contenus multimédias via un l'application AndroidTV, vous devez le spécifier en tant que lien vers le fichier APK AndroidTV.

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

Texte

Obligatoire, le cas échéant : pour les plates-formes correspondant à l'un des éléments suivants , définissez-les en conséquence. Sinon, cette propriété n'est pas obligatoire:

  • iOS::identifiant de l'application App Store. Exemple :967093455
  • Android::nom du package Android du Play Store. Par exemple, com.abc.media.android.
  • Caster:ID de l'application Cast. Exemple :ACDA4FDE
  • AndroidTV::nom du package AndroidTV 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 MediaSubscription

Facultatif : Liste des MediaSubscriptions disponibles pris en charge par le fournisseur de la montre.
baseSubscriptionTier MediaSubscription

Obligatoire, le cas échéant : si le fournisseur d'une montre et lui-même disposent d'un compte de base abonnement, vous devez le définir sur l'instance d'abonnement pour le contenu disponible pour tous les abonnés. Sinon, cette propriété n'est pas obligatoire.
userRequestsFulfilledBy Texte

Facultatif : défini sur l'une des parties suivantes qui répondent aux besoins de l'utilisateur requêtes:

  • Google:toutes les demandes sont traitées par Google. En bref, Google renvoie le lien profond pour le contenu demandé.
  • Provider:toutes les requêtes sont traitées par le fournisseur de contenu, Cloud Provider. En bref, le fournisseur renvoie le lien profond vers le contenu demandé ou lance la lecture directement sur leur appareil.

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

Obligatoire : définissez ce paramètre sur l'une des valeurs suivantes. Il correspond aux types de contenus de de votre catalogue qui sont inclus dans le flux:

  • ["VoD"] : le fournisseur n'inclut que du contenu vidéo à la demande (VoD) dans le flux. Les contenus VoD incluent Films et Émissions télévisées :
  • ["LiveTV"] : le fournisseur n'inclut que la télévision en direct, ce qui inclut Chaînes et BroadcastEvent dans le flux.
  • ["VoD", "LiveTV"] : le fournisseur inclut à la fois les contenus VoD et TV en direct dans le flux.
  • ["Music"] : le fournisseur n'inclut que des entités musicales dans le flux. Ce inclut Album, artistes, titres et Playlist de votre contenu.
  • ["Radio"] : le fournisseur n'inclut que les entités Radio dans le flux.
  • ["Music", "Radio"] : le fournisseur inclut des entités musique et radio dans le flux. Ce inclut Albums, artistes, titres, Playlist, et station de radio de votre contenu.

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