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 jednostki BroadcastEvent. Aby lepiej zrozumieć relację między tymi typami, zapoznaj się z pojęciami dotyczącymi wydarzeń LiveTV.

Tabela specyfikacji BroadcastEvent

Właściwość Oczekiwany typ Opis
@context Text Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – zawsze ustawiony na BroadcastEvent.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url programu). Będzie on traktowany jako ciąg nieprzejrzysty, więc nie musi być działającym linkiem.
  • W formie ujednoliconego identyfikatora zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagane – tytuł programu lub wydarzenia.
description Text Opis programu lub wydarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić opisy w różnych językach i o różnej długości.
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ść jest transmitowana w kanale telewizyjnym, ta właściwość jest wymagana. Jeśli treść nie jest powiązana z żadnym kanałem telewizyjnym, nie podawaj tej właściwości.
publishedOn.@type Text Ustaw jako: BroadcastService.
publishedOn.@id Adres URL @id jednostki BroadcastService, która transmituje ten program lub wydarzenie.
workPerformed CreativeWork Wymagany w odpowiednich przypadkach – użyj tej właściwości, gdy treść jest jednym z tych typów elementów: Movie, TVSeries i TVEpisode.
Zdecydowanie zalecamy, aby element BroadcastEvent zawierał co najmniej jeden z tych elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
workPerformed.@type Text Ustaw wartość Movie, TVSeries lub TVEpisode.
workPerformed.@id Adres URL @id elementu treści.
broadcastOfEvent SportsEvent Wymagany w odpowiednich przypadkach – użyj tej właściwości, jeśli treść jest wydarzeniem na żywo:
  • W przypadku wydarzenia sportowego ta właściwość musi odnosić się do elementu SportsEvent.

Zdecydowanie zalecamy, aby element BroadcastEvent zawierał co najmniej jeden 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 znajdować się w pliku danych i mieć wartość @id inną niż BroadcastEvent.
location Text lub Country Wymagany, jeśli BroadcastEvent dotyczy wydarzenia sportowego, czyli ma właściwość broadcastOfEvent – kraj, w którym można transmitować wydarzenie sportowe. To pole może być listą krajów, jeśli wydarzenie sportowe może być transmitowane w wielu krajach.
videoFormat Text Najwyższa jakość obrazu obsługiwana w tej usłudze transmisji; np.
  • „SD” w przypadku standardowej rozdzielczości.
  • „HD” w przypadku wysokiej rozdzielczości.
  • „2K” w przypadku rozdzielczości 2K.
  • „4K” w przypadku rozdzielczości 4K.
  • „8K” w przypadku rozdzielczości 8K.
contentToBeAnnounced Wartość logiczna Wymagany w odpowiednich przypadkach – użyj tej właściwości, jeśli w momencie tworzenia pliku danych treść jest nieznana.

Ustaw wartość true, jeśli dostawca nie ma aktualnych informacji o tym, co będzie transmitowane, a w przeciwnym razie ustaw wartość false.
Zdecydowanie zalecamy, aby encja BroadcastEvent zawierała co najmniej jeden z tych elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
offAir Wartość logiczna Wymagane w odpowiednich przypadkach – użyj tej właściwości, jeśli w danym przedziale czasowym nie jest planowana transmisja treści.
Zdecydowanie zalecamy, aby element BroadcastEvent zawierał co najmniej jedną z tych wartości:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
isLiveBroadcast Wartość logiczna Ustaw wartość true, jeśli jest to wydarzenie na żywo, np. wydarzenie sportowe lub koncert.
potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczy – jeśli treść jest transmitowana jako wydarzenie na żywo w kanale (z wartością contentToBeAnnounced ustawioną na false lub wartością offAir ustawioną na false), użyj tej właściwości, aby podać link do wydarzenia.
identifier PropertyValue Zewnętrzny identyfikator, który identyfikuje treści nadawane. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
  • Uwaga: typ elementu BroadcastEvent akceptuje tylko wartości propertyID, czyli TMS_ID lub TMS_ROOT_ID.
  • Tę właściwość należy podać tylko w przypadkach, gdy w pełni ukształtowany 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 idealnie byłoby się odwołać za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Wartość TMS_ID jest preferowana w stosunku do wartości TMS_ROOT_ID.
contentRating Text lub Rating Wymagane w przypadku treści dla dorosłych, wysoce zalecane w innych przypadkachDlaczego? – ogólna ocena treści transmisji; Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja ratingowa poprzedzona oceną z białym znakiem między nimi. Na przykład ocena „PG-13” przyznana przez organizację „MPAA” w Stanach Zjednoczonych powinna być opisana jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (bez rozróżniania wielkości liter), aby wskazać, że nie znasz oceny filmu.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialogi, FV = przemoc w fantastycznym wydaniu, L = język, S = treści o charakterze seksualnym, V = przemoc.

Przykłady

Odcinek telewizyjny jest emitowany w sieci telewizyjnej Example TV (BroadcastService) w godzinach 21:00–21:30 12 października 2019 r.:

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) w godzinach 21:00–21:30 12 października 2019 roku, nie jest znana w momencie tworzenia pliku danych:

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

Sieć telewizyjna Example TV(BroadcastService) jest wyłączona w godzinach 12:00–20:00 i nadaje 1 program o nazwie My favorite show w godzinach 20:00–12:00:

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

Tematy związane z tymi usługami znajdziesz na tych stronach: