Eigenschaften des Inhalts-Markups von Live-TV-Veranstaltungen

In diesem Abschnitt finden Sie Details zu den Inhalts-Markup-Properties für den Entitätstyp BroadcastEvent. Weitere Informationen zur Beziehung zwischen diesen Typen findest du in den LiveTV-Ereigniskonzepten.

Tabelle mit Spezifikationen für BroadcastEvent

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP 47-Format, z. B. „en“.
@type Text Erforderlich: Muss immer auf BroadcastEvent gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Statisch: Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain 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: Der Titel der Sendung oder Veranstaltung.
description Text Die Beschreibung der Sendung oder Veranstaltung. Maximal 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 Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
publishedOn BroadcastService Sofern zutreffend erforderlich: Gib die BroadcastService-Entität an, die diese Sendung oder dieses Ereignis überträgt.

Wenn die Inhalte auf einem TV-Sender ausgestrahlt werden, ist diese Property erforderlich. Wenn die Inhalte mit keinem TV-Sender verknüpft sind, gib diese Property nicht an.
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 Sofern zutreffend erforderlich: Verwenden Sie diese Property, wenn der Inhalt zu einem der folgenden Entitätstypen gehört: Movie, TVSeries und TVEpisode.
Wir empfehlen dringend, 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 Inhalts-Entität.
broadcastOfEvent SportsEvent Falls zutreffend erforderlich: Verwende diese Property, wenn es sich bei den Inhalten um eine Live-Veranstaltung handelt:
  • Bei einem Sportereignis muss sich diese Property auf ein SportsEvent-Element beziehen.

Wir empfehlen dringend, 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 Der @id der Ereignisentität. Die Ereignisentität muss im Feed vorhanden sein und eine andere @id als BroadcastEvent haben.
location Text oder Country 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 sein, wenn das Sportereignis in mehreren Ländern übertragen wird.
videoFormat Text Die höchste Qualität, 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 Sofern zutreffend erforderlich: Verwende dieses Attribut, wenn der Inhalt zum Zeitpunkt der Erstellung des Feeds nicht bekannt ist.

Lege den Wert auf true fest, wenn der Anbieter keine aktuellen Informationen zu den ausgestrahlten Inhalten hat, andernfalls auf false.
Wir empfehlen dringend, 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 Falls zutreffend erforderlich: Verwende diese Property, wenn für den Zeitblock keine Inhalte geplant sind.
Wir empfehlen dringend, 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 Legen Sie true fest, wenn es sich um eine Liveveranstaltung handelt, z. B. eine Sportveranstaltung oder ein Konzert.
potentialAction WatchAction Falls zutreffend erforderlich: Wenn die Inhalte als kanalloses Livestreaming-Ereignis übertragen werden (contentToBeAnnounced ist auf false oder offAir auf false gesetzt) , gib mit dieser Property den Deeplink zum Ereignis an.
identifier PropertyValue Externe ID, die die übertragenen Inhalte identifiziert. Weitere Informationen finden Sie im Abschnitt ID-Attribute.
  • Hinweis: Der Entitätstyp BroadcastEvent akzeptiert nur propertyID-Werte von TMS_ID oder TMS_ROOT_ID.
  • Diese Property sollte nur angegeben werden, wenn auf eine vollständig formatierte Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität der obersten Ebene nicht über die Property workPerformed oder broadcastOfEvent verwiesen wird.
  • Der Wert der Property sollte der TMS_ID oder TMS_ROOT_ID der Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität entsprechen, auf die du idealerweise mit der Property workPerformed oder broadcastOfEvent verweisen würdest.
  • TMS_ID wird dem Wert TMS_ROOT_ID vorgezogen.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen Warum? – Allgemeine Altersfreigabe der übertragenen Inhalte. Wenn die Altersfreigabe in Form eines Textstrings angegeben ist, sind zwei Varianten zulässig:
  • Die Ratingagentur hat der Bewertung ein Leerzeichen vorangestellt. Eine Altersfreigabe von „PG-13“ der US-amerikanischen „MPAA“ sollte beispielsweise als „MPAA PG-13“ beschrieben werden. Liste der Agenturen
  • „RATING NOT KNOWN“ (NICHT KENNTN) (ohne Berücksichtigung der Groß- und Kleinschreibung), um anzugeben, dass du die Altersfreigabe für den Film nicht kennst.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Altersfreigabestelle.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Altersfreigabe.
contentRating.advisoryCode Text Der Hinweiscode für die Inhalte. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasy Violence, L = Language, S = Sexual Content, V = Violence.

Beispiele

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

{
  "@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"
  }
}
{
  "@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 auf dem Fernsehsender Beispiel-TV (BroadcastService) ausgestrahlt werden sollen, zum Zeitpunkt der Erstellung des Feeds noch nicht bekannt sind:

{
  "@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
}
{
  "@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 Sender Beispiel-TV(BroadcastService) ist zwischen 12:00 und 20:00 Uhr nicht auf Sendung und sendet zwischen 20:00 und 00:00 Uhr eine Sendung namens My favorite show:

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

}
{
  "@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: