Właściwości znaczników treści dotyczących wydarzeń telewizyjnych na żywo

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści dla typu elementu BroadcastEvent. Aby lepiej zrozumieć relacje między tymi typami, zapoznaj się z pojęciami dotyczącymi wydarzeń LiveTV.

Tabela specyfikacji BroadcastEvent

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ustawiony na ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – zawsze ustawiony na BroadcastEvent.
@id Adres URL Wymagany – identyfikator przedziału czasowego transmisji w formacie identyfikatora URI, np. https://example.com/live/channel1/20191012T2100.
@id musi spełniać te wymagania:
  • Unikalny w skali globalnej w całym katalogu i inny niż workPerformed.@id lub broadcastOfEvent.@id (np. uwzględnij kanał/usługę i godzinę rozpoczęcia transmisji w identyfikatorze URI)
  • statyczny – identyfikator powinien być stały i nie powinien się zmieniać; Będzie on traktowany jako nieprzezroczysty ciąg znaków i nie musi być działającym linkiem.
  • W formie ujednoliconego identyfikatora zasobu (URI)
  • Domena używana dla wartości @id musi należeć do Twojej organizacji.
Ważne: nie dodawaj właściwości url do BroadcastEvent ani SportsEvent. Podaj kanoniczny element url tylko w przypadku elementu treści (Movie, TVSeries lub TVEpisode). Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagane – tytuł programu lub wydarzenia.
description Text Opis programu lub wydarzenia. Limit znaków: 300. Użyj tablicy, aby uwzględnić opisy w kilku językach (po jednym na język).
startDate Data Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 ze strefą czasową.
endDate Data Godzina zakończenia wydarzenia w formacie ISO 8601 ze strefą czasową.
publishedOn BroadcastService Wymagane w stosownych przypadkach – określ podmiot BroadcastService, który transmituje ten program lub wydarzenie.

Jeśli treści są transmitowane na kanale telewizyjnym, ta właściwość jest wymagana. Jeśli treści nie są powiązane z żadnym kanałem telewizyjnym, nie podawaj tej właściwości.
publishedOn.@type Text Ustaw jako: BroadcastService.
publishedOn.@id Adres URL @id elementu BroadcastService, który transmituje ten program lub wydarzenie.
workPerformed CreativeWork Wymagana, jeśli ma zastosowanie – użyj tej właściwości, gdy treść jest jednym z tych typów encji: Movie, TVSeries i TVEpisode.
Zdecydowanie zalecamy, aby encja BroadcastEvent zawierała co najmniej 1 z tych elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
workPerformed.@type Text Ustaw Movie, TVSeries lub TVEpisode.
workPerformed.@id Adres URL @id elementu treści.
broadcastOfEvent SportsEvent Wymagane w odpowiednich przypadkach – użyj tej właściwości, jeśli treści są wydarzeniem na żywo:
  • W przypadku wydarzenia sportowego ta właściwość musi odnosić się do elementu SportsEvent.

Zdecydowanie zalecamy, aby encja BroadcastEvent zawierała co najmniej 1 z tych elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
broadcastOfEvent.@type Text Ustaw jako: SportsEvent.
broadcastOfEvent.@id Adres URL @id elementu zdarzenia. Element wydarzenia musi istnieć w pliku danych i mieć wartość @id inną niż BroadcastEvent.
location Tekst lub Kraj Wymagane, jeśli BroadcastEvent dotyczy SportsEvent, czyli ma właściwość broadcastOfEvent – kraj, w którym można transmitować wydarzenie sportowe. To pole może zawierać listę krajów, jeśli wydarzenie sportowe może być transmitowane w kilku krajach.
videoFormat Text Najwyższa jakość obsługiwana w tej usłudze nadawczej, na przykład:
  • „SD” w przypadku standardowej rozdzielczości.
  • „HD” – wysoka rozdzielczość.
  • „2K” w przypadku rozdzielczości 2K.
  • „4K” w przypadku rozdzielczości 4K.
  • „8K” w przypadku rozdzielczości 8K.
contentToBeAnnounced Wartość logiczna Wymagane, jeśli dotyczy – użyj tej właściwości, jeśli treść jest nieznana w momencie tworzenia pliku danych.

Ustaw wartość true, jeśli dostawca nie ma aktualnych informacji o tym, co będzie transmitowane, lub false w przeciwnym razie.
Zdecydowanie zalecamy, aby element BroadcastEvent zawierał co najmniej 1 z tych właściwości:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
offAir Wartość logiczna Wymagany w odpowiednich przypadkach – ustaw wartość true, jeśli w danym przedziale czasowym nie ma zaplanowanej transmisji treści na kanale BroadcastService.
  • Ustaw name i description na "Off Air".
  • Każdy element offAir BroadcastEvent musi obejmować maksymalnie 4 godziny (nie emituj 24-godzinnych bloków ciągłych). Jeśli kanał nie nadaje przez ponad 4 godziny, wyemituj kilka ciągłych, nienakładających się elementów BroadcastEvent, z których każdy trwa maksymalnie 4 godziny, aby kanał zachował pełny harmonogram 24/7 bez przerw na początku lub na końcu okna kanału.
Zdecydowanie zalecamy, aby encja BroadcastEvent zawierała co najmniej 1 z tych elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
isLiveBroadcast Wartość logiczna Jeśli ta emisja jest transmisją na żywo (np. meczem sportowym lub wiadomościami na żywo), podaj wartość logiczną true (bez cudzysłowu). W przypadku programów, które nie są transmitowane na żywo, oraz powtórek podaj wartość false.
potentialAction WatchAction (oglądanie) Wymagany w odpowiednich przypadkach – nigdy nie podawaj elementu potentialAction w elemencie BroadcastEvent, gdy element broadcastOfEvent odwołuje się do elementu SportsEvent (umieść wszystkie precyzyjne linki do sportu w elemencie SportsEvent.potentialAction) lub gdy element publishedOn odwołuje się do kanału BroadcastService (umieść precyzyjne linki do kanału w elemencie BroadcastService.potentialAction). Podaj element BroadcastEvent.potentialAction tylko w przypadku transmisji na żywo bez kanału, które nie odwołują się do elementu SportsEvent (takich jak samodzielne treści dodatkowe na żywo z pominiętymi elementami contentToBeAnnounced i offAir lub elementem false).
identifier PropertyValue Zewnętrzny identyfikator, który identyfikuje transmitowane treści. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
  • Uwaga: typ elementu BroadcastEvent akceptuje tylko wartości propertyID równe TMS_ID lub TMS_ROOT_ID.
  • Tę właściwość należy podać tylko w przypadkach, gdy w pełni uformowany element najwyższego poziomu Movie, TVSeries, TVEpisode lub SportsEvent nie jest przywoływany za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Wartość właściwości powinna odzwierciedlać TMS_ID lub TMS_ROOT_ID elementu Movie, TVSeries, TVEpisode lub SportsEvent, do którego najlepiej odwołać się za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Wartość TMS_ID jest preferowana nad wartością TMS_ROOT_ID.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych, w pozostałych przypadkach zdecydowanie zalecane Dlaczego? - Ogólna ocena treści transmisji. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja oceniająca jest dodawana przed oceną i oddzielona od niej spacją. Na przykład ocena „PG-13” od agencji „MPAA” w Stanach Zjednoczonych powinna być opisana jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana) wskazująca, że nie znasz oceny filmu.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczącego treści. Akceptowane wartości to D, FV, L, S i V. D = dialogi, FV = przemoc w świecie fantastycznym, L = język, S = treści o charakterze seksualnym, V = przemoc.

Przykłady

Odcinek serialu jest emitowany w sieci telewizyjnej Example TV (BroadcastService) 12 października 2019 r. między 21:00 a 21:30:

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

Przykład pokazujący użycie właściwości contentToBeAnnounced, gdy treść, która ma być transmitowana w sieci telewizyjnej Example TV (BroadcastService) między 21:00 a 21:30 12 października 2019 r., nie jest znana w momencie tworzenia pliku danych:

BroadcastEvent 

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

Kanał sieci telewizyjnej Example TV (BroadcastService) nie nadaje między 12:00 a 20:00 (modelowane jako 2 przylegające 4-godzinne bloki Off Air) i nadaje 1 program o nazwie My favorite show między 20:00 a 24:00:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16: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",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16: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/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "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"
        }
      ]
    }
  }
}

Tematy związane z tymi właściwościami znajdziesz na tych stronach: