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 typu elementu BroadcastEvent. Aby lepiej zrozumieć zależności między tymi typami treści, zapoznaj się z pojęciami dotyczącymi wydarzeń na żywo.

Tabela specyfikacji BroadcastEvent

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Zastąp xx kodem języka elementu w formacie BCP 47, np. „en”.
@type Tekst Wymagane – zawsze ma wartość BroadcastEvent.
@id Adres URL Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Produkt unikalny w całym katalogu
  • statyczny; Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Tekst Wymagany – tytuł programu lub wydarzenia.
description Tekst Opis programu lub wydarzenia. Limist składający się z 300 znaków. Użyj tablicy, aby dodać opisy w różnych językach i o różnej długości.
startDate Data Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 wraz ze strefą czasową.
endDate Data Godzina zakończenia wydarzenia w formacie ISO 8601 wraz ze strefą czasową.
publishedOn BroadcastService Wymagane, jeśli dotyczy – określ podmiot BroadcastService, który transmituje ten program lub wydarzenie.

Jeśli treść jest emitowana 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 Tekst Ustaw jako: BroadcastService.
publishedOn.@id Adres URL Identyfikator @id elementu BroadcastService, który transmituje ten program lub wydarzenie.
workPerformed CreativeWork Wymagane (w stosownych przypadkach) – używaj 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 rodzajów elementów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
workPerformed.@type Tekst Ustaw jako Movie, TVSeries lub TVEpisode.
workPerformed.@id Adres URL Identyfikator @id elementu treści.
broadcastOfEvent SportsEvent Wymagane, jeśli dotyczy – 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 Tekst Ustaw jako: SportsEvent.
broadcastOfEvent.@id Adres URL Element @id elementu zdarzenia. Element zdarzenia musi występować w pliku danych i mieć element @id inny niż element BroadcastEvent.
location Text lub Country Wymagany, jeśli zdarzenie BroadcastEvent dotyczy wydarzenia SportsEvent, czyli ma właściwość broadcastOfEvent – kraj, w którym może być transmitowane dane wydarzenie SportsEvent. To pole może zawierać listę krajów, jeśli wiele krajów może transmitować wydarzenie sportowe.
videoFormat Tekst rozdzielczość o najwyższej jakości obsługiwanej przez tę usługę transmisji; na przykład
  • „SD” w przypadku rozdzielczości standardowej.
  • „HD” w wysokiej rozdzielczości.
  • „2K” który jest dostępny w rozdzielczości 2K.
  • „4K” który jest dostępny w rozdzielczości 4K.
  • „8K” który pozwala oglądać filmy w rozdzielczości 8K.
contentToBeAnnounced Wartość logiczna Wymagane – użyj tej właściwości, jeśli treść jest nieznana w momencie tworzenia kanału.

Ustaw wartość true, jeśli dostawca nie ma aktualnych informacji o transmisjach. W przeciwnym razie false.
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
offAir Wartość logiczna Wymagane, jeśli dotyczy – użyj tej właściwości, jeśli w danym przedziale czasu nie ma żadnych zaplanowanych transmisji treści.
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
isLiveBroadcast Wartość logiczna Ustaw jako true, jeśli to jest wydarzenie na żywo. na przykład wydarzenie sportowe lub koncert.
potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczy – jeśli treść jest transmitowana na kanale bez transmisji na żywo (gdy contentToBeAnnounced ma wartość false lub offAir jest ustawiona na false), użyj tej właściwości, aby podać precyzyjny link do wydarzenia.
identifier PropertyValue Zewnętrzny identyfikator określający transmitowaną treść. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
  • Uwaga: typ elementu BroadcastEvent akceptuje tylko wartości propertyID dla TMS_ID lub TMS_ROOT_ID.
  • Tę właściwość należy podawać tylko wtedy, gdy za pomocą właściwości workPerformed lub broadcastOfEvent nie odwołuje się do pełnej formy elementu Movie, TVSeries, TVEpisode lub SportsEvent najwyższego poziomu.
  • Wartość właściwości powinna odzwierciedlać TMS_ID lub TMS_ROOT_ID elementu Movie, TVSeries, TVEpisode lub SportsEvent, do którego w miarę możliwości należałoby się odwoływać za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Preferowany jest TMS_ID zamiast wartości TMS_ROOT_ID.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych, a w przeciwnym razie zdecydowanie zalecane Dlaczego? – Ogólna ocena treści transmitowanych treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptujemy 2 odmiany:
  • Agencja oceniająca została dodana do oceny ze spacją pomiędzy. Przykład: „PG-13” ocena agencji „MPAA” w USA powinna być oznaczona jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana), aby wskazać, że nie znasz oceny filmu.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej.
contentRating.ratingValue Tekst Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w świecie fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.

Przykłady

Odcinek 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 użycia właściwości contentToBeAnnounced, gdy treść ma być transmisja w sieci telewizyjnej Example TV (BroadcastService) między 21:00 a 21:30 12 października 2019 r. jest nieznana 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"
        }
      ]
    }
  }
}

Kanał sieci telewizyjnej Przykładowy telewizor(BroadcastService) jest niedostępny między 12:00 a 20:00, transmisja: 1 program o nazwie My favorite show między 20:00 0: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"
        }
      ]
    }
  }
}

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: