Eigenschaften des Inhalts-Markups von Live-TV-Veranstaltungen

Dieser Abschnitt enthält Details zu den Eigenschaften des Inhalts-Markups für den Entitätstyp BroadcastEvent. Weitere Informationen zur Beziehung zwischen diesen Typen finden Sie in den Konzepten zu LiveTV-Ereignissen.

Tabelle mit BroadcastEvent-Spezifikation

Property 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 Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Einzigartig in deinem Katalog
  • Statisch. Die ID muss stabil sein und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Er wird als opaker String behandelt und muss kein funktionierender Link sein.
  • in Form eines URI (Unified Resource Identifier)
  • Die Domain, die für den Wert „@id“ verwendet wird, muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Titel der Sendung oder Veranstaltung.
description Text Die Beschreibung der Show oder des Ereignisses. Limist mit 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
startDate Datum Erforderlich: Die Startzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
endDate Datum Das Ende des Ereignisses im ISO 8601-Format mit Zeitzone.
publishedOn BroadcastService Erforderlich, falls zutreffend: Gib die Entität BroadcastService an, die diese Sendung oder Veranstaltung überträgt.

Wenn die Inhalte auf einem TV-Kanal übertragen werden, ist diese Eigenschaft erforderlich. Geben Sie diese Property nicht an, wenn die Inhalte mit keinem TV-Kanal verknüpft sind.
publishedOn.@type Text Setze diese Property auf BroadcastService.
publishedOn.@id URL Die @id der BroadcastService-Entität, die diese Sendung oder Veranstaltung überträgt.
workPerformed CreativeWork Erforderlich, sofern zutreffend: Verwenden Sie diese Property, wenn der Inhalt einen der folgenden Entitätstypen hat: Movie, TVSeries oder TVEpisode.
Es wird dringend empfohlen, eine BroadcastEvent-Entität mindestens eine der folgenden Optionen zu enthalten:
  • 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 Der @id der Inhaltsentität.
broadcastOfEvent SportsEvent Erforderlich, falls zutreffend: Verwende diese Property, wenn es sich um eine Live-Veranstaltung handelt:
  • Bei einer Sportveranstaltung muss diese Property auf eine SportsEvent-Entität verweisen.

Eine BroadcastEvent-Entität sollte mindestens eines der folgenden Elemente enthalten:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
broadcastOfEvent.@type Text Setze diese Property auf SportsEvent.
broadcastOfEvent.@id URL Der @id der Ereignisentität. Die Ereignisentität muss im Feed vorhanden sein und ihr @id-Wert muss sich von dem von BroadcastEvent unterscheiden.
location Text oder Land Erforderlich, wenn BroadcastEvent für ein SportsEvent ist, also die Property broadcastOfEvent vorhanden ist: Das Land, in dem das zugrunde liegende SportsEvent übertragen werden kann. Dieses Feld kann eine Liste von Ländern enthalten, wenn das SportsEvent in mehreren Ländern übertragen werden kann.
videoFormat Text Die höchste unterstützte Qualität bei diesem Sendedienst, zum Beispiel
  • „SD“ für Standarddefinition.
  • „HD“ steht für High Definition.
  • „2K“ für eine 2K-Auflösung.
  • „4K“ für eine 4K-Auflösung.
  • „8K“ für eine 8K-Auflösung.
contentToBeAnnounced Boolesch Erforderlich, falls zutreffend: Verwenden Sie diese Property, wenn der Inhalt zum Zeitpunkt der Feederstellung unbekannt ist.

Legen Sie den Wert auf true fest, wenn der Anbieter keine aktuellen Informationen darüber hat, was übertragen wird, andernfalls false.
Eine BroadcastEvent-Entität sollte mindestens eines der folgenden Elemente enthalten:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
offAir Boolesch Erforderlich, sofern zutreffend: Verwenden Sie diese Property, wenn für den Zeitraum keine geplanten Inhalte übertragen werden.
Es wird dringend empfohlen, eine BroadcastEvent-Entität mindestens eine der folgenden Optionen zu enthalten:
  • workPerformed
  • broadcastOfEvent
  • Standort "contentToBeAnnounced" auf "true" gesetzt
  • Standort "offAir" auf "true" gesetzt
isLiveBroadcast Boolesch Setze den Wert auf true, wenn es sich um eine Live-Veranstaltung handelt, z. B. eine Sportveranstaltung oder ein Konzert.
potentialAction WatchAction Erforderlich, falls zutreffend: Wenn die Inhalte als Livestream-Event ohne Kanal übertragen werden (wobei contentToBeAnnounced auf false oder offAir auf false gesetzt ist), kannst du über diese Property den Deeplink der Veranstaltung angeben.
identifier PropertyValue Externe ID, die den übertragenen Inhalt identifiziert. Weitere Informationen finden Sie im Abschnitt Kennungseigenschaften.
  • Hinweis: Der Entitätstyp BroadcastEvent akzeptiert nur die propertyID-Werte TMS_ID oder TMS_ROOT_ID.
  • Dieses Attribut sollte nur in Fällen angegeben werden, in denen nicht mit der Property workPerformed oder broadcastOfEvent auf eine vollständig formulierte Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität verwiesen wird.
  • Der Wert des Attributs sollte den 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 Wert TMS_ROOT_ID bevorzugt.
contentRating Text oder Bewertung Erforderlich für Inhalte nur für Erwachsene, dringend empfohlen, ansonsten Warum? – Allgemeine Altersfreigabe des übertragenen Inhalts Wird die Altersfreigabe in Form eines Textstrings angegeben, sind zwei Variationen zulässig:
  • Die Altersfreigabestelle wurde der Bewertung mit einem Leerzeichen vorangestellt. Die Altersfreigabe „PG-13“ der Agentur „MPAA“ in den USA sollte beispielsweise als „MPAA PG-13“ beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT BEKANNT" (keine Unterscheidung zwischen Groß- und Kleinschreibung) für diesen Wert, wenn Sie die Altersfreigabe für den Film nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn in contentRating Rating verwendet wird: Name der Agentur.
contentRating.ratingValue Text Erforderlich, wenn für contentRating Rating verwendet wird: Das ist 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 = Fantasiegewalt, L = Sprache, S = sexuelle Inhalte, V = Gewalt.

Beispiele

Am 12. Oktober 2019 wird zwischen 21:00 und 21:30 Uhr im Fernsehsender Example TV (BroadcastService) eine TV-Folge ü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"
  }
}

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 die Inhalte, die am 12. Oktober 2019 zwischen 21:00 und 21:30 Uhr im TV-Netzwerk Beispiel-TV (BroadcastService) übertragen werden sollen, zum Zeitpunkt der Feederstellung nicht bekannt sind:

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
}

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-TV(BroadcastService) Der Kanal des Fernsehsenders ist zwischen 12:00 und 20:00 Uhr offen und überträgt zwischen 20:00 und 12:00 Uhr eine Sendung mit dem Namen My favorite show:

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

}

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 Themen mit Bezug auf diese Properties: