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 zum Zusammenhang zwischen diesen Typen findest du im Artikel zu den Konzepten für 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 BCP-47-Format, z. B. „en“.
@type Text Erforderlich: muss immer auf BroadcastEvent gesetzt sein.
@id URL Erforderlich: Die ID des Inhalts im URI-Format. Beispiel: https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global in deinem Katalog einzigartig
  • Statisch; Die ID sollte immer gleich bleiben 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 von URI (Unified Resource Identifier)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen an eine 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 der Veranstaltung.
description Text Die Beschreibung der Sendung oder des Ereignisses. Limist mit 300 Zeichen Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen aufzunehmen.
startDate Datum Erforderlich: Die Startzeit des Termins im ISO 8601-Format mit Zeitzone.
endDate Datum Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
publishedOn BroadcastService Erforderlich, sofern zutreffend: Gib die BroadcastService-Entität an, über die diese Sendung oder diese Veranstaltung übertragen wird.

Wenn die Inhalte auf einem Fernsehkanal ausgestrahlt werden, ist diese Property 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 diese Veranstaltung überträgt.
workPerformed CreativeWork Erforderlich, falls zutreffend: Verwenden Sie diese Eigenschaft, wenn der Inhalt einem der folgenden Entitätstypen entspricht: Movie, TVSeries oder TVEpisode.
Es wird dringend empfohlen, eine BroadcastEvent-Entität mindestens eines der folgenden Elemente zu enthalten:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
workPerformed.@type Text Legen Sie Movie, TVSeries oder TVEpisode fest.
workPerformed.@id URL Die @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 eine @id haben, die sich von der von BroadcastEvent unterscheidet.
location Text oder Land Erforderlich, wenn BroadcastEvent für eine Sportveranstaltung vorgesehen ist, d.h. über eine broadcastOfEvent-Property verfügt: Das Land, in dem die zugrunde liegende Sportveranstaltung übertragen werden kann. Wenn die Sportveranstaltung in mehreren Ländern übertragen werden kann, kann dieses Feld eine Liste von Ländern sein.
videoFormat Text Die höchste von diesem Übertragungsdienst unterstützte Qualität Beispiel:
  • „SD“ für Standarddefinition.
  • „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 diese Property, wenn die Inhalte zum Zeitpunkt der Feederstellung unbekannt sind.

Legen Sie dazu true fest, wenn der Anbieter keine aktuellen Informationen darüber hat, was übertragen wird, andernfalls false.
Es wird dringend empfohlen, eine BroadcastEvent-Entität mindestens eines der folgenden Elemente zu verwenden:
  • 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.
Eine BroadcastEvent-Entität sollte mindestens eines der folgenden Elemente enthalten:
  • workPerformed
  • broadcastOfEvent
  • Standort „contentToBeAnnounced“ auf „true“ gesetzt
  • Standort „offAir“ auf „true“ gesetzt
isLiveBroadcast Boolesch Legen Sie true fest, 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 Live-Streaming übertragen werden und 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 Übertragungsinhalt identifiziert. Weitere Informationen finden Sie im Abschnitt Eigenschaften der Kennzeichnung.
  • Hinweis: Der Entitätstyp BroadcastEvent akzeptiert nur propertyID-Werte von TMS_ID oder TMS_ROOT_ID.
  • Dieses Attribut sollte nur angegeben werden, wenn eine vollständig formatierte übergeordnete Entität Movie, TVSeries, TVEpisode oder SportsEvent nicht mit dem Attribut workPerformed oder broadcastOfEvent referenziert wird.
  • Der Wert der Eigenschaft sollte TMS_ID oder TMS_ROOT_ID der Entität Movie, TVSeries, TVEpisode oder SportsEvent widerspiegeln, auf die Sie idealerweise mit der Eigenschaft workPerformed oder broadcastOfEvent verweisen würden.
  • TMS_ID wird dem Wert von TMS_ROOT_ID vorgezogen.
contentRating Text oder Rating Erforderlich für Inhalte nur für Erwachsene, ansonsten empfohlen Warum? – Allgemeine Inhaltseinstufung des Übertragungsinhalts Wird die Inhaltsbewertung in Form einer Zeichenfolge angegeben, sind zwei Varianten zulässig:
  • Die Rating-Agentur, die der Bewertung durch ein Leerzeichen vorangestellt wurde. Beispiel: „PG-13“ Bewertung der Agentur "MPAA" in den USA als "MPAA PG-13" beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT WISSEN" (Groß-/Kleinschreibung nicht berücksichtigend), um anzuzeigen, dass die Altersfreigabe für den Film nicht bekannt ist.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Name der Rating-Agentur.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Empfehlungscode 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

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

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 Eigenschaft contentToBeAnnounced, wenn der Inhalt im TV-Netzwerk übertragen Beispiel-TV (BroadcastService) zwischen 21:00 und 21:30 Uhr am 12. Oktober 2019 ist nicht bekannt zum Zeitpunkt der Erstellung des Feeds:

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 Beispiel-TV(BroadcastService) Kanal offen zwischen 12:00 und 20:00 Uhr übertragen und 1 Sendung namens My favorite show zwischen 8 Uhr und 12 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"
  },

}

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 im Zusammenhang mit diesen Properties: