Inhalts-Markup-Eigenschaften von MediaService (erforderlich)

Dieser Abschnitt enthält Details zu den Markup-Eigenschaften des Inhalts für den MediaService-Entitätstyp, der die Konfiguration für die Media Action-Integration erfasst

Spezifikationstabelle

Attribut Erwarteter Typ Beschreibung
@type Text

Erforderlich: Immer auf MediaService gesetzt.
@context Text

Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}] gesetzt.
@id URL

Erforderlich: Eine eindeutige Kennung für Ihre Marke. Beispiel: https://example.com.

Die Kennung muss die folgenden Anforderungen erfüllen:

  • Es ist weltweit in Ihrem Katalog eindeutig.
  • Sie ist statisch. Die ID muss immer gleich bleiben.
  • Sie hat das URI-Format (Unified Resource Identifier).
  • Ihre Domain muss Eigentum Ihrer Organisation sein.
name Text

Erforderlich: Name des Anbieters.

Wenn Ihre Marke gebietsspezifische Namen hat, geben Sie diese in einem Array an. Ein Beispiel hierfür finden Sie in dem MediaService-Beispiel.
brandIcon ImageObject

Für alle Wiedergabe- und Höraktionen erforderlich: Die Bilddatei Ihres Markensymbols, die für jede Größe wiederholt wird. Im Ergebnis der Aktion „Ansehen/zuhö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.
  • Seine Form ist von Natur aus.
  • Die Bilder müssen Aliasse enthalten und dürfen nicht verzerrt oder verpixelt sein.

Dieses Attribut muss wiederholt werden, da Sie fünf Bilder angeben müssen, eines für jede der folgenden Dimensionen:

  • 16 x 16 Pixel, mit einer Datei, die nicht größer als 1 KB ist
  • 20 × 20 Pixel, mit einer Datei, die nicht größer als 1 KB ist
  • 40 × 40 Pixel, mit einer Datei, die nicht größer als 1 KB ist
  • 44 x 44 Pixel mit einer Datei, die nicht größer als 1 KB ist
  • 112 x 112 Pixel, mit einer Datei, die nicht größer als 3 KB ist

Zusätzliche Anforderungen für Google TV-Integrationen: Diese Bilder Ihres Markensymbols werden oben im Programmierleitfaden, auf den Schaltflächen für Smartwatch-Aktionen und in den Google TV-Einstellungen angezeigt. Stelle drei Symbole zur Verfügung, die die folgenden Anforderungen erfüllen:

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

Achten Sie darauf, dass die Bilder Aliasse enthalten und nicht verzerrt/verpixelt sind.

brandIcon.contentURL URL

Erforderlich: Die URL des Bilds.
brandIcon.height Number

Erforderlich: Höhe des Bildes in Pixeln
brandIcon.width Number

Erforderlich: Breite des Bildes in Pixeln
brandIcon.additionalProperty PropertyValue

Erforderlich: Das ist die zusätzliche Property, die verwendet wird, um den Typ des Bildes zu beschreiben und seine Verwendungszwecke zu definieren.
brandIcon.additionalProperty.@type Text

Erforderlich: Legen Sie diesen Wert auf PropertyValue fest.
brandIcon.additionalProperty.name Text

Erforderlich: Legen Sie diesen Wert auf contentAttributes fest.
brandIcon.additionalProperty.value Text

Erforderlich: Eignung für den Hintergrund

Legen Sie mindestens einen der folgenden Werte fest, um gültig zu sein:

  • forDarkBackground:Ein Bild, in der Regel ein transparentes Symbol, das vor einem dunklen Hintergrund verwendet werden kann.
  • forLightBackground:Ein Bild, in der Regel ein transparentes Symbol, das vor einem hellen Hintergrund verwendet werden kann.
application Sotfware-Anwendung

Erforderlich, wenn iOS-, Android-, Cast- oder AndroidTV-Apps bereitgestellt werden: Liste der Markenanwendungen für Folgendes:

  • iOS
  • Android
  • Google Cast
  • AndroidTV
application.@type Text

Erforderlich: Immer auf SoftwareApplication gesetzt.
application.operatingSystem Text

Erforderlich: Legen Sie einen der folgenden Werte fest:

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

Erforderlich, sofern zutreffend: Sie müssen für Android-, AndroidTV- und iOS-Plattformen den Link zu Ihrer App im App Store und Play Store angeben.

Bei allen anderen Plattformen ist diese Property nicht erforderlich.
application.installUrl URL

Erforderlich, falls zutreffend: Wenn der Anbieter die Medienwiedergabe über eine Android TV-App anbietet, müssen Sie dies als Link zur Android TV-APK-Datei angeben.

Wenn der Anbieter die AndroidTV-Wiedergabe nicht anbietet, ist diese Property nicht erforderlich.
application.identifier

Text

Erforderlich, falls zutreffend: Legen Sie diese für Plattformen fest, die einem der folgenden Werte entsprechen. Andernfalls ist diese Property nicht erforderlich:

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

Erforderlich: Der übergeordnete Anbieter des Dienstes.
parentOrganization.@type Text

Erforderlich: Immer auf Organization gesetzt.
parentOrganization.name Text

Erforderlich: Name der Organisation.
subscriptions MediaSubscription

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

Erforderlich, falls zutreffend: Wenn ein Smartwatch-Anbieter und der Anbieter ein grundlegendes Abopaket haben, müssen Sie dieses für die Aboinstanz festlegen, damit die Inhalte für alle Abonnenten verfügbar sind. Andernfalls ist diese Property nicht erforderlich.
userRequestsFulfilledBy Text

Optional: Legen Sie einen der folgenden Anbieter fest, der die Nutzeranfragen erfüllt:

  • Google:Alle Anfragen werden von Google bearbeitet. Google gibt im Wesentlichen den Deeplink für den angeforderten Inhalt zurück.
  • Provider: Alle Anfragen werden vom Contentanbieter – dem Cloud-Anbieter – erfüllt. Der Anbieter gibt den Deeplink für den angeforderten Inhalt zurück oder initiiert die Wiedergabe direkt auf seinen Geräten.

Standardmäßig ist diese Eigenschaft auf Google gesetzt.
mediaOffered Text

Erforderlich – Lege einen der folgenden Werte für den Inhaltstyp in deinem Katalog fest, der im Feed enthalten ist:

  • ["VoD"]: Der Anbieter fügt dem Feed nur Video-on-Demand-Inhalte hinzu. Dazu gehören Filme und Serien.
  • ["LiveTV"]: Der Anbieter umfasst nur Live-TV mit Kanälen und BroadcastEvent-Inhalten im Feed.
  • ["VoD", "LiveTV"]: Der Anbieter nimmt VoD- und Live-TV-Inhalte in den Feed auf.
  • ["Music"]: Der Anbieter nimmt im Feed nur Musikentitäten auf. Dazu gehören Inhalte aus Alben, Künstlern, Songs und Playlists.
  • ["Radio"]: Der Anbieter nimmt im Feed nur Radio-Elemente auf.
  • ["Music", "Radio"]: Der Anbieter fügt dem Feed Musik- und Radioentitäten hinzu. Dazu gehören Inhalte aus Alben, Künstlern, Songs, Playlist und Radiosender.

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