Eigenschaften des Inhalts-Markups von Live-TV-Veranstaltungen

In diesem Abschnitt finden Sie Details zu den Eigenschaften der Inhaltsauszeichnung für den Entitätstyp BroadcastEvent. Weitere Informationen zum Zusammenhang zwischen diesen Typen finden Sie unter Live-TV-Ereignisse.

Spezifikationstabelle für BroadcastEvent

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Ersetzen Sie xx durch den Sprachcode der Einheit 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:
  • Global eindeutig in Ihrem Katalog
  • 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 Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Der Titel der Show oder des Events.
description Text Die Beschreibung der Sendung oder des Ereignisses. Max. 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
startDate Datum Erforderlich: Die Startzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
endDate Datum Die Endzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
publishedOn BroadcastService Erforderlich, falls zutreffend: Gib die BroadcastService-Einheit an, die diese Sendung oder dieses Event ausstrahlt.

Wenn die Inhalte auf einem Fernsehsender ausgestrahlt werden, ist diese Property erforderlich. Wenn die Inhalte nicht mit einem Fernsehsender 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 Erforderlich, falls zutreffend: Verwenden Sie 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 eine der folgenden Angaben 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 Inhaltseinheit.
broadcastOfEvent SportsEvent Erforderlich, falls zutreffend: Verwenden Sie diese Property, wenn es sich bei den Inhalten um ein Live-Event handelt:
  • Bei einem Sportereignis muss sich diese Property auf ein SportsEvent-Element 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 eine @id haben, die sich von der von BroadcastEvent unterscheidet.
location Text oder Country Erforderlich, wenn BroadcastEvent für ein SportsEvent gilt, d.h. die Property broadcastOfEvent enthält: Das Land, in dem das zugrunde liegende SportsEvent übertragen werden kann. Dieses Feld kann eine Liste von Ländern sein, wenn das Sport-Event in mehreren Ländern übertragen werden kann.
videoFormat Text Die höchste auf diesem Broadcast-Dienst unterstützte Qualitätsdefinition, 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: Verwenden Sie dieses Attribut, wenn der Inhalt zum Zeitpunkt der Erstellung des Feeds unbekannt ist.

Legen Sie true fest, wenn der Bereitsteller keine aktuellen Informationen dazu hat, was gesendet wird, andernfalls 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: Verwenden Sie diese Property, wenn für den Zeitraum keine geplanten Inhalte übertragen werden.
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 Auf true setzen, wenn es sich um ein Live-Event handelt, z. B. eine Sportveranstaltung oder ein Konzert.
potentialAction WatchAction Erforderlich, falls zutreffend: Wenn die Inhalte als Channel-less-Livestreaming-Event übertragen werden (contentToBeAnnounced ist auf false gesetzt oder offAir ist auf false gesetzt), geben Sie mit dieser Eigenschaft den Deeplink des Events an.
identifier PropertyValue Externe ID, die den Broadcast-Inhalt identifiziert. Weitere Informationen finden Sie im Abschnitt Kennzeichnungsattribute.
  • Hinweis: Der Entitätstyp BroadcastEvent akzeptiert nur propertyID-Werte von TMS_ID oder TMS_ROOT_ID.
  • Diese Property sollte nur in Fällen angegeben werden, in denen nicht mit der Property workPerformed oder broadcastOfEvent auf eine vollständig formatierte Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität auf oberster Ebene verwiesen wird.
  • Der Wert der Property sollte die TMS_ID oder TMS_ROOT_ID der Movie-, TVSeries-, TVEpisode- oder SportsEvent-Entität widerspiegeln, auf die idealerweise mit der workPerformed- oder broadcastOfEvent-Property verwiesen wird.
  • TMS_ID wird dem Wert TMS_ROOT_ID vorgezogen.
contentRating Text oder Altersfreigabe Für Inhalte für Erwachsene erforderlich, ansonsten dringend empfohlen Warum? – Gesamte Altersfreigabe der Sendungsinhalte. Wenn die Altersfreigabe als Textstring angegeben wird, sind zwei Varianten zulässig:
  • Die Ratingagentur wird dem Rating mit einem Leerzeichen vorangestellt. Beispiel: Die Altersfreigabe „PG-13“ der MPAA in den USA sollte als „MPAA PG-13“ angegeben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht beachtet) gibt an, dass Sie die Altersfreigabe für den Film nicht kennen.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Ratingagentur.
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 (Gewalt in der Fantasie), L = Language (Sprache), S = Sexual Content (Sexuelle Inhalte), V = Violence (Gewalt).

Beispiele

Eine TV-Folge wird am 12. Oktober 2019 zwischen 21:00 und 21:30 Uhr auf dem 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 des Attributs contentToBeAnnounced, wenn der Inhalt, der am 12. Oktober 2019 zwischen 21:00 und 21:30 Uhr im Fernsehsender Example TV (BroadcastService) ausgestrahlt werden soll, zum Zeitpunkt der Erstellung des Feeds noch nicht bekannt ist:

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

Fernsehsender Example TV(BroadcastService) Der Sender ist zwischen 12:00 und 20:00 Uhr nicht auf Sendung und strahlt zwischen 20:00 und 24: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”,
   "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"
        }
      ]
    }
  }
}

Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten: