Eigenschaften des Inhalts-Markups von MediaService (erforderlich)

In diesem Abschnitt findest du Details zu den Inhalts-Markup-Properties für den Entitätstyp MediaService, der die Konfiguration für die Media Action-Integration erfasst.

Tabelle mit Spezifikationen

Attribut Erwarteter Typ Beschreibung
@type Text

Erforderlich: Muss immer auf MediaService gesetzt sein.

@context Text

Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}] gesetzt sein.

@id URL

Erforderlich: Eine eindeutige Kennung für Ihre Marke, z. B. https://example.com.

Die Kennung muss die folgenden Anforderungen erfüllen:

  • Sie ist im gesamten Katalog eindeutig.
  • Es ist statisch. Die ID muss immer gleich bleiben.
  • Er hat das Format „Uniform Resource Identifier“ (URI).
  • Die Domain muss Ihrer Organisation gehören.
name Text

Erforderlich: Der Name des Anbieters.

Wenn Ihre Marke lokalspezifische Namen hat, listen Sie diese in einem Array auf. Ein Beispiel dafür findest du im Beispiel für MediaService.

brandIcon ImageObject

Erforderlich für alle Wiedergabe- und Wiedergabeaktionen: Die Bilddatei Ihres Markensymbols, wiederholt für jede Größe. Im Aktionsergebnis „Ansehen/Anhören“ verknüpft Google die Deeplinks deiner Inhalte mit deinem Markensymbol.

Die Bilddatei Ihres Markensymbols muss die folgenden Anforderungen erfüllen:

  • Es ist eine PNG-Datei.
  • Der Hintergrund ist transparent.
  • Die Form ist rund.
  • Achten Sie darauf, dass die Bilder Anti-Aliasing haben und nicht verzerrt oder pixelig sind.

Diese Eigenschaft muss wiederholt werden, da Sie fünf Bilder angeben müssen, jeweils eines für die folgenden Dimensionen:

  • 16 x 16 Pixel, Dateigröße maximal 1 KB
  • 20 × 20 Pixel, Dateigröße maximal 1 KB
  • 40 × 40 Pixel, Dateigröße maximal 1 KB
  • 44 × 44 Pixel, Dateigröße maximal 1 KB
  • 112 × 112 Pixel, Dateigröße maximal 3 KB

Zusätzliche Anforderung für Google TV-Integrationen: Diese Bilder deines Markensymbols werden oben im Programmführer, auf den Schaltflächen für Wiedergabeaktionen und in den Google TV-Einstellungen angezeigt. Sie müssen drei Symbole angeben, die die folgenden Anforderungen erfüllen:

  • Ein quadratisches Symbol im PNG-Dateiformat. (mit einer Auflösung von 512 × 512 Pixeln und einem Seitenverhältnis von 1:1)
  • Ein weißes Wordmark-Symbol im PNG-Dateiformat. (höchste verfügbare Auflösung, keine Präferenz für das Seitenverhältnis)
  • Ein farbiges Wordmark-Symbol im PNG-Dateiformat. (höchste verfügbare Auflösung, keine Präferenz für das Seitenverhältnis)

Achten Sie darauf, dass die Bilder Anti-Aliasing haben und nicht verzerrt oder pixelig sind.

brandIcon.contentURL URL

Erforderlich: Die URL des Bilds.

brandIcon.height Number

Erforderlich: Die Höhe des Bilds in Pixeln.

brandIcon.width Number

Erforderlich: Die Breite des Bilds in Pixeln.

brandIcon.additionalProperty PropertyValue

Erforderlich: Mit dieser zusätzlichen Property wird der Typ des Bildes beschrieben und seine beabsichtigten Verwendungen definiert.

brandIcon.additionalProperty.@type Text

Erforderlich: Legen Sie hierfür den Wert PropertyValue fest.

brandIcon.additionalProperty.name Text

Erforderlich: Legen Sie hierfür den Wert contentAttributes fest.

brandIcon.additionalProperty.value Text

Erforderlich: Die Eignung des Hintergrunds.

Legen Sie mindestens einen der folgenden Werte fest, damit der Wert gültig ist:

  • forDarkBackground:Ein Bild, in der Regel ein transparentes Symbol, das sich für die Verwendung auf einem dunklen Hintergrund eignet.
  • forLightBackground:Ein Bild, in der Regel ein transparentes Symbol, das sich für die Verwendung auf einem hellen Hintergrund eignet.
application SotfwareApplication

Erforderlich, wenn iOS-, Android-, Cast- oder Android TV-Apps bereitgestellt werden: Liste Ihrer Marken-Apps für Folgendes:

  • iOS
  • Android
  • Streamen
  • AndroidTV
application.@type Text

Erforderlich: Muss immer auf SoftwareApplication gesetzt sein.

application.operatingSystem Text

Erforderlich: Legen Sie einen der folgenden Werte fest:

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

Falls zutreffend erforderlich: Für die Plattformen Android, Android TV und iOS müssen Sie dies als Link zu Ihrer App im App Store und Play Store angeben.

Für alle anderen Plattformen ist dieses Attribut nicht erforderlich.

application.installUrl URL

Falls zutreffend erforderlich: Wenn der Anbieter die Medienwiedergabe über eine Android TV-App anbietet, müssen Sie hier den Link zur Android TV-APK-Datei angeben.

Wenn der Anbieter keine Android TV-Wiedergabe anbietet, ist diese Property nicht erforderlich.

application.identifier

Text

Falls zutreffend erforderlich: Legen Sie für Plattformen, die einem der folgenden Werte entsprechen, den Wert entsprechend fest. Andernfalls ist diese Property nicht erforderlich:

  • iOS:Die App-ID des App Store. Beispiel: 967093455.
  • Android:Der Android-Paketname des Play Store. Beispiel: com.abc.media.android.
  • Cast:Die ID der Cast-App. Beispiel: ACDA4FDE.
  • AndroidTV:Der AndroidTV-Paketname im Play Store. Beispiel: com.abc.media.atv.android.
parentOrganization Organisation

Erforderlich: Der übergeordnete Anbieter des Dienstes.

parentOrganization.@type Text

Erforderlich: Muss immer auf Organization gesetzt sein.

parentOrganization.name Text

Erforderlich: Der Name der Organisation.

subscriptions MediaSubscription

Optional: Liste der verfügbaren MediaSubscriptions, die vom Anbieter der Smartwatch unterstützt werden.

baseSubscriptionTier MediaSubscription

Falls zutreffend erforderlich: Wenn ein Anbieter von Smartwatches ein Basis-Abopaket hat, musst du dies für die Aboinstanz für Inhalte festlegen, die für alle Abonnenten verfügbar sind. Andernfalls ist dieses Attribut nicht erforderlich.

userRequestsFulfilledBy Text

Optional: Legen Sie eine der folgenden Parteien fest, die die Nutzeranfragen erfüllt:

  • Google:Alle Anfragen werden von Google bearbeitet. Google gibt im Wesentlichen den Deeplink für die angeforderten Inhalte zurück.
  • Provider:Alle Anfragen werden vom Inhaltsanbieter – dem Cloud-Anbieter – ausgeführt. Im Grunde gibt der Anbieter den Deeplink für die angeforderten Inhalte zurück oder startet die Wiedergabe direkt auf seinen Geräten.

Standardmäßig ist diese Eigenschaft auf Google festgelegt.

mediaOffered Text

Erforderlich: Wählen Sie einen der folgenden Werte aus, die den Inhaltstypen in Ihrem Katalog entsprechen, die im Feed enthalten sind:

  • ["VoD"] – Der Anbieter fügt dem Feed nur Video-on-Demand-Inhalte (VoD) hinzu. Zu den VoD-Inhalten gehören Filme und Serien.
  • ["LiveTV"] – Der Anbieter fügt dem Feed nur Live-TV hinzu, einschließlich Kanälen und BroadcastEvent-Inhalten.
  • ["VoD", "LiveTV"] – Der Anbieter fügt dem Feed sowohl VOD- als auch Live-TV-Inhalte hinzu.
  • ["Music"]: Der Anbieter nimmt nur Musikentitäten in den Feed auf. Dazu gehören Inhalte zu Alben, Künstlern, Songs und Playlists.
  • ["Radio"]: Der Anbieter nimmt nur Radio-Entitäten in den Feed auf.
  • ["Music", "Radio"]: Der Anbieter fügt dem Feed Musik- und Radioentitäten hinzu. Dazu gehören Inhalte zu Alben, Künstlern, Songs, Playlists und Radiosendern.

Beispiel für 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"
      }
    }
  ]
}