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

Cette section fournit les détails des 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 : cette valeur est toujours définie sur MediaService.

@context Texte

Obligatoire : cette valeur est toujours définie 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 au niveau mondial, sur l'ensemble de votre catalogue.
  • Elle est statique. Cet identifiant doit être stable et immuable dans le temps.
  • 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 à des paramètres régionaux, répertoriez-les dans un tableau. Pour obtenir un exemple, reportez-vous à l'exemple MediaService.

brandIcon ImageObject

Obligatoire pour toutes les actions de visionnage et les actions d'écoute : fichier image de votre icône de marque, répété pour chaque taille. Dans les résultats "Action de visionnage" ou "Action d'écoute", 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:

  • Le fichier est au format 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/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 d'action de visionnage et dans les paramètres de Google TV. Fournissez trois icônes qui répondent aux exigences suivantes:

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

Assurez-vous que les images sont anticrénelé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 utilisée pour décrire le type d'image et 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 : la conformité avec l'arrière-plan.

Pour être valide, définissez 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 à un arrière-plan clair.
application SotfwareApplication

Obligatoire si les applications iOS, Android, Cast ou AndroidTV sont fournies – Liste des applications de marque listées ci-dessous:

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

Obligatoire : cette valeur est toujours définie sur SoftwareApplication.

application.operatingSystem Texte

Obligatoire : spécifiez l'une des valeurs 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 comme 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 de contenus multimédias via une application Android TV, vous devez spécifier ce lien en tant que lien vers le fichier APK AndroidTV.

Si le fournisseur ne propose pas la 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'une des valeurs suivantes, définissez-le en conséquence. Cette propriété n'est autrement pas obligatoire:

  • iOS:identifiant de l'application sur la plate-forme de téléchargement d'applications. Exemple : 967093455.
  • Android:nom du package Android du Play Store. Par exemple, com.abc.media.android.
  • Cast: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 : cette valeur est toujours définie sur Organization.

parentOrganization.name Texte

Obligatoire : nom de l'organisation.

subscriptions Abonnement Media

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

baseSubscriptionTier Abonnement Media

Obligatoire, le cas échéant : si un fournisseur de montre et le fournisseur possède un package d'abonnement de base, vous devez le définir sur l'instance d'abonnement pour tous les contenus disponibles pour tous les abonnés. Cette propriété n'est autrement pas obligatoire.

userRequestsFulfilledBy Texte

Facultatif : Définissez l'une des parties suivantes qui traite les demandes des utilisateurs :

  • 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, c'est-à-dire le fournisseur cloud. En bref, 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 contenus 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, ce qui inclut les contenus de chaînes et d'BroadcastEvent.
  • ["VoD", "LiveTV"] : le fournisseur inclut des contenus VoD et Live TV dans le flux.
  • ["Music"] : le fournisseur n'inclut que des entités musicales dans le flux. Cela inclut le contenu Album, Artists, Songs et Playlist.
  • ["Radio"] : le fournisseur n'inclut que les entités Radio dans le flux.
  • ["Music", "Radio"] : le fournisseur inclut de la musique et des entités radio dans le flux. Cela inclut le contenu Album, Artists, Songs, Playlist et Radio Station.

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