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

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