Inhalts-Markup-Eigenschaften von Live-TV-Ereignissen

Dieser Abschnitt enthält Details zu den Eigenschaften des Inhalts-Markups für den Entitätstyp BroadcastEvent. Weitere Informationen zum Zusammenspiel dieser Typen finden Sie im Artikel Live-TV-Ereignisse.

Tabelle mit BroadcastEvent-Spezifikationen

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 Format BCP 47, z. B. „en“.
@type Text Erforderlich: Immer auf BroadcastEvent gesetzt.
@id URL Erforderlich: Kennzeichnung des Inhalts im URI-Format, z. B. https://beispiel.de/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID sollte stabil sein und sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Property der Sendung ändert. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da der url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, den url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Titel der Sendung oder des Ereignisses.
description Text Die Beschreibung der Sendung oder des Ereignisses. 300-stelliger Limette. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen aufzunehmen.
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 Nachricht an alle Erforderlich, falls zutreffend: Gib die Entität BroadcastService an, die diese Sendung oder dieses Ereignis überträgt.

Wenn die Inhalte auf einem TV-Kanal gesendet werden, ist diese Property erforderlich. Geben Sie diese Property nicht an, wenn der Inhalt mit keinem TV-Kanal verknüpft ist.
publishedOn.@type Text Setze diese Property auf BroadcastService.
publishedOn.@id URL Die @id der BroadcastService-Entität, mit der diese Sendung oder dieses Ereignis übertragen wird.
workPerformed CreativeWork Erforderlich, falls zutreffend: Verwenden Sie diese Property, wenn der Inhalt einen der folgenden Entitätstypen hat: Movie, TVSeries oder TVEpisode.
Es wird dringend empfohlen, dass eine Entität BroadcastEvent eine der folgenden Eigenschaften aufweist:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
workPerformed.@type Text Auf Movie, TVSeries oder TVEpisode festlegen.
workPerformed.@id URL Das @id der Inhaltsentität.
broadcastOfEvent Sportveranstaltung Erforderlich, falls zutreffend: Verwende diese Property, wenn es sich bei dem Inhalt um eine Live-Veranstaltung handelt:
  • Für eine Sportveranstaltung muss sich diese Eigenschaft auf eine SportsEvent-Entität beziehen.

Es wird dringend empfohlen, dass ein BroadcastEvent-Element 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 unterscheidet sich von @id durch BroadcastEvent.
videoFormat Text Die höchste Qualitätsdefinition, die von diesem Übertragungsdienst unterstützt wird. Beispiel:
  • „SD“ für Standardauflösung.
  • „HD“ für HD.
  • „2K“ für 2K-Auflösung.
  • „4K“ für 4K-Auflösung
  • „8K“ für 8K-Auflösung.
contentToBeAnnounced Boolesch Erforderlich, falls zutreffend: Verwenden Sie diese Property, wenn der Inhalt zum Zeitpunkt der Erstellung des Feeds unbekannt ist.

Legen Sie diese Einstellung auf true fest, wenn der Anbieter keine aktuellen Informationen darüber erhält, was übertragen wird. Andernfalls false.
Es wird dringend empfohlen, dass ein BroadcastEvent-Objekt mindestens eines der folgenden Elemente enthält:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
offAir Boolesch Falls erforderlich: Verwenden Sie diese Property, wenn für das Zeitfenster keine geplanten Inhalte gesendet werden.
Es wird dringend empfohlen, dass ein BroadcastEvent-Element mindestens eines der folgenden Elemente umfasst:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
isLiveBroadcast Boolesch Wähle true aus, wenn es sich um eine Live-Veranstaltung handelt, z. B. eine Sportveranstaltung oder ein Konzert.
potentialAction WatchAction Erforderlich, falls zutreffend: Wenn die Inhalte als Kanal ohne Livestreaming übertragen werden (wobei contentToBeAnnounced auf false oder offAir auf false gesetzt ist), muss diese Property verwendet werden, um den Deeplink der Veranstaltung anzugeben.
identifier PropertyValue Externe ID zur Identifizierung des Übertragungsinhalts. Weitere Informationen finden Sie im Abschnitt Eigenschaften von Kennungen.
  • Hinweis: Für den Entitätstyp BroadcastEvent können nur propertyID-Werte von TMS_ID oder TMS_ROOT_ID akzeptiert werden.
  • Diese Property sollte nur angegeben werden, wenn auf eine vollständig formatierte Entität auf oberster Ebene (Movie, TVSeries, TVEpisode oder SportsEvent) nicht mit der Property workPerformed oder broadcastOfEvent verwiesen wird.
  • Der Wert der Property sollte die TMS_ID oder TMS_ROOT_ID der Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität sein, auf die Sie mit der Property workPerformed oder broadcastOfEvent idealerweise verweisen würden.
  • TMS_ID wird gegenüber dem Wert TMS_ROOT_ID bevorzugt.
contentRating Text oder Bewertung Erforderlich für Inhalte nur für Erwachsene, wird dringend empfohlen, andernfalls Warum? – Gesamtbewertung der Inhalte der übertragenen Inhalte Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Bewertungsstelle, der die Bewertung vorangeht, mit einem Leerzeichen dazwischen. So sollte etwa die Altersfreigabe „PG-13“ der Agentur „MPAA“ in den USA als „MPAA PG-13“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Altersfreigabe nicht bekannt) (Groß-/Kleinschreibung nicht berücksichtigend) bedeutet, dass Sie die Altersfreigabe für den Film nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Einstufungsstelle.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Beratungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V, D = Dialog, FV = Fantasiegewalt , L = Sprache, S = pornografische Inhalte, V = Gewalt.

Beispiele

Am 12. Oktober 2019 wird zwischen 21:00 Uhr und 21:30 Uhr eine TV-Folge im TV-Netzwerk Beispiel-TV (BroadcastService) übertragen:

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

Übertragungsdienst

{
  "@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 die Inhalte für das Fernsehprogramm Beispiel-TV (BroadcastService) zwischen 21:00 und 21:30 Uhr am 12. Oktober 2019 zum Zeitpunkt der Erstellung übertragen wurden.

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "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
}

Übertragungsdienst

{
  "@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 und 20:00 Uhr ausgestellt und übertragen 1 Sendung mit dem Namen My favorite show zwischen 20:00 und 12:00 Uhr:

BroadcastEvent

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },

}

Übertragungsdienst

{
  "@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 die Themen für diese Properties: