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

Tabela specyfikacji BroadcastEvent

Właściwość Oczekiwany typ Opis
@context Tekst Wymagane – zawsze ustaw na ["http://schema.org", {"@language": "xx"}]
  • Zastąp xx kodem języka jednostki 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:
  • Unikalne globalnie w Twoim katalogu
  • Statyczny – identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Jest on traktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W postaci identyfikatora URI
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Tekst Wymagany – tytuł programu lub wydarzenia.
description Tekst Opis programu lub wydarzenia. 300-znakowy limist. Aby uwzględnić opisy w różnych językach i o długości, użyj tablicy.
startDate Data Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 i strefa czasowa.
endDate Data Godzina zakończenia wydarzenia w formacie ISO 8601 i strefa czasowa.
publishedOn BroadcastService Wymagane, jeśli ma zastosowanie – określ element BroadcastService, który nadaje ten program lub wydarzenie.

Jeśli treść jest transmitowana w 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 Wartość @id elementu BroadcastService, który nadaje ten program lub wydarzenie.
workPerformed CreativeWork Wymagane, jeśli ma zastosowanie – użyj tej właściwości, jeśli treść jest jednym z tych typów: Movie, TVSeries i TVEpisode.
Zdecydowanie zalecamy, aby element BroadcastEvent zawierał co najmniej 1 z tych 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 Wartość @id elementu treści.
broadcastOfEvent SportsEvent Wymagany, jeśli ma zastosowanie – użyj tej właściwości, jeśli treść jest wydarzeniem na żywo:
  • W przypadku wydarzenia sportowego 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 Wartość @id elementu zdarzenia. Encja zdarzenia musi istnieć w kanale, a jej parametr @id różni się od elementu BroadcastEvent.
location Tekst lub Kraj Wymagany, jeśli transmisja BroadcastEvent jest powiązana z wydarzeniem SportsEvent, czyli ma właściwość broadcastOfEvent – kraj, w którym może być transmitowane dane wydarzenie sportowe. To pole może zawierać listę krajów, jeśli transmisja sportowa może być transmitowana z wielu krajów.
videoFormat Tekst Najwyższa definicja jakości obsługiwanej przez tę usługę transmitującą, na przykład
  • „SD” dla standardowej rozdzielczości.
  • „HD” – wysoka rozdzielczość.
  • „2K” dla rozdzielczości 2K.
  • „4K” w przypadku rozdzielczości 4K,
  • „8K” dla rozdzielczości 8K.
contentToBeAnnounced Wartość logiczna Wymagane, jeśli ma zastosowanie – użyj tej właściwości, jeśli w chwili tworzenia kanału zawartość jest nieznana.

Ustaw wartość true, jeśli dostawca nie ma aktualnych informacji o tym, co będzie transmitowane. false W innym przypadku.
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 ma zastosowanie – użyj tej właściwości, jeśli w danym przedziale czasu nie ma planowanej 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 wartość true, jeśli jest to wydarzenie na żywo, np. wydarzenie sportowe lub koncert.
potentialAction WatchAction Wymagane w odpowiednich przypadkach – jeśli treść jest transmitowana w formie mniejszej transmisji wydarzenia na żywo (gdy parametr contentToBeAnnounced jest ustawiony na false lub offAir na false), użyj tej właściwości, aby podać precyzyjny link do wydarzenia.
identifier PropertyValue Zewnętrzny identyfikator, który określa transmisję. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
  • Uwaga: typ elementu BroadcastEvent akceptuje tylko wartości propertyID o wartości TMS_ID lub TMS_ROOT_ID.
  • Tę właściwość należy podawać tylko wtedy, gdy do pełnego elementu najwyższego poziomu Movie, TVSeries, TVEpisode lub SportsEvent nie odwołują się 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 byłoby się odwołać za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Parametr TMS_ID jest preferowany zamiast wartości TMS_ROOT_ID.
contentRating Text lub Rating Wymagany w przypadku treści dla dorosłych; w przeciwnym razie zdecydowanie zalecane: Dlaczego? – Ogólna ocena treści transmisji. Jeśli ocena treści jest podana w formie ciągu tekstowego, dopuszczalne są 2 warianty:
  • Agencja oceniająca dodała do oceny spację ze spacją. Na przykład ocena „PG-13” przyznana przez agencję „MPAA” w Stanach Zjednoczonych powinna być opisana jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „OCENA NIE ZNANA” (wielkość liter nie jest rozróżniana), wskazując, że nie znasz oceny danego filmu.
contentRating.author Text lub Organization Wymagane, jeśli contentRating używa Rating – nazwa agencji oceniającej.
contentRating.ratingValue Tekst Wymagane, jeśli contentRating używa Rating: wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczącej treści. Akceptowane wartości to D, FV, L, S i V. D = Dialog, FV = Przemoc fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.

Przykłady

Odcinek telewizyjny jest emitowany w sieci telewizyjnej Example TV (BroadcastService) między 21:00 a 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 użycia właściwości contentToBeAnnounced, gdy treści do transmitowania w sieci telewizyjnej Przykładowa telewizja (BroadcastService) między 21:00 a 21:30 12 października 2019 r. nie są znane w momencie tworzenia kanału:

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 Przykładowa telewizja(BroadcastService) Kanał jest wyłączony między 12:00 a 20:00 i w godzinach 20:00–12:00 nadaje 1 program o nazwie My favorite show:

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

Zapoznaj się z tymi stronami, aby poznać tematy związane z tymi usługami: