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ć związek między tymi typami, zapoznaj się z koncepcjami dotyczącymi zdarzeń na żywo.

Tabela specyfikacji BroadcastEvent

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – 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:
  • Niepowtarzalny na całym świecie w katalogu.
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość adresu URL programu). Jest 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 identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagany – tytuł programu lub wydarzenia.
description Text Opis programu lub wydarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić teksty w różnych językach i o różnej długości.
startDate Data Wymagany – 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 nadaje ten program lub wydarzenie.

Jeśli treści są nadawane 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 podmiotu BroadcastService, który transmituje ten program lub wydarzenie.
workPerformed CreativeWork Wymagany w odpowiednich przypadkach – użyj tej właściwości, gdy treść należy do jednego z tych typów encji: Movie, TVSeries i TVEpisode.
Właściwości BroadcastEvent zalecamy dodanie co najmniej jednej z tych właściwości:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
workPerformed.@type Text Ustaw jako 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ści są związane z 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 1 z tych informacji:
  • 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 zdarzenia musi występować w pliku danych i mieć inny identyfikator @id niż element BroadcastEvent.
location Tekst lub Kraj Wymagany, jeśli BroadcastEvent jest przeznaczony dla wydarzenia sportowego, 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 transmisję wydarzenia sportowego może prowadzić wiele krajów.
videoFormat Text Najwyższa jakość obsługiwana w tej usłudze transmisji; na przykład
  • „SD” oznacza standardową rozdzielczość.
  • „HD” oznacza wysoką rozdzielczość.
  • „2K” oznacza rozdzielczość 2K.
  • „4K” dla rozdzielczości 4K.
  • „8K” dla rozdzielczości 8K.
contentToBeAnnounced Wartość logiczna Wymagany w odpowiednich przypadkach – użyj tej właściwości, jeśli treść jest nieznana w momencie tworzenia pliku danych.

Ustaw wartość true, gdy dostawca nie ma aktualnych informacji o tym, co będzie transmitowane, a w przeciwnym razie ustaw wartość false.
Zalecamy, aby element BroadcastEvent zawierał co najmniej jeden z tych atrybutów:
  • workPerformed
  • broadcastOfEvent
  • Adres true został ustawiony jako contentToBeAnnounced
  • Adres true został ustawiony jako offAir
offAir Wartość logiczna Wymagany w odpowiednich przypadkach – użyj tej właściwości, jeśli nie planujesz transmisji treści w danym przedziale czasowym.
Właściwości BroadcastEvent zalecamy dodanie co najmniej jednego 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 (oglądanie) Wymagany w odpowiednich przypadkach – jeśli treści są transmitowane jako wydarzenie transmisji na żywo bez kanału (z wartością contentToBeAnnounced false lub offAir false), użyj tej właściwości, aby podać link do wydarzenia.
identifier PropertyValue Zewnętrzny identyfikator identyfikujący treści transmisji. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
  • Uwaga: typ elementu BroadcastEvent akceptuje tylko wartości propertyID, które są równe TMS_ID lub TMS_ROOT_ID.
  • Właściwość tę należy podać tylko wtedy, gdy nie ma odwołania do w pełni ukształtowanego obiektu najwyższego poziomu Movie, TVSeries, TVEpisode lub SportsEvent za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Wartość właściwości powinna odzwierciedlać wartość TMS_ID lub TMS_ROOT_ID elementu Movie, TVSeries, TVEpisode lub SportsEvent, do którego odwołujesz się za pomocą właściwości workPerformed lub broadcastOfEvent.
  • Wartość TMS_ID jest preferowana od wartości TMS_ROOT_ID.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych, zdecydowanie zalecane w innych przypadkach Dlaczego? – Ogólna ocena treści transmisji. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja ratingowa dołączyła do oceny znak odstępu. Na przykład ocena „PG-13” przyznana przez agencję „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ącego treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w fantastyce, L = język, S = treści o podtekście seksualnym, V = przemoc.

Przykłady

12 października 2019 r. odcinek serialu jest emitowany w telewizji Example TV (BroadcastService) 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ści, które mają być nadawane w telewizji Example TV (BroadcastService) w dniach 12 października 2019 r. między 21:00 a 21:30, nie są znane w momencie utworzenia 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 Example TV(BroadcastService) nie nadaje 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"
        }
      ]
    }
  }
}

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: