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

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

Tableau des spécifications

Propriété Type attendu Description
@type Texte

Obligatoire : doit toujours être défini sur MediaService.
@context Texte

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

Obligatoire : identifiant unique de votre marque (par exemple, https://example.com).

L'identifiant doit respecter les exigences suivantes:

  • Il est unique dans l'ensemble de votre catalogue.
  • Il 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 spécifiques à une région, listez-les dans un tableau. Pour en savoir plus, consultez l'exemple MediaService.
brandIcon ImageObject

Obligatoire pour toutes les actions de visionnage et d'écoute : fichier image de votre icône de marque, répété pour chaque taille. Dans le résultat d'action "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 anticrénées et qu'elles ne sont pas déformées ni pixellisé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 de 1 Ko maximum
  • 112 x 112 pixels, avec un fichier ne dépassant pas 3 Ko

Exigence supplémentaire 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 d'action de visionnage et dans les paramètres de Google TV. Fournissez trois icônes qui respectent les exigences suivantes:

  • Une icône carrée au format PNG. (avec une résolution de 512 x 512 px, format 1:1)
  • Une icône de mot-marque blanche au format PNG. (résolution la plus élevée disponible, aucune préférence pour le format)
  • Une icône de mot-marque en couleur au format PNG. (résolution la plus élevée disponible, aucune préférence pour le format)

Assurez-vous que les images sont anticrénées et qu'elles ne sont pas déformées ni pixellisé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 utilisée pour décrire le type d'image et définir ses utilisations prévues.
brandIcon.additionalProperty.@type Texte

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

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

Obligatoire : l'adéquation du contexte.

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

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

Obligatoire si des applications iOS, Android, Cast ou Android TV sont fournies : liste des applications de votre marque sur les plates-formes suivantes :

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

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

Obligatoire : définissez cette option sur l'une des valeurs suivantes :

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

Obligatoire si applicable : pour les plates-formes Android, Android TV et iOS, vous devez spécifier ce 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 le cas échéant : si le fournisseur propose la lecture multimédia via une application Android TV, vous devez spécifier ce lien comme lien vers le fichier APK Android TV.

Si le fournisseur n'offre pas la 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 pas obligatoire dans les cas suivants:

  • iOS:identifiant de l'application sur l'App Store. 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 AndroidTV sur le Play Store. Par exemple, com.abc.media.atv.android.
parentOrganization Entreprise

Obligatoire : fournisseur parent du service.
parentOrganization.@type Texte

Obligatoire : doit toujours être défini sur Organization.
parentOrganization.name Texte

Obligatoire : nom de l'organisation.
subscriptions MediaSubscription

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

Obligatoire le cas échéant : si un fournisseur de montres dispose d'un package d'abonnement de base, vous devez définir cette valeur 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éfinissez sur l'une des parties suivantes qui traite les requêtes de l'utilisateur :

  • Google:toutes les requêtes sont traitées par Google. En substance, Google renvoie le lien profond vers le contenu demandé.
  • Provider:toutes les requêtes sont traitées par le fournisseur de contenu (le fournisseur cloud). En substance, le fournisseur renvoie le lien profond du 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'une des options suivantes, qui correspondent aux types de contenus de votre catalogue inclus dans le flux :

  • ["VoD"] : le fournisseur n'inclut que des contenus de vidéo à la demande (VOD) 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 comprend les contenus Channels et BroadcastEvent, dans le flux.
  • ["VoD", "LiveTV"] : le fournisseur inclut à la fois des contenus VOD et des contenus TV en direct dans le flux.
  • ["Music"] : le fournisseur n'inclut que des entités musicales dans le flux. Cela inclut les contenus Album, Artistes, Titres et Playlist.
  • ["Radio"] : le fournisseur n'inclut que des entités Radio dans le flux.
  • ["Music", "Radio"] : le fournisseur inclut des entités musicales et radio dans le flux. Cela inclut les contenus Album, Artistes, Titres, Playlist et Station 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"
      }
    }
  ]
}