Właściwości znaczników treści w programach telewizyjnych

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku elementów typu TVSeries, TVEpisode i TVSeason.

Podanie TVSeason jako pełnego elementu jest opcjonalne. Więcej informacji znajdziesz w sekcji dotyczącej serii TV, seriali i programów telewizyjnych.

Tabela specyfikacji

TVSeries

Właściwość Oczekiwany typ Opis
@context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
  • Gdzie „xx” oznacza język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagane – zawsze ma wartość TVSeries.
@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 katalog
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli właściwość adresu URL programu się zmienia). Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.
url musi spełniać te wymagania:
  • url musi być globalnie niepowtarzalna
  • url musi zawierać działający kanoniczny URL, który Google może indeksować.
Szczegółowe informacje o precyzyjnych linkach odtwarzania znajdziesz w opisie właściwości target obiektu urlTemplate.
name tekstowy. Wymagane – nazwa programu.
  • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
titleEIDR tekstowy. Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji.

Na przykład tytuł EIDR serialu telewizyjnego o nazwie „Gra o tron” to „10.5240/C1B5-3BA1-8991-A571-8472-W”.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanieobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w filmach na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników akcji musi zawierać precyzyjny link.
  • Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna, ponieważ powiązany element BroadcastService dostarcza precyzyjny link do kanału.
  • TVSeries może być dostępne zarówno w usługach VoD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Zdecydowanie zalecane dlaczego? Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url.
inLanguage tekstowy. Oryginalny język serii w formacie BCP 47.
genre tekstowy. Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords tekstowy. Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecane dlaczego?PublicationEvent pozwala określić oryginalne (globalne lub lokalne) wydanie treści przez wydawcę, takie jak oryginalna data premiery w kinie.

Dodatkowo użyj właściwości FeaturedEvent, aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.

ExclusiveEvent, że Twoja usługa ma wyłączne prawa do dystrybucji, oraz dołącz, gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji.
releasedEvent.@type tekstowy. Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym zdarzeniem.

W przypadku PublicationEvent jest to region, w którym opublikowano treść.

W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.

Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH.
releasedEvent.startDate Data lub DateTime Zalecanywymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.

W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu.
releasedEvent.endDate Data lub DateTime ZalecaneWymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.

W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.

Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalnie – organizacja lub osoba, która opublikowała ten element.
description tekstowy. Zdecydowanie zalecane dlaczego? Krótki opis programu. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
actor Person, PerformingGroup lub PerformanceRole Zdecydowanie zalecane dlaczego? Tablica członków obsady. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecane dlaczego? Reżyser(y) programu.
producer Organizacja lub Osoba Zdecydowanie zalecane dlaczego? Producent programu.
image ImageObject Wymagane w przypadku Google TV – obrazy związane z serią TVTV. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu.
trailer.description tekstowy. Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage tekstowy. Język zwiastuna w formacie BCP 47.
trailer.url Adres URL Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed Miejsce Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166.
identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore Specyfikacjapopularności Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością
review Review Recenzje serialu telewizyjnego
review.reviewRating Ocena Wymagany, jeśli podano review. Służy do określania oceny podanej w opinii.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
  • Agencja oceniająca dołącza na początku ocenę, rozdzielając je spacjami. Na przykład ocena „TV-MA” w agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana) wskazuje, że nie znasz oceny treści.
contentRating.author Tekst lub Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści
contentRating.ratingValue tekstowy. Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode tekstowy. Kod porad dotyczących treści. Możliwe 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.

TVEpisode

Właściwość Oczekiwany typ Opis
@context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
  • Gdzie „xx” oznacza język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagane – zawsze ma wartość TVEpisode.
@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 katalog
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli właściwość adresu URL programu się zmienia). Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.
url musi spełniać te wymagania:
  • url musi być globalnie niepowtarzalna
  • url musi zawierać działający kanoniczny URL, który Google może indeksować.
Szczegółowe informacje o precyzyjnych linkach odtwarzania znajdziesz w opisie właściwości target obiektu urlTemplate.
name tekstowy. Wymagane – nazwa odcinka.
  • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład dotyczący reprezentowania wielu języków.
  • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
titleEIDR tekstowy. Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji.

Na przykład tytuł EIDR pierwszego sezonu serialu telewizyjnego znanego jako „Gra o Tron” to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”.
editEIDR tekstowy. Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje określoną edycję lub wydanie filmu lub programu telewizyjnego.

Na przykład pierwszy odcinek pierwszego sezonu serialu telewizyjnego o nazwie „Gra o tron”, którego tytuł EIDR to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”, zawiera jedną zmianę, taką jak „10.5240/FB97-C847-2AB69-2AB69-2AB69”.

Właściwość titleEIDR jest wymagana, jeśli podano właściwość EditEIDR.
inLanguage tekstowy. Oryginalny język serii w formacie BCP 47.
episodeNumber Liczba całkowita Wymagany – liczba, która określa pozycję odcinka w kolejności odcinków. episodeNumber musi zostać ponownie uruchomiony w przypadku każdego sezonu. Oznacza to, że pierwszy odcinek każdego sezonu musi wynosić 1.
partOfSeason Sezon Wymagany – sezon serialu, do którego należy ten odcinek.

Nawet jeśli TVEpisode nie ma powiązanego elementu TVSeason, musisz podać właściwości partOfSeason.@id i partOfSeason.seasonNumber. Możesz obejść ten problem:
  • Wybierz partofSeries.@id (np. http://www.example.com/moj_ulubiony_telewizor_) i dołącz pole zapytania zastępczego (np. ?sezon1), aby utworzyć unikalne partOfSeason.@id (np. http://www.example.com/moj_ulubiony_telewizor?sezon1).
  • Ustaw partOfSeason.seasonNumber na 1.
partOfSeason.@type tekstowy. Wymagane – zawsze ma wartość TVSeason.
partOfSeason.@id Adres URL Wymagane@id z TVSeason, do których należy ten odcinek.
partOfSeason.seasonNumber Liczba całkowita Wymagany – liczba, która wskazuje pozycję sezonu w kolejności sezonów.
partOfSeries Serial telewizyjny Wymagany – serial, do którego należy ten odcinek.
partOfSeries.@type tekstowy. Wymagane – zawsze ma wartość TVSeries.
partOfSeries.@id Adres URL Wymagane@id z TVSeries, do których należy ten odcinek.
partOfSeries.name tekstowy. Wymagane – nazwa serialu telewizyjnego.
partOfSeries.sameAs tekstowy. Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanieobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w filmach na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników akcji musi zawierać precyzyjny link.
  • Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna, ponieważ powiązany element BroadcastService dostarcza precyzyjny link do kanału.
  • TVEpisode może być dostępne zarówno w usługach VoD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Zdecydowanie zalecane dlaczego? Adres URL Adres URL odniesienia do strony internetowej, na której można zidentyfikować dany odcinek. Na przykład strona egzaminacyjna w Wikipedii. Ta właściwość musi różnić się od właściwości url.
duration Czas trwania Czas trwania odcinka w formacie ISO 8601. Użyj formatu: „PT00H00M”.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecane dlaczego?PublicationEvent pozwala określić oryginalne (globalne lub lokalne) wydanie treści przez wydawcę, takie jak oryginalna data premiery w kinie.

Dodatkowo użyj właściwości FeaturedEvent, aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.

ExclusiveEvent, że Twoja usługa ma wyłączne prawa do dystrybucji, oraz dołącz, gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji.
releasedEvent.@type tekstowy. Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym zdarzeniem.

W przypadku PublicationEvent jest to region, w którym opublikowano treść.

W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.

Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH.
releasedEvent.startDate Data lub DateTime Zalecanywymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.

W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu.
releasedEvent.endDate Data lub DateTime ZalecaneWymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.

W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.

Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalnie – organizacja lub osoba, która opublikowała ten element.
description tekstowy. Zdecydowanie zalecane dlaczego? Krótki opis odcinka. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
genre tekstowy. Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords tekstowy. Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść.
actor Person, PerformingGroup lub PerformanceRole Zdecydowanie zalecane dlaczego? Tablica obsady odcinka. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecane dlaczego? Reżyser odcinka.
producer Organizacja lub Osoba Zdecydowanie zalecane dlaczego? Twórcy sezonu.
image ImageObject Zdecydowanie zalecane dlaczego? w przypadku Google TV – różne obrazy powiązane z odcinkiem serialu telewizyjnego. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu.
trailer.description tekstowy. Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage tekstowy. Język zwiastuna w formacie BCP 47.
trailer.url Adres URL Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed Miejsce Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166.
review Review Oceny dotyczące odcinka programu telewizyjnego
review.reviewRating Ocena Wymagany, jeśli podano review. Służy do określania oceny podanej w opinii.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
  • Agencja oceniająca dołącza na początku ocenę, rozdzielając je spacjami. Na przykład ocena „TV-MA” w agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana) wskazuje, że nie znasz oceny treści.
contentRating.author Tekst lub Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści
contentRating.ratingValue tekstowy. Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode tekstowy. Kod porad dotyczących treści. Możliwe 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.
identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore Specyfikacjapopularności Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością

TVSeason

Właściwość Oczekiwany typ Opis
@context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
  • Gdzie „xx” oznacza język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony odpowiedni język w formacie @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagane – zawsze ma wartość TVSeason.
@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 katalog
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli właściwość adresu URL programu się zmienia). Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.
url musi spełniać te wymagania:
  • url musi być globalnie niepowtarzalna
  • url musi zawierać działający kanoniczny URL, który Google może indeksować.
Szczegółowe informacje o precyzyjnych linkach odtwarzania znajdziesz w opisie właściwości target obiektu urlTemplate.
name tekstowy. Wymagany – nazwa tego sezonu programu telewizyjnego.
  • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład dotyczący reprezentowania wielu języków.
  • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
titleEIDR tekstowy. Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji.

Na przykład tytuł EIDR pierwszego sezonu serialu telewizyjnego o nazwie „Gra o Tron” to „10.5240/FD91-C72C-4161-FCBA-058B-1”.
seasonNumber Liczba całkowita Wymagany – liczba, która wskazuje pozycję sezonu w kolejności sezonów.
partOfSeries Serial telewizyjny Wymagany – serial, do którego należy ten sezon.
partOfSeries.@type tekstowy. Wymagane – zawsze ma wartość TVSeries.
partOfSeries.@id Adres URL Wymagany – wartość @id z TVSeries, do której należy ten sezon.
partOfSeries.name tekstowy. Wymagane – nazwa serialu telewizyjnego.
partOfSeries.sameAs tekstowy. Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanieobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w filmach na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników akcji musi zawierać precyzyjny link.
  • Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna, ponieważ powiązany element BroadcastService dostarcza precyzyjny link do kanału.
  • TVSeason może być dostępne zarówno w usługach VoD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Zdecydowanie zalecane dlaczego? Adres URL referencyjnej strony internetowej, na której można zidentyfikować sezon, na przykład strona Wikipedii dotycząca sezonu. Ta właściwość musi różnić się od właściwości url.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecane dlaczego?PublicationEvent umożliwia określenie pierwotnej (globalnej lub lokalnej) premiery treści przez wydawcę, np. pierwotna data premiery filmu w kinie.

Dodatkowo użyj właściwości FeaturedEvent, aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.

ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji.
releasedEvent.@type tekstowy. Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym zdarzeniem.

W przypadku PublicationEvent jest to region, w którym opublikowano treść.

W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.

Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH.
releasedEvent.startDate Data lub DateTime Zalecanywymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.

W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu.
releasedEvent.endDate Data lub DateTime ZalecaneWymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.

W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.

Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalnie – organizacja lub osoba, która opublikowała ten element.
description tekstowy. Zdecydowanie zalecane dlaczego? Krótki opis sezonu. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
actor [Person, PerformingGroup lub PerformanceRole Zdecydowanie zalecane dlaczego? Tablica obsady sezonu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecane dlaczego? Tablica reżyserów programu.
producer Organizacja lub Osoba Zdecydowanie zalecane dlaczego? Twórcy sezonu.
image ImageObject Zdjęcia związane z serialem telewizyjnym. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu.
genre tekstowy. Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords tekstowy. Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść.
trailer.description tekstowy. Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage tekstowy. Język zwiastuna w formacie BCP 47.
trailer.url Adres URL Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed Miejsce Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166.
identifier PropertyValue Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore Specyfikacjapopularności Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type tekstowy. Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH. Domyślnie ta właściwość ma wartość EARTH.
Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością
review Review Recenzje sezonu serialu
review.reviewRating Ocena Wymagany, jeśli podano review. Służy do określania oceny podanej w opinii.
contentRating Tekst lub Ocena Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
  • Agencja oceniająca dołącza na początku ocenę, rozdzielając je spacjami. Na przykład ocena „TV-MA” w agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana) wskazuje, że nie znasz oceny treści.
contentRating.author Tekst lub Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści
contentRating.ratingValue tekstowy. Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode tekstowy. Kod porad dotyczących treści. Możliwe 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.

Specyfikacja użytkownika

Właściwość actor typów encji TVSeries, TVEpisode i TVSeason pozwala podać więcej informacji o aktorach, w tym o ich imionach i rolach, które odgrywają w programie. W sekcjach poniżej opisano to samo, wraz z kilkoma przykładami wyjaśniającymi wykorzystanie.

Właściwość Oczekiwany typ Opis
actor Person, PerformingGroup lub PerformanceRole Zdecydowanie zalecane dlaczego? : tablica członków obsady.
  • Gdy rola jest wykonywana, i (opcjonalnie) nazwa postaci należącej do aktorów, użyj typu PerformanceRole. Aktor Person lub PerformingGroup jest w tym przypadku umieszczony w obiekcie PerformanceRole.
  • Wpisz Person, aby wskazać aktorów indywidualnych lub grupy PerformingGroup, aby podać szczegółowe informacje o grupach wykonujących działania, gdy role odgrywane przez członków obsady.

Użyj tablicy do reprezentowania wielu osób, grup wykonujących wykonania lub ról wydajności.

Typy Person lub PerformingGroup

Jeśli używasz typu Person lub PerformingGroup, podaj te właściwości

Właściwość Oczekiwany typ Opis
@type Person lub PerformingGroup Wymagany – zawsze ustawiony na Person lub PerformingGroup.
@id Adres URL Zdecydowanie zalecane dlaczego? – Identyfikator aktorów lub grupy wykonującej czynność w formacie identyfikatora URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania:
  • Ogólnoświatowa kategoria w katalogu według aktora lub grupy skuteczności
  • Identyfikator powinien być stały i nie zmieniać się w czasie. Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Twoja organizacja musi być właścicielem domeny używanej w wartości @id.

Pamiętaj, że parametr @id używany we właściwości aktora powinien być konsekwentnie używany w pliku danych. Jeśli na przykład w dwóch filmach występuje ten sam aktor, wartość @id powinna być taka sama we wszystkich tych obiektach.

name tekstowy. Wymagane – nazwa aktora, aktora, członka obsady lub grupy aktorskiej.
sameAs Adres URL Zdecydowanie zalecane dlaczego? – adres URL odniesienia do strony internetowej, na której może zostać zidentyfikowany użytkownik lub grupa wykonania, np. strona Wikipedii użytkownika. Ta właściwość musi różnić się od właściwości @id.

Użycie typu PerformanceRole

Jeśli używasz typu PerformanceRole, podaj te właściwości

Właściwość Oczekiwany typ Opis
@type Rola wydajności Wymagane – zawsze ma wartość PerformanceRole
roleName tekstowy. Zdecydowanie zalecane dlaczego? - Rola odgrywana, wykonywanej lub wypełniana przez członka obsady. Listę dopuszczalnych wartości znajdziesz tutaj.
characterName tekstowy. Imię postaci występującej w rolach aktorskich lub aktorskich. Nie ustawiaj tego pola, jeśli typ aktora to PerformingGroup.
actor Person lub PerformingGroup Wymagany
  • Członkowie obsady treści, gdy używany jest typ danych Osoba.
  • Grupy lub grupy treści, podczas gdy zastosowano typ danych PerformingGroup.
actor.@type Person lub PerformingGroup Wymagany – zawsze ustawiony na Person lub PerformingGroup.
actor.@id Adres URL Zdecydowanie zalecane dlaczego? – Identyfikator aktora lub grupy wykonującej czynność w formacie identyfikatora URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania:
  • Ogólnoświatowa kategoria w katalogu według aktora lub grupy skuteczności
  • Identyfikator powinien być stały i nie zmieniać się w czasie. Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Twoja organizacja musi być właścicielem domeny używanej w wartości @id.

Pamiętaj, że parametr @id używany we właściwości aktora powinien być konsekwentnie używany w pliku danych. Jeśli na przykład w dwóch filmach występuje ten sam aktor, wartość @id powinna być taka sama we wszystkich tych obiektach.

actor.name tekstowy. Wymagane – nazwa aktora, aktora, członka obsady lub grupy aktorskiej.
actor.sameAs Adres URL Zdecydowanie zalecane dlaczego? – adres URL odniesienia do strony internetowej, na której może zostać zidentyfikowany użytkownik lub grupa wykonania, np. strona Wikipedii użytkownika. Ta wartość musi być inna niż właściwość actor.@id.

Dopuszczalne nazwy ról

Wartości actor.@type muszą być ustawione na Person.

Wartość: roleName Opis
„Cameo” Rola epizodowa to krótka prezentacja znanej osoby w sztuce sztuk scenicznych.
„VoiceActor” Występy głosowe to akcja aktorska, która nie pojawia się na ekranie. Najczęściej pojawia się w animacji, ale pojawia się też, gdy głos aktora jest dublowany przez przemówienie innego aktora.
„Podwójna” Podwójny obraz oznacza inną osobę, która nie pokazuje twarzy.
„MotionCaptureActor” MotionCaptureActor to sytuacja, w której osoba nagrywa działania ludzi i wykorzystuje je do animowania cyfrowych modeli postaci w animacjach komputerowych 2D i 3D.

Wartości te są zwykle akceptowane w przypadku typów Person i PerformingGroup.

Wartość: roleName Opis
„Użytkownik, który wykonał czynność” Aktor to osoba, która wciela się w rolę aktora w tradycyjnej kinie lub nowoczesnych mediach, takich jak filmy, audycje radiowe czy telewizyjne.
„Gwiazda Star” „Gościnny gość to aktor, który wciela się w postać fikcyjną i pojawia się w 1 lub kilku odcinkach. W niektórych przypadkach gość może odgrywać ważną postać cykliczną i pojawia się wielokrotnie w serii, ale nie należy do głównej obsady. Ustaw wartość „Gwiazda Stara”, gdy występują obsady lub goście występują w programie. Oceny gości należy podawać tylko na poziomie odcinka, a nie na poziomie serialu.
„Gość” "Gość w talk show Pamiętaj, że „Gość Starsza” jest fikcyjnym, ale nie gości.
„Spiker” Prezenter to osoba, która wprowadza i kończy sceny programu, przedstawia gospodarza, uczestników lub celebrytów, przedstawia dostępne nagrody i zabawa widzów przed atrakcją filmową.
„Komentator” Komentator dodaje komentarz w czasie rzeczywistym o grze lub wydarzeniu, zwykle podczas transmisji na żywo.
„Impresjonista” Impresjonista lub naśladujący to twórca, którego aktorem jest imitacja dźwięków, głosów i stylów celebrytów oraz postaci z kreskówek.
„Host” Osoba, która przedstawia, prowadzi lub hostuje programy telewizyjne, często pełniąc funkcję mediatora w ramach programu i odbiorców. Rola gospodarza nie ma charakteru faktu.
„Współgospodarz” Osoba, która organizuje wydarzenie lub program wspólnie z innymi osobami.
„HostHost” Gospodarz jest gospodarzem, zwykle w ramach programu talk show, w którym zamiast zwykłego gospodarza odbywa się program.
„Newscast” Osoba, która prezentuje lub informuje o wiadomościach i wydarzeniach w lokalnej, krajowej i międzynarodowej skali działalności za pomocą programów informacyjnych.
„Korespondent” Korespondent lub osoba zajmująca się sceną znajduje się zwykle w roli reportera lub komentatora czasopisma albo agent, który publikuje artykuły w gazecie, radiu, telewizji lub innego rodzaju biznesie, często na odległość.
„Sędzia Show” Sędzia jest osobą, która często jest uznawana za specjalistę w zakresie programu. Pełni rolę sędziego i krytykuje uczestników konkursu, który weźmie udział w aukcji i bierze udział w konkursie serialu telewizyjnego.
„Panelista” uczestnik panelu dyskusyjnego lub doradczego w radiu lub telewizji.
„Konkurs” Uczestnik zawodu lub teleturnieju to osoba, która w nim uczestniczy.
„Narrator” Narracja to osoba, która coś opowiada, zwłaszcza postacia, która przeplata zdarzenia z danego wiersza lub wiersza z narracją.
„Artysta” „Wykonawcą muzycznym może być osoba, grupa lub postać fikcyjna, która zwykle występuje regularnie przed publicznością lub nagrywa utwory muzyczne albo albumy muzyczne. Kompozytorzy i tekściarze powinni tworzyć utwory tego typu tylko wtedy, gdy w informacjach o jakichś dziełach muzycznych stwierdzono, że odgrywają one główną rolę. Tego typu możesz używać do powiązania stałych muzyków lub grup muzyków oraz gościnnych muzyków lub grup muzyków do wyświetlania.

Rozróżnienie głównej i dodatkowej roli aktora

Aby odróżnić głównych, regularnych i dodatkowych gości w programie telewizyjnym, dodaj tylko główną obsadę tylko do elementów TVSeries, a do treści TVEpisode – tylko gości. Upewnij się, że podstawowe/regularne przesyłanie nie jest dodane do elementów TVEpisode.

Przykłady

Przykłady: TVSeries, TVEpisode i TVSeason

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Przykłady właściwości Actor

Rola użytkownika jest nieznana

Gdy rola aktora jest nieznana, zalecamy podanie informacji o aktorze za pomocą typu Person lub PerformingGroup.

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Rola aktora jest znana

Gdy rola użytkownika jest znana, zalecamy podanie informacji o jakimś użytkowniku, przy użyciu typu PerformanceRole.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Role znane z podzbioru aktorów

W przypadku metadanych roli wydajności zalecamy podać informacje o podmiocie, używając typu Person lub PerformingGroup W pozostałych przypadkach, gdzie informacje te są znane, wybierz typ PerformanceRole . Te typy można dodawać do tej samej tablicy.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Zajrzyj na te tematy, aby znaleźć materiały związane z tymi właściwościami: