Eigenschaften des Inhalts-Markups von Live-TV-Veranstaltungen

In diesem Abschnitt finden Sie die Details zu den Content-Markup-Eigenschaften für den Entitätstyp BroadcastEvent. Weitere Informationen zur Beziehung zwischen diesen Typen finden Sie unter LiveTV-Ereignisse.

Tabelle mit Spezifikationen für BroadcastEvent

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP 47-Format, z. B. „en“.
@type Text Erforderlich: Immer auf BroadcastEvent festgelegt.
@id URL Erforderlich: Die Kennung des Übertragungszeitraums im URI-Format, z. B. https://example.com/live/channel1/20191012T2100.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog und unterscheidet sich von workPerformed.@id oder broadcastOfEvent.@id (z. B. durch Einbeziehung des Kanals/Dienstes und der Startzeit der Übertragung in den URI)
  • Statisch: Die ID sollte stabil sein und sich im Laufe der Zeit nicht ändern. Er wird als intransparenter String behandelt und muss kein funktionierender Link sein.
  • In Form eines Unified Resource Identifier (URI)
  • Die für den Wert @id verwendete Domain muss Ihrer Organisation gehören.
Wichtig: Geben Sie keine url-Property für BroadcastEvent oder SportsEvent an. Gib die kanonische url nur für die zugrunde liegende Inhaltsentität (Movie, TVSeries oder TVEpisode) an. Weitere Informationen findest du im Abschnitt Kennung.
name Text Erforderlich: Der Titel der Sendung oder Veranstaltung.
description Text Die Beschreibung der Sendung oder des Ereignisses. Begrenzt auf 300 Zeichen. Verwenden Sie ein Array, um Beschreibungen in mehreren Sprachen (eine pro Sprache) einzufügen.
startDate Datum Erforderlich: Der Beginn des Ereignisses im ISO 8601-Format mit Zeitzone.
endDate Datum Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
publishedOn BroadcastService Erforderlich, falls zutreffend: Gib die BroadcastService-Entität an, die diese Sendung oder dieses Ereignis überträgt.

Wenn der Inhalt auf einem Fernsehsender übertragen wird, ist diese Property erforderlich. Wenn der Inhalt keinem TV-Kanal zugeordnet ist, gib diese Property nicht an.
publishedOn.@type Text Setze diese Property auf BroadcastService.
publishedOn.@id URL Der @id der BroadcastService-Entität, die diese Sendung oder Veranstaltung überträgt.
workPerformed CreativeWork Erforderlich, falls zutreffend: Verwende diese Property, wenn der Inhalt einer der folgenden Entitätstypen ist: Movie, TVSeries und TVEpisode.
Es wird dringend empfohlen, dass eine BroadcastEvent-Entität mindestens eines der folgenden Elemente enthält:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
workPerformed.@type Text Legen Sie dafür Movie, TVSeries oder TVEpisode fest.
workPerformed.@id URL Die @id der Inhaltsentität.
broadcastOfEvent SportsEvent Erforderlich, falls zutreffend: Verwende diese Property, wenn es sich bei dem Inhalt um eine Live-Veranstaltung handelt:
  • Bei einer Sportveranstaltung muss sich diese Property auf eine SportsEvent-Entität beziehen.

Es wird dringend empfohlen, dass eine BroadcastEvent-Entität mindestens eines der folgenden Elemente enthält:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
broadcastOfEvent.@type Text Setze diese Property auf SportsEvent.
broadcastOfEvent.@id URL Die @id der Ereignisentität. Die Ereignisentität muss im Feed vorhanden sein und eine andere @id als BroadcastEvent haben.
location Text oder Land Erforderlich, wenn „BroadcastEvent“ für ein „SportsEvent“ gilt, d.h. die Property broadcastOfEvent hat: Das Land, in dem das zugrunde liegende „SportsEvent“ übertragen werden kann. Dieses Feld kann eine Liste von Ländern enthalten, wenn das Sportereignis in mehreren Ländern übertragen werden kann.
videoFormat Text Die höchste Auflösung, die von diesem Übertragungsdienst unterstützt wird, z. B.
  • „SD“ für Standardauflösung.
  • „HD“ für High Definition.
  • „2K“ für 2K-Auflösung.
  • „4K“ für 4K-Auflösung
  • „8K“ für 8K-Auflösung.
contentToBeAnnounced Boolesch Erforderlich, falls zutreffend: Verwende diese Property, wenn der Inhalt zum Zeitpunkt der Erstellung des Feeds unbekannt ist.

Setze den Wert auf true, wenn der Anbieter keine aktuellen Informationen darüber hat, was übertragen wird, andernfalls auf false.
Es wird dringend empfohlen, dass eine BroadcastEvent-Entität mindestens eines der folgenden Elemente enthält:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
offAir Boolesch Erforderlich, falls zutreffend: Setze den Wert auf true, wenn für den Zeitraum auf einem BroadcastService-Kanal keine geplante Ausstrahlung von Inhalten vorgesehen ist.
  • Legen Sie sowohl name als auch description auf "Off Air" fest.
  • Jeder offAir-BroadcastEvent darf höchstens 4 Stunden umfassen (keine kontinuierlichen 24-Stunden-Blöcke). Wenn ein Kanal länger als 4 Stunden nicht auf Sendung ist, gib mehrere zusammenhängende, sich nicht überschneidende BroadcastEvent-Entitäten von jeweils höchstens 4 Stunden aus, damit der Kanal rund um die Uhr vollständig abgedeckt ist und keine Lücken am Anfang oder Ende des Feedfensters entstehen.
Es wird dringend empfohlen, dass eine BroadcastEvent-Entität mindestens eines der folgenden Elemente enthält:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
isLiveBroadcast Boolesch Setze den booleschen Wert auf true (ohne Anführungszeichen), wenn es sich bei dieser Ausstrahlung um eine Liveübertragung handelt (z. B. ein Live-Sportspiel oder Live-Nachrichten), oder auf false für nicht live übertragene Sendungen und Wiederholungen.
potentialAction WatchAction Erforderlich, falls zutreffend: Gib niemals potentialAction für ein BroadcastEvent an, wenn broadcastOfEvent auf ein SportsEvent verweist (platziere alle Deeplinks für Sport auf SportsEvent.potentialAction) oder wenn publishedOn auf einen BroadcastService-Kanal verweist (platziere Deeplinks für Kanäle auf BroadcastService.potentialAction). Gib BroadcastEvent.potentialAction nur für Livestreams ohne Kanal an, die nicht auf ein SportsEvent verweisen (z. B. eigenständige begleitende Live-Inhalte ohne contentToBeAnnounced und offAir oder false).
identifier PropertyValue Externe ID, die den übertragenen Inhalt identifiziert. Weitere Informationen finden Sie im Abschnitt Kennzeichnungsattribute.
  • Hinweis: Der Entitätstyp BroadcastEvent akzeptiert nur propertyID-Werte von entweder TMS_ID oder TMS_ROOT_ID.
  • Diese Property sollte nur angegeben werden, wenn eine vollständig gebildete Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität auf oberster Ebene nicht über die Property workPerformed oder broadcastOfEvent referenziert wird.
  • Der Wert der Property sollte die TMS_ID oder TMS_ROOT_ID der Entität Movie, TVSeries, TVEpisode oder SportsEvent widerspiegeln, auf die Sie idealerweise mit der Property workPerformed oder broadcastOfEvent verweisen würden.
  • TMS_ID wird gegenüber dem TMS_ROOT_ID-Wert bevorzugt.
contentRating Text oder Bewertung Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen Warum? – Gesamtbewertung des Inhalts der Übertragung. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, werden zwei Varianten akzeptiert:
  • Die Ratingagentur, die der Bewertung vorangestellt ist, mit einem Leerzeichen dazwischen. Beispiel: Eine Altersfreigabe „PG-13“ der MPAA in den USA sollte als „MPAA PG-13“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht berücksichtigt) gibt an, dass du die Altersfreigabe für den Film nicht kennst.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Bewertungsagentur.
contentRating.ratingValue Text Erforderlich, wenn contentRating den Wert Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Hinweiscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasy-Gewalt, L = Sprache, S = Sexuelle Inhalte, V = Gewalt.

Beispiele

Eine TV-Folge wird am 12. Oktober 2019 zwischen 21:00 Uhr und 21:30 Uhr im Fernsehsender Example TV (BroadcastService) ausgestrahlt:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Beispiel für die Verwendung der Property contentToBeAnnounced, wenn der Inhalt, der am 12. Oktober 2019 zwischen 21:00 Uhr und 21:30 Uhr im Fernsehsender Example TV (BroadcastService) ausgestrahlt werden soll, zum Zeitpunkt der Erstellung des Feeds nicht bekannt ist:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Der Fernsehsender Beispiel-TV (BroadcastService) ist zwischen 12:00 Uhr und 20:00 Uhr nicht auf Sendung (modelliert als zwei zusammenhängende 4-Stunden-Blöcke Off Air) und strahlt zwischen 20:00 Uhr und 00:00 Uhr eine Sendung namens My favorite show aus:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16:00-08:00",
  "endDate": "2019-10-12T20:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Auf den folgenden Seiten finden Sie Informationen zu diesen Properties: