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

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

Podanie wartości TVSeason jako pełnego elementu jest opcjonalne. Szczegółowe informacje znajdziesz w sekcji Relacje między elementami TVSeries, TVSeason i TVEpisode.

Tabela specyfikacji

TVSeries

Właściwość	Oczekiwany typ	Opis
@context	Text	Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}] . Gdzie „xx” oznacza język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type	Text	Wymagany – 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 w katalogu; Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url serialu). 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.
url	Adres URL	Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google. url musi spełniać te wymagania: url musi być globalnie niepowtarzalny url musi zawierać działający kanoniczny adres URL, który Google może zindeksować. Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name	Text	Wymagany: nazwa programu. Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków. Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR	Text	Zdecydowanie zalecane (dlaczego?) – identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie film lub program telewizyjny. Na przykład identyfikator titleEIDR serialu TV o nazwie „Gra o tron” to „10.5240/C1B5-3BA1-8991-A571-8472-W”.
potentialAction	WatchAction (oglądanie)	Wymagany w odpowiednich przypadkach – obiekt znaczników działania zawierający szczegóły działania. Jeśli treści są dostępne w ramach usługi wideo na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników działania musi zawierać link do treści. Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna; powiązany element BroadcastService zawiera link do kanału. TVSeries może być dostępny zarówno w przypadku VoD, jak i LiveTV. Aby określić różne precyzyjne linki w różnych regionach, użyj tablicy. Zobacz przykład dotyczący wielu regionów i języków.
sameAs	Adres URL	Zdecydowanie zalecane (dlaczego?) Adres URL strony referencyjnej, która może zidentyfikować program, np. jego stronę w Wikipedii. Musi się różnić od właściwości url.
inLanguage	Text	Język oryginalny serialu w formacie BCP 47.
genre	Text	uporządkowana lista wszystkich odpowiednich gatunków. Przykład : ["Action", "Fashion", "Environment", "Football"]
keywords	Text	Słowa kluczowe lub tagi używane do opisania tych treści. Dozwolony jest też tablica słów kluczowych. Na przykład [„feature, biography”] może być tablicą zawierającą słowa kluczowe opisujące treści.
releasedEvent	PublicationEvent, FeaturedEvent lub ExclusiveEvent	Zdecydowanie zalecane (dlaczego?) – PublicationEvent służy do określenia pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, np. pierwotna data premiery filmu w kinach. Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, wyróżnione, specjalne itp. ExclusiveEvent wskazuje, że Twoja usługa ma wyłączne prawa do dystrybucji i określa, gdzie i kiedy można je wykorzystać. Zobacz szczegóły i przykłady w sekcji z przykładami.
releasedEvent.@type	Text	Wymagany – zawsze ustawiaj tę właściwość na jedną z tych wartości: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Kraj	Wymagane – regiony powiązane z tym wydarzeniem. W przypadku PublicationEvent jest to region, w którym treści zostały opublikowane. W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są wyróżnione lub dostępne wyłącznie. Użyj kodów ISO 3166 dla krajów. Aby wskazać wszystkie miejsca na świecie, ustaw wartość EARTH.
releasedEvent.startDate	Date lub DateTime	Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu. W przypadku PublicationEvent oznacza to datę premiery tego elementu, np. datę premiery filmu w kinach. W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny wyłącznie w danym miejscu lub jako element polecany.
releasedEvent.endDate	Date lub DateTime	Zalecane – wymagane 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 ostatnia data, w której dostawca wyświetla element. Jeśli treści są stale dostępne lub są wyróżnione, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy	Organization lub Person	Opcjonalnie – organizacja lub osoba, która opublikowała tę jednostkę.
description	Text	Zdecydowanie zalecane (dlaczego?) streszczenie programu. Zamiast streszczenia faktów lepiej użyć streszczenia fabuły. Limit 300 znaków. Użyj tablicy, aby oznaczyć opis w kilku językach. Zobacz przykład dotyczący wielu regionów i języków.
actor	Person lub PerformingGroup lub PerformanceRole	Zdecydowanie zalecane (dlaczego?) tablica z aktorami występującymi w serialu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director	Person	Zdecydowanie zalecane (dlaczego?) Reżyser lub reżyserzy programu.
producer	Organization lub Person	Zdecydowanie zalecane (dlaczego?) Producenci programu.
image	ImageObject	Wymagany w przypadku Google TV – obrazy związane z serią. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w artykule Właściwości obrazu.
trailer.description	Text	Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage	Text	Język zwiastuna w formacie BCP 47.
trailer.url	Adres URL	Adres URL zwiastuna opublikowanego publicznie i przesłanego przez odpowiednie studia produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed	Miejsce	Regiony, w których multimedia są dozwolone. Jeśli nie określisz ich, założymy, że są dozwolone wszędzie. Określ kraje w formacie ISO 3166.
identifier	PropertyValue	Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator jednoznacznie identyfikujący ten podmiot. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.
popularityScore	PopularityScoreSpecification	Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia odtwarzać dla użytkowników. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type	Text	Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value	Number	Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność.
popularityScore.eligibleRegion	Kraj	Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH).
review	Opinia	Sprawdź oceny serialu telewizyjnego.
review.reviewRating	Ocena	Wymagany, jeśli podano wartość review służy do określenia oceny w opinii.
contentRating	Tekst lub Ocena	Wymagany w przypadku treści dla dorosłych, a w innych przypadkach zdecydowanie zalecany – ogólna ocena treści. 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 „TV-MA” agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji. wartość „RATING NOT KNOWN” (niezależnie od wielkości liter), aby wskazać, że nie znasz oceny treści;
contentRating.author	Organizacja	Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Lista akceptowanych agencji oceniających znajduje się na stronie Agencje oceniające treści.
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.

TVEpisode

Właściwość	Oczekiwany typ	Opis
@context	Text	Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}] . Gdzie „xx” oznacza język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type	Text	Wymagany – 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 w katalogu; Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url serialu). 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.
url	Adres URL	Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google. url musi spełniać te wymagania: url musi być globalnie niepowtarzalny url musi zawierać działający kanoniczny adres URL, który Google może zindeksować. Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name	Text	Wymagany – nazwa odcinka. Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład reprezentowania wielu języków. Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR	Text	Zdecydowanie zalecane (dlaczego?) – identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie film lub program telewizyjny. Na przykład identyfikator titleEIDR pierwszego odcinka pierwszego sezonu serialu TVSeries o nazwie „Game of Thrones” to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”.
editEIDR	Text	Zdecydowanie zalecane (dlaczego?) – EIDR (Entertainment Identifier Registry) odpowiadający konkretnej wersji filmu lub programu telewizyjnego. Na przykład pierwszy odcinek pierwszego sezonu serialu TVSeries o identyfikatorze titleEIDR „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X” ma jedną wersję, np. „10.5240/FB97-C847-2969-D0AB-ECD1-C”. Właściwość titleEIDR jest wymagana, gdy podano editEIDR.
inLanguage	Text	Język oryginalny serialu w formacie BCP 47.
episodeNumber	Liczba całkowita	Wymagane – numer określający pozycję tego odcinka w kolejności odcinków w sezonie. episodeNumber muszą być ponownie uruchamiane w przypadku każdego sezonu, czyli pierwszy odcinek każdego sezonu musi mieć wartość 1.
partOfSeason	TVSeason	Wymagany: sezon telewizyjny, do którego należy ten odcinek. Nawet jeśli element TVEpisode nie ma odpowiadającego mu elementu TVSeason, musisz podać właściwości partOfSeason.@id i partOfSeason.seasonNumber. Aby obejść ten problem: Weź partofSeries.@id (np. http://www.example.com/mój_ulubiony_serial) i dołącz do niego pole zapytania z miejscem do wstawienia zapytania zastępczego (np. ?sezon1), aby utworzyć unikalny adres partOfSeason.@id (np. http://www.example.com/mój_ulubiony_serial?sezon1). Ustaw wartość partOfSeason.seasonNumber na 1.
partOfSeason.@type	Text	Wymagany – zawsze ma wartość TVSeason.
partOfSeason.@id	Adres URL	Wymagany – @id TVSeason, którego ten odcinek jest częścią.
partOfSeason.seasonNumber	Liczba całkowita	Wymagane – numer określający pozycję tego sezonu w kolejności sezonów w serialu telewizyjnym.
partOfSeries	TVSeries	Wymagany: serial telewizyjny, do którego należy ten odcinek.
partOfSeries.@type	Text	Wymagany – zawsze ma wartość TVSeries.
partOfSeries.@id	Adres URL	Wymagany – @id TVSeries, którego ten odcinek jest częścią.
partOfSeries.name	Text	Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs	Text	Adres URL strony referencyjnej, która może zidentyfikować program, np. jego stronę w Wikipedii. Musi się różnić od właściwości url.
potentialAction	WatchAction (oglądanie)	Wymagany w odpowiednich przypadkach – obiekt znaczników działania zawierający szczegóły działania. Jeśli treści są dostępne w ramach usługi wideo na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników działania musi zawierać link do treści. Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna; powiązany element BroadcastService zawiera link do kanału. TVEpisode może być dostępny zarówno w przypadku VoD, jak i LiveTV. Aby określić różne precyzyjne linki w różnych regionach, użyj tablicy. Zobacz przykład dotyczący wielu regionów i języków.
sameAs	Zdecydowanie zalecane (dlaczego?) URL	Adres URL strony referencyjnej, która może identyfikować odcinek, np. stronę odcinka w Wikipedii. Musi się różnić 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 służy do określenia pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, np. pierwotna data premiery filmu w kinach. Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, wyróżnione, specjalne itp. ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji i określa, gdzie i kiedy. Zobacz szczegóły i przykłady w sekcji z przykładami.
releasedEvent.@type	Text	Wymagany – zawsze ustawiaj tę właściwość na jedną z tych wartości: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Kraj	Wymagane – regiony powiązane z tym wydarzeniem. W przypadku PublicationEvent jest to region, w którym treści zostały opublikowane. W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są wyróżnione lub dostępne wyłącznie. Użyj kodów ISO 3166 dla krajów. Aby wskazać wszystkie miejsca na świecie, ustaw wartość EARTH.
releasedEvent.startDate	Date lub DateTime	Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu. W przypadku PublicationEvent oznacza to datę premiery tego elementu, np. datę premiery filmu w kinach. W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny wyłącznie w danym miejscu lub jako element polecany.
releasedEvent.endDate	Date lub DateTime	Zalecane – wymagane 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 ostatnia data, w której dostawca wyświetlał element. Jeśli treści są stale dostępne lub są wyróżnione, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy	Organization lub Person	Opcjonalnie – organizacja lub osoba, która opublikowała tę jednostkę.
description	Text	Zdecydowanie zalecane (dlaczego?) streszczenie odcinka, Zamiast streszczenia faktów lepiej użyć streszczenia fabuły. Limit 300 znaków. Użyj tablicy, aby oznaczyć opis w kilku językach. Zobacz przykład reprezentowania wielu języków.
genre	Text	uporządkowana lista wszystkich odpowiednich gatunków. Przykład : ["Action", "Fashion", "Environment", "Football"]
keywords	Text	Słowa kluczowe lub tagi używane do opisania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład [„feature, biography”] może być tablicą zawierającą słowa kluczowe opisujące treści.
actor	Person lub PerformingGroup lub PerformanceRole	Zdecydowanie zalecane (dlaczego?) Tablica z aktorami występującymi w odcinku. Wskazówki dotyczące modelowania znajdziesz tutaj.
director	Person	Zdecydowanie zalecane (dlaczego?) Reżyser lub reżyserzy odcinka.
producer	Organization lub Person	Zdecydowanie zalecane (dlaczego?) Producenci sezonu.
image	ImageObject	Highly Recommended Why? for Google TV – różne obrazy związane z TVEpisode. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w artykule Właściwości obrazu.
trailer.description	Text	Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage	Text	Język zwiastuna w formacie BCP 47.
trailer.url	Adres URL	Adres URL zwiastuna hostowanego publicznie i przesłanego przez odpowiednie studia produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed	Miejsce	Regiony, w których multimedia są dozwolone. Jeśli nie określisz ich, założymy, że są dozwolone wszędzie. Określ kraje w formacie ISO 3166.
review	Opinia	Sprawdź oceny odcinka serialu telewizyjnego.
review.reviewRating	Ocena	Wymagany, jeśli podano wartość review służy do określenia oceny w opinii.
contentRating	Tekst lub Ocena	Wymagany w przypadku treści dla dorosłych, a w innych przypadkach zdecydowanie zalecany – ogólna ocena treści. 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 „TV-MA” agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji. wartość „RATING NOT KNOWN” (niezależna od wielkości liter), aby wskazać, że nie znasz oceny treści;
contentRating.author	Organizacja	Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Lista akceptowanych agencji oceniających znajduje się na stronie Agencje oceniające treści.
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.
identifier	PropertyValue	Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator jednoznacznie identyfikujący ten podmiot. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.
popularityScore	PopularityScoreSpecification	Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type	Text	Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value	Number	Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność.
popularityScore.eligibleRegion	Kraj	Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH).

TVSeason

Właściwość	Oczekiwany typ	Opis
@context	Text	Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}] . Gdzie „xx” oznacza język ciągów w pliku danych. Każdy kontekst elementu wyższego rzędu powinien mieć atrybutu @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type	Text	Wymagany – 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 w katalogu; Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url serialu). 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.
url	Adres URL	Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google. url musi spełniać te wymagania: url musi być globalnie niepowtarzalny url musi zawierać działający kanoniczny adres URL, który Google może zindeksować. Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name	Text	Wymagany – nazwa tego sezonu serialu. Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład reprezentowania wielu języków. Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR	Text	Zdecydowanie zalecane (dlaczego?) – identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie film lub program telewizyjny. Na przykład identyfikator titleEIDR pierwszego sezonu serialu TVSeries o nazwie „Gra o tron” to „10.5240/FD91-C72C-4161-FCBA-058B-1”.
seasonNumber	Liczba całkowita	Wymagane – numer określający pozycję tego sezonu w kolejności sezonów w serialu telewizyjnym.
partOfSeries	TVSeries	Wymagany – serial telewizyjny, do którego należy ten sezon.
partOfSeries.@type	Text	Wymagany – zawsze ma wartość TVSeries.
partOfSeries.@id	Adres URL	Wymagany – @id TVSeries, którego dotyczy ten sezon.
partOfSeries.name	Text	Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs	Text	Adres URL strony referencyjnej, która może zidentyfikować program, np. jego stronę w Wikipedii. Musi się różnić od właściwości url.
potentialAction	WatchAction (oglądanie)	Wymagany w odpowiednich przypadkach – obiekt znaczników działania zawierający szczegóły działania. Jeśli treści są dostępne w ramach usługi wideo na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników działania musi zawierać link do treści. Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna; powiązany element BroadcastService zawiera link do kanału. TVSeason może być dostępny zarówno w przypadku VoD, jak i LiveTV. Aby określić różne precyzyjne linki w różnych regionach, użyj tablicy. Zobacz przykład dotyczący wielu regionów i języków.
sameAs	Adres URL	Zdecydowanie zalecane (dlaczego?) Adres URL strony referencyjnej, która może zidentyfikować sezon, np. stronę sezonu w Wikipedii. Musi się różnić od właściwości url.
releasedEvent	PublicationEvent, FeaturedEvent lub ExclusiveEvent	Zdecydowanie zalecane (dlaczego?) – PublicationEvent służy do określenia pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, np. pierwotna data premiery filmu w kinach. Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, wyróżnione, specjalne itp. ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji i określa, gdzie i kiedy. Zobacz szczegóły i przykłady w sekcji z przykładami.
releasedEvent.@type	Text	Wymagany – zawsze ustawiaj tę właściwość na jedną z tych wartości: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	Kraj	Wymagane – regiony powiązane z tym wydarzeniem. W przypadku PublicationEvent jest to region, w którym treści zostały opublikowane. W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są wyróżnione lub dostępne wyłącznie. Użyj kodów ISO 3166 dla krajów. Aby wskazać wszystkie miejsca na świecie, ustaw wartość EARTH.
releasedEvent.startDate	Date lub DateTime	Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu. W przypadku PublicationEvent oznacza to datę premiery tego elementu, np. datę premiery filmu w kinach. W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny wyłącznie w danym miejscu lub jako element polecany.
releasedEvent.endDate	Date lub DateTime	Zalecane – wymagane 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 ostatnia data, w której dostawca wyświetlał element. Jeśli treści są stale dostępne lub są wyróżnione, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy	Organization lub Person	Opcjonalnie – organizacja lub osoba, która opublikowała tę jednostkę.
description	Text	Zdecydowanie zalecane (dlaczego?) streszczenie sezonu, Zamiast streszczenia faktów lepiej użyć streszczenia fabuły. Limit 300 znaków. Użyj tablicy, aby oznaczyć opis w kilku językach. Zobacz przykład reprezentowania wielu języków.
actor	[Person lub PerformingGroup lub PerformanceRole	Zdecydowanie zalecane (dlaczego?) Tablica z aktorami występującymi w danym sezonie. Wskazówki dotyczące modelowania znajdziesz tutaj.
director	Person	Zdecydowanie zalecane (dlaczego?) Tablica z reżyserami programu.
producer	Organization lub Person	Zdecydowanie zalecane (dlaczego?) Producenci sezonu.
image	ImageObject	Obrazy powiązane z sezonem telewizyjnym. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w artykule Właściwości obrazu.
genre	Text	uporządkowana lista wszystkich odpowiednich gatunków. Przykład : ["Action", "Fashion", "Environment", "Football"]
keywords	Text	Słowa kluczowe lub tagi używane do opisania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład [„feature, biography”] może być tablicą zawierającą słowa kluczowe opisujące treści.
trailer.description	Text	Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage	Text	Język zwiastuna w formacie BCP 47.
trailer.url	Adres URL	Adres URL zwiastuna hostowanego publicznie i przesłanego przez odpowiednie studia produkcyjne lub autoryzowane źródła.
trailer.regionsAllowed	Miejsce	Regiony, w których multimedia są dozwolone. Jeśli nie określisz ich, założymy, że są dozwolone wszędzie. Określ kraje w formacie ISO 3166.
identifier	PropertyValue	Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator jednoznacznie identyfikujący ten podmiot. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów.
popularityScore	PopularityScoreSpecification	Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0.
popularityScore.@type	Text	Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value	Number	Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność.
popularityScore.eligibleRegion	Kraj	Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH).
review	Opinia	Sprawdź oceny sezonu serialu telewizyjnego.
review.reviewRating	Ocena	Wymagany, jeśli podano wartość review służy do określenia oceny w opinii.
contentRating	Tekst lub Ocena	Wymagany w przypadku treści dla dorosłych, a w innych przypadkach zdecydowanie zalecany – ogólna ocena treści. 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 „TV-MA” agencji „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji. wartość „RATING NOT KNOWN” (niezależna od wielkości liter), aby wskazać, że nie znasz oceny treści;
contentRating.author	Organizacja	Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Lista akceptowanych agencji oceniających znajduje się na stronie Agencje oceniające treści.
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.

Specyfikacja użytkownika, który wykonał czynność

Właściwość actor w typach jednostek TVSeries, TVEpisode i TVSeason umożliwia podanie dodatkowych informacji o aktorach, w tym nazwy ich postaci i ról, które odgrywają w serialu telewizyjnym. W następnych sekcjach znajdziesz te same informacje wraz z kilkoma przykładami ich użycia.

Właściwość	Oczekiwany typ	Opis
actor	Person lub PerformingGroup lub PerformanceRole	Zdecydowanie zalecane (dlaczego?) : Tablica z aktorami. Użyj typu PerformanceRole, gdy znana jest rola i (opcjonalnie) imię i nazwisko postaci odgrywanej przez aktora. W tym przypadku aktor Person lub PerformingGroup jest umieszczony w obiekcie PerformanceRole. Użyj typu Person, aby wskazać poszczególnych aktorów, lub PerformingGroup, aby podać szczegóły dotyczące grupy wykonawców lub zespołu, gdy role odgrywane przez członków obsady są nieznane. Użyj tablicy do reprezentowania wielu osób, grup wykonawców lub ról w filmie.

Używanie typów Person lub PerformingGroup

Podaj te właściwości, gdy używasz typu Person lub PerformingGroup.

Właściwość	Oczekiwany typ	Opis
@type	Person lub PerformingGroup	Wymagany: zawsze ustawiaj wartość Person lub PerformingGroup.
@id	Adres URL	Zdecydowanie zalecane (dlaczego?) – identyfikator aktora lub grupy wykonawców w formacie URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania: Niepowtarzalny na całym świecie w katalogu dla każdego aktora lub zespołu. Ten identyfikator powinien być stały i nie zmieniać się w czasie. 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. Pamiętaj, że wartość @id używana w przypadku właściwości actor powinna być używana konsekwentnie w całym pliku danych. Jeśli na przykład istnieją 2 filmy z tym samym aktorem, wartość @id powinna być taka sama w obu obiektach aktora.
name	Text	Wymagany – imię i nazwisko aktora lub aktorki, członka obsady lub grupy wykonawców.
sameAs	Adres URL	Zdecydowanie zalecane (dlaczego?) – adres URL strony referencyjnej, która może identyfikować aktora lub grupę wykonawców, np. stronę aktora w Wikipedii. Musi się różnić od właściwości @id.

Używanie typu PerformanceRole

Podaj te właściwości, gdy używasz typu PerformanceRole

Właściwość	Oczekiwany typ	Opis
@type	PerformanceRole	Wymagany – zawsze ustawiany na PerformanceRole.
roleName	Text	Zdecydowanie zalecane (dlaczego?) – rola odgrywana, wykonywana lub pełniona przez członka obsady; Listę dozwolonych wartości znajdziesz tutaj.
characterName	Text	Nazwa postaci, którą odgrywa aktor lub wykonawca. Nie ustawiaj tego pola, jeśli typ aktora to PerformingGroup.
actor	Person lub PerformingGroup	Wymagany – członkowie obsady w treści, gdy używany jest typ danych Osoba; Grupa lub zespoły wykonawcze treści, gdy używany jest typ danych PerformingGroup.
actor.@type	Person lub PerformingGroup	Wymagany: zawsze ustawiaj wartość Person lub PerformingGroup.
actor.@id	Adres URL	Zdecydowanie zalecane (dlaczego?) – identyfikator wykonawcy lub grupy wykonawców w formacie URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania: Niepowtarzalny na całym świecie w katalogu dla każdego aktora lub zespołu. Ten identyfikator powinien być stały i nie zmieniać się w czasie. 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. Pamiętaj, że wartość @id używana w przypadku właściwości actor powinna być używana konsekwentnie w całym pliku danych. Jeśli na przykład istnieją 2 filmy z tym samym aktorem, wartość @id powinna być taka sama w obu obiektach aktora.
actor.name	Text	Wymagany – imię i nazwisko aktora lub aktorki, członka obsady lub grupy wykonawców.
actor.sameAs	Adres URL	Zdecydowanie zalecane (dlaczego?) – adres URL strony referencyjnej, która może identyfikować aktora lub grupę wykonawców, np. stronę aktora w Wikipedii. Musi się ona różnić od właściwości actor.@id.

Dopuszczalne nazwy ról

Te wartości wymagają, aby actor.@type było równe Person.

Wartość roleName	Opis
„Cameo”	Rola epizodyczna, zwana też cameo, to krótka rola znanej osoby w dziele sztuki.
„VoiceActor”	Wykonanie głosowe to takie, w którym wykorzystano głos aktora, ale aktor nie pojawia się na ekranie. Najczęściej występuje w animacjach, ale zdarza się też, gdy głos aktora jest podłożony pod dialog innego aktora.
„Podwójny”	Podwójnik to osoba, która zastępuje innego aktora, tak aby jej twarz nie była widoczna.
„MotionCaptureActor”	MotionCaptureActor odnosi się do osoby, która nagrywa działania aktorów i wykorzystuje te informacje do animowania cyfrowych modeli postaci w animacji 2D lub 3D.

Te wartości są zwykle akceptowane w przypadku typów Person i PerformingGroup.

Wartość roleName	Opis
„Actor”	Aktor lub aktorka to osoba, która wciela się w postać w przedstawieniu w tradycyjnym medium, jakim jest teatr, lub w nowoczesnych mediach, takich jak film, radio i telewizja.
„GuestStar”	„Gość specjalny to aktor, który wciela się w fikcyjną postać i pojawia się w jednym lub kilku odcinkach. W niektórych przypadkach gwiazda gościnna może grać ważną, powracającą postać i pojawiać się wielokrotnie w serialu, mimo że nie należy do głównej obsady. Ustaw wartość na „Gość” w przypadku, gdy aktor występuje gościnnie lub jest gościem w programie. Gościnne występy powinny być podawane tylko na poziomie odcinka, a nie dodawane na poziomie serii.
„Gość”	„Gość w programie rozrywkowym”. Pamiętaj, że „GuestStar” to rola fikcyjna, a „Guest” to niefikcyjny występ.
„Announcer”	Komentator to osoba, która wygłasza otwierające i zamykające program slajdy, przedstawia prowadzącego, uczestników lub gości specjalnych, opisuje dostępne nagrody, rozgrzewa publiczność przed nagraniem i zapewnia jej rozrywkę podczas przerw.
„Commentator”	Komentarz na żywo do gry lub wydarzenia, zwykle podczas transmisji na żywo.
„Impressionist”	Występujący w roli imitatora lub mima naśladuje dźwięki, głosy i maniery celebrytów oraz postaci z kreskówek.
„Host”	osoba, która przedstawia, prowadzi lub prowadzi programy telewizyjne, często pełniąc rolę pośrednika między programem a widzami; „Prowadzący” to zazwyczaj osoba zajmująca się tematyką faktu.
„Współgospodarz”	Osoba, która organizuje wydarzenie lub program wspólnie z innymi osobami.
„GuestHost”	Gospodarz-gość to gospodarz, który prowadzi program, zazwyczaj program typu talk show, w zastępstwie stałego gospodarza, gdy ten jest niedostępny.
„Newscaster”	Osoba, która w programie telewizyjnym informuje opinię publiczną o wiadomościach i wydarzeniach o zasięgu lokalnym, krajowym lub międzynarodowym.
„adresat”	Korespondent lub reporter na miejscu zdarzenia to zwykle dziennikarz lub komentator z czasopisma albo agent, który przekazuje raporty do gazety, radia, telewizji lub innego rodzaju firmy z odległego, często odległego miejsca.
„ShowJudge”	Sędzia to osoba, która jest często uważana za eksperta w danej dziedzinie i odgrywa rolę „sędziego”, aby oceniać uczestników, którzy biorą udział w castingu i rywalizują w programie telewizyjnym.
„Uczestnik ankietyz”	Członek panelu dyskusyjnego lub doradczego w radiu lub telewizji.
„Uczestnik”	Uczestnik konkursu lub teleturnieju to osoba, która bierze w nim udział.
„StoryNarrator”	Narrator to osoba, która coś opisuje, zwłaszcza postać, która opowiada o wydarzeniach w powieści lub poemacie narracyjnym.
„MusicalArtist”	„Wykonawcą muzycznym może być osoba, grupa lub postać fikcyjna, która regularnie występuje przed publicznością lub nagrywa utwory muzyczne lub albumy muzyczne. Kompozytorzy i autorzy tekstów powinni mieć ten typ tylko wtedy, gdy informacje o autorach danego utworu muzycznego sugerują, że są oni również wykonawcami. Ten typ może służyć do kojarzenia stałych muzyków lub grup muzycznych oraz gościnnych muzyków lub grup muzycznych z programami.

rozróżniać główną i drugoplanową rolę aktora;

Aby odróżnić główną obsadę od gościnnych lub drugoplanowych aktorów w serialu telewizyjnym, dodaj główną obsadę tylko do elementów TVSeries, a do elementów TVEpisode dodaj tylko gościnnych aktorów lub aktorów grających drugoplanowe role. Upewnij się, że główna/stała obsada nie została dodana do elementów TVEpisode.

Przykłady

Przykłady dotyczące 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

Nieznana rola

Jeśli rola aktora jest nieznana, zalecamy podanie informacji o akturze 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 użytkownika, który wykonał czynność, jest znana

Jeśli rola aktora jest znana, zalecamy podanie informacji o akturze za pomocą PerformanceRole type

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

Znane role w przypadku podzbioru aktorów

Jeśli nie znasz metadanych dotyczących roli w filmie, zalecamy podanie informacji o aktorze za pomocą typu Osoba lub PerformingGroup. W drugim przypadku, gdy te informacje są znane, użyj typu PerformanceRole. Te typy można dodawać w tym samym 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"
  }
]

Powiązane artykuły

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

• Określanie typów encji w treściach
• Zbieranie identyfikatora, adresu URL i nazwy treści
• Określanie relacji między serialem telewizyjnym, sezonem i odcinkiem telewizyjnym
• Zbieranie metadanych treści