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 dla typów elementów TVSeries, TVEpisode i TVSeason.

Podanie TVSeason jako pełnego podmiotu jest opcjonalne. Szczegółowe informacje znajdziesz w sekcji Relacje między serialami, sezonami i odcinkami.

Tabela specyfikacji

TVSeries

Właściwość Oczekiwany typ Opis
@context Text Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie „xx” oznacza język ciągów tekstowych w pliku danych. Każdy kontekst jednostki głównej powinien mieć ustawiony atrybut @language na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, nazwy są traktowane jako hiszpańskie, nawet jeśli język napisów lub dubbingu to angielski.
@type Text Wymagany – zawsze ustawiony na TVSeries.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url programu). Będzie 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 identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny adres URL treści, którego Google używa do dopasowywania treści w Twoim pliku danych do treści w bazach 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ć.
W przypadku precyzyjnego linku do odtwarzania zamiast tego użyj właściwości urlTemplate obiektu target.
name Text Wymagany – nazwa programu.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego języka i kraju można podać tylko jedną nazwę.
titleEIDR Text Zdecydowanie zalecamy Dlaczego? – Identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie dzieło filmowe lub telewizyjne.

Na przykład identyfikator EIDR tytułu serialu „Gra o tron” to „10.5240/C1B5-3BA1-8991-A571-8472-W”.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanie – obiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w usłudze wideo na żądanie (VoD), ta właściwość jest wymagana. Obiekt znacznika działania musi zawierać link bezpośredni do treści.
  • Jeśli treść jest dostępna na kanale LiveTV, ta właściwość jest opcjonalna. Powiązany podmiot BroadcastService udostępnia zamiast niej link do kanału.
  • TVSeries może być dostępny zarówno w przypadku treści VOD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Zdecydowanie zalecamy Dlaczego? Adres URL referencyjnej strony internetowej, która może identyfikować program, np. strona programu w Wikipedii. Musi się różnić od właściwości url.
inLanguage Text Zdecydowanie zalecane: oryginalny język serialu w formacie BCP 47.
genre Text Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Text Słowa kluczowe lub tagi używane do opisywania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład ["feature, biography"] może być tablicą słów kluczowych opisujących treść.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecamy Dlaczego? – PublicationEvent służy do określania pierwotnej (globalnej lub lokalnej) publikacji treści przez wydawcę, np. pierwotnej daty premiery filmu w kinach.

Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, polecane, specjalne itp.

ExclusiveEvent oznacza, że Twoja usługa ma wyłączne prawa do dystrybucji, i zawiera informacje o tym, gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w sekcji z przykładami.
releasedEvent.@type Text Wymagane – 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 opublikowano treści.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są promowane lub dostępne na wyłączność.

W przypadku krajów używaj kodów ISO 3166. Aby wskazać cały świat, ustaw wartość EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza to datę pierwszej publikacji elementu, np. datę pierwszej premiery filmu w kinach.

W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny na wyłączność lub wyróżniony.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent oznacza datę wygaśnięcia praw do treści.

W przypadku FeaturedEvent oznacza ostatnią datę, w której dostawca prezentuje podmiot.

Jeśli treści są na stałe dostępne na wyłączność lub prezentowane, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organization lub Person Opcjonalnie – organizacja lub osoba, która opublikowała ten podmiot.
description Text Zdecydowanie zalecamy Dlaczego? streszczenie programu, Preferowane są streszczenia fabuły, a nie podsumowania faktów. Limit 300 znaków.
actor Person lub PerformingGroup lub PerformanceRole Zdecydowanie zalecamy Dlaczego? Tablica z członkami obsady serialu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecamy Dlaczego? Reżyser lub reżyserzy programu.
producer Organization lub Person Zdecydowanie zalecamy Dlaczego? Producent lub producenci programu.
image ImageObject Wymagane w Google TV – obrazy związane z serialem. Więcej informacji o właściwościach wymaganych i opcjonalnych, które należy uwzględnić w przypadku image, znajdziesz w sekcji Właściwości obrazu.
trailer.description Text Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage Text Zdecydowanie zalecane. 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 żadnych krajów, założymy, że film jest dozwolony wszędzie. Określ kraje w formacie ISO 3166.
identifier PropertyValue Zdecydowanie zalecamy Dlaczego? – Zewnętrzny lub inny identyfikator, który jednoznacznie określa ten podmiot. Dozwolonych jest kilka identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Zdecydowanie zalecamy Dlaczego? Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane dla użytkowników. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0.
popularityScore.@type Text Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość 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 Sprawdzanie ocen serialu
review.reviewRating Ocena Wymagany, jeśli podano wartość review. Służy do określania oceny przyznanej w opinii.
contentRating Text lub Rating Wymagane w przypadku treści dla dorosłych, wysoce zalecane w innych przypadkach – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja ratingowa poprzedzona oceną z białym znakiem między nimi. Na przykład ocena „TV-MA” przyznana przez agencję „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie ma znaczenia), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Listę akceptowanych organizacji oceniających znajdziesz na stronie Organizacje oceniające treści.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialogi, FV = przemoc w fantastycznym wydaniu, L = język, S = treści o charakterze seksualnym, V = przemoc.

TVEpisode

Właściwość Oczekiwany typ Opis
@context Text Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie „xx” oznacza język ciągów tekstowych w pliku danych. Każdy kontekst jednostki głównej powinien mieć ustawiony atrybut @language na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, nazwy są traktowane jako hiszpańskie, nawet jeśli język napisów lub dubbingu to angielski.
@type Text Wymagany – zawsze ustawiony na TVEpisode.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url programu). Będzie 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 identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny adres URL treści, którego Google używa do dopasowywania treści w Twoim pliku danych do treści w bazach 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ć.
W przypadku precyzyjnego linku do odtwarzania zamiast tego użyj właściwości urlTemplate obiektu target.
name Text Wymagany – nazwa odcinka.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Reprezentacja w wielu językach.
  • Pamiętaj, że w przypadku każdego języka i kraju można podać tylko jedną nazwę.
titleEIDR Text Zdecydowanie zalecamy Dlaczego? – Identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie dzieło filmowe lub telewizyjne.

Na przykład identyfikator EIDR tytułu pierwszego odcinka pierwszego sezonu serialu „Gra o tron” to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”.
editEIDR Text Zdecydowanie zalecamy Dlaczego? – Identyfikator EIDR (Entertainment Identifier Registry) reprezentujący konkretną wersję lub wydanie filmu lub programu telewizyjnego.

Na przykład pierwszy odcinek pierwszego sezonu serialu „Gra o tron”, którego identyfikator EIDR to „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 podana jest wartość editEIDR.
inLanguage Text Zalecane: oryginalny język odcinka w formacie BCP 47.
episodeNumber Liczba całkowita Wymagany – liczba wskazująca pozycję odcinka w kolejności odcinków w sezonie. episodeNumber trzeba ponownie uruchamiać w każdym sezonie, tzn. pierwszy odcinek każdego sezonu musi mieć numer 1.
partOfSeason TVSeason Wymagany – sezon serialu telewizyjnego, do którego należy ten odcinek.

Nawet jeśli TVEpisode nie ma odpowiedniego TVSeason, musisz podać właściwości partOfSeason.@id i partOfSeason.seasonNumber. Obejście:
  • Weź adres partofSeries.@id (np. http://www.example.com/moj_ulubiony_serial) i dołącz do niego pole zapytania z symbolem zastępczym (np. ?sezon1), aby utworzyć unikalny adres partOfSeason.@id (np. http://www.example.com/moj_ulubiony_serial?sezon1).
  • Ustaw wartość partOfSeason.seasonNumber na 1.
partOfSeason.@type Text Wymagany – zawsze ustawiony na TVSeason.
partOfSeason.@id Adres URL Wymagany – @id TVSeason, którego częścią jest ten odcinek.
partOfSeason.seasonNumber Liczba całkowita Wymagany – liczba wskazująca pozycję tego sezonu w kolejności sezonów serialu.
partOfSeries TVSeries Wymagany – serial telewizyjny, do którego należy ten odcinek.
partOfSeries.@type Text Wymagany – zawsze ustawiony na TVSeries.
partOfSeries.@id Adres URL Wymagany – @id TVSeries, którego częścią jest ten odcinek.
partOfSeries.name Text Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs Text Adres URL referencyjnej strony internetowej, która może identyfikować program, np. strona programu w Wikipedii. Musi się różnić od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanie – obiekt znacznika działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w usłudze wideo na żądanie (VOD), ta właściwość jest wymagana. Obiekt znacznika działania musi zawierać link bezpośredni do treści.
  • Jeśli treść jest dostępna na kanale LiveTV, ta właściwość jest opcjonalna. Powiązany podmiot BroadcastService udostępnia zamiast niej link do kanału.
  • TVEpisode może być dostępny zarówno w przypadku treści VOD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Zdecydowanie zalecamy Dlaczego? URL Adres URL referencyjnej strony internetowej, która może identyfikować odcinek, np. strona 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 zalecamy Dlaczego? – PublicationEvent służy do określania pierwotnej (globalnej lub lokalnej) publikacji treści przez wydawcę, np. pierwotnej daty premiery filmu w kinach.

Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, polecane, specjalne itp.

ExclusiveEvent oznacza, że Twoja usługa ma wyłączne prawa do dystrybucji, i zawiera informacje o tym, gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w sekcji z przykładami.
releasedEvent.@type Text Wymagane – 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 opublikowano treści.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są promowane lub dostępne na wyłączność.

W przypadku krajów używaj kodów ISO 3166. Aby wskazać cały świat, ustaw wartość EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza to datę pierwszej publikacji elementu, np. datę pierwszej premiery filmu w kinach.

W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny na wyłączność lub wyróżniony.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent oznacza datę wygaśnięcia praw do treści.

W przypadku FeaturedEvent oznacza ostatnią datę, w której dostawca prezentuje podmiot.

Jeśli treści są na stałe dostępne na wyłączność lub prezentowane, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organization lub Person Opcjonalnie – organizacja lub osoba, która opublikowała ten podmiot.
description Text Zdecydowanie zalecamy Dlaczego? Streszczenie odcinka. Preferowane są streszczenia fabuły, a nie podsumowania faktów. Limit 300 znaków.
genre Text Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Text Słowa kluczowe lub tagi używane do opisywania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład ["feature, biography"] może być tablicą słów kluczowych opisujących treść.
actor Person lub PerformingGroup lub PerformanceRole Zdecydowanie zalecamy Dlaczego? Tablica z obsadą odcinka. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecamy Dlaczego? Reżyser lub reżyserzy odcinka.
producer Organization lub Person Zdecydowanie zalecamy Dlaczego? Producenci sezonu.
image ImageObject Gorąco polecamy Dlaczego? w Google TV – różne obrazy związane z odcinkiem serialu. Więcej informacji o właściwościach wymaganych i opcjonalnych, które należy uwzględnić w przypadku image, znajdziesz w sekcji Właściwości obrazu.
trailer.description Text Opis zwiastuna. Zobacz przykład Zwiastun.
trailer.inLanguage Text Zdecydowanie zalecane. 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 żadnych krajów, założymy, że film jest dozwolony wszędzie. Określ kraje w formacie ISO 3166.
review Opinia Sprawdzanie ocen odcinka serialu
review.reviewRating Ocena Wymagany, jeśli podano wartość review. Służy do określania oceny przyznanej w opinii.
contentRating Text lub Rating Wymagane w przypadku treści dla dorosłych, wysoce zalecane w innych przypadkach – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja ratingowa poprzedzona oceną z białym znakiem między nimi. Na przykład ocena „TV-MA” przyznana przez agencję „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie ma znaczenia), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Listę akceptowanych organizacji oceniających znajdziesz na stronie Organizacje oceniające treści.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialogi, FV = przemoc w fantastycznym wydaniu, L = język, S = treści o charakterze seksualnym, V = przemoc.
identifier PropertyValue Zdecydowanie zalecamy Dlaczego? – Zewnętrzny lub inny identyfikator, który jednoznacznie określa ten podmiot. Dozwolonych jest kilka identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Zdecydowanie zalecamy Dlaczego? Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane dla użytkowników. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0.
popularityScore.@type Text Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość 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 Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie „xx” oznacza język ciągów tekstowych w pliku danych. Każdy kontekst jednostki głównej powinien mieć ustawiony atrybut @language na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, zakłada się, że nazwy są w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@type Text Wymagany – zawsze ustawiony na TVSeason.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url programu). Będzie 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 identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
url Adres URL Wymaganykanoniczny adres URL treści, którego Google używa do dopasowywania treści w Twoim pliku danych do treści w bazach 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ć.
W przypadku precyzyjnego linku do odtwarzania zamiast tego użyj właściwości urlTemplate obiektu target.
name Text Wymagany – nazwa sezonu serialu telewizyjnego.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Reprezentacja w wielu językach.
  • Pamiętaj, że w przypadku każdego języka i kraju można podać tylko jedną nazwę.
titleEIDR Text Zdecydowanie zalecamy Dlaczego? – Identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie dzieło filmowe lub telewizyjne.

Na przykład identyfikator EIDR tytułu pierwszego sezonu serialu telewizyjnego „Gra o tron” to „10.5240/FD91-C72C-4161-FCBA-058B-1”.
seasonNumber Liczba całkowita Wymagany – liczba wskazująca pozycję tego sezonu w kolejności sezonów serialu.
partOfSeries TVSeries Wymagany – serial telewizyjny, do którego należy ten sezon.
partOfSeries.@type Text Wymagany – zawsze ustawiony na TVSeries.
partOfSeries.@id Adres URL Wymagany – @id TVSeries, którego częścią jest ten sezon.
partOfSeries.name Text Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs Text Adres URL referencyjnej strony internetowej, która może identyfikować program, np. strona programu w Wikipedii. Musi się różnić od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanie – obiekt znacznika działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w usłudze wideo na żądanie (VOD), ta właściwość jest wymagana. Obiekt znacznika działania musi zawierać link bezpośredni do treści.
  • Jeśli treść jest dostępna na kanale LiveTV, ta właściwość jest opcjonalna. Powiązany podmiot BroadcastService udostępnia zamiast niej link do kanału.
  • TVSeason może być dostępny zarówno w przypadku treści VOD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Zdecydowanie zalecamy Dlaczego? Adres URL referencyjnej strony internetowej, która może identyfikować sezon, np. strona sezonu w Wikipedii. Musi się różnić od właściwości url.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecamy Dlaczego? – PublicationEvent służy do określania pierwotnej (globalnej lub lokalnej) publikacji treści przez wydawcę, np. pierwotnej daty premiery filmu w kinach.

Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, polecane, specjalne itp.

ExclusiveEvent oznacza, że Twoja usługa ma wyłączne prawa do dystrybucji, i zawiera informacje o tym, gdzie i kiedy.

Szczegółowe informacje i przykłady znajdziesz w sekcji z przykładami.
releasedEvent.@type Text Wymagane – 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 opublikowano treści.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są promowane lub dostępne na wyłączność.

W przypadku krajów używaj kodów ISO 3166. Aby wskazać cały świat, ustaw wartość EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza to datę pierwszej publikacji elementu, np. datę pierwszej premiery filmu w kinach.

W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny na wyłączność lub wyróżniony.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku ExclusiveEvent oznacza datę wygaśnięcia praw do treści.

W przypadku FeaturedEvent oznacza ostatnią datę, w której dostawca prezentuje podmiot.

Jeśli treści są na stałe dostępne na wyłączność lub prezentowane, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organization lub Person Opcjonalnie – organizacja lub osoba, która opublikowała ten podmiot.
description Text Zdecydowanie zalecamy Dlaczego? streszczenie sezonu, Preferowane są streszczenia fabuły, a nie podsumowania faktów. Limit 300 znaków.
actor [Person lub PerformingGroup lub PerformanceRole Zdecydowanie zalecamy Dlaczego? Tablica członków obsady sezonu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Zdecydowanie zalecamy Dlaczego? Tablica reżyserów serialu.
producer Organization lub Person Zdecydowanie zalecamy Dlaczego? Producenci sezonu.
image ImageObject Obrazy powiązane z sezonem serialu. Więcej informacji o właściwościach wymaganych i opcjonalnych, które należy uwzględnić w przypadku image, znajdziesz w sekcji Właściwości obrazu.
genre Text Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Text Słowa kluczowe lub tagi używane do opisywania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład ["feature, biography"] może być tablicą słów kluczowych opisujących treść.
trailer.description Text Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage Text Zdecydowanie zalecane. 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 żadnych krajów, założymy, że film jest dozwolony wszędzie. Określ kraje w formacie ISO 3166.
identifier PropertyValue Zdecydowanie zalecamy Dlaczego? – Zewnętrzny lub inny identyfikator, który jednoznacznie określa ten podmiot. Dozwolonych jest kilka identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Zdecydowanie zalecamy Dlaczego? Ocena, której Google używa wraz z innymi sygnałami, aby określić, które media mają być odtwarzane dla użytkowników. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w Twoim katalogu. Skala wyniku musi być spójna we wszystkich plikach danych, wśród wszystkich elementów w Twoim katalogu. Domyślnie ocena popularności elementu jest ustawiona na 0.
popularityScore.@type Text Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. Im wyższy wynik, tym większa popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wynik popularności. Jeśli ocena popularności ma zastosowanie globalne, ustaw wartość 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 Sprawdzanie ocen sezonu serialu
review.reviewRating Ocena Wymagany, jeśli podano wartość review. Służy do określania oceny przyznanej w opinii.
contentRating Text lub Rating Wymagane w przypadku treści dla dorosłych, wysoce zalecane w innych przypadkach – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptowane są 2 warianty:
  • Agencja ratingowa poprzedzona oceną z białym znakiem między nimi. Na przykład ocena „TV-MA” przyznana przez agencję „TVPG” w Stanach Zjednoczonych powinna być opisana jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie ma znaczenia), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. Listę akceptowanych organizacji oceniających znajdziesz na stronie Organizacje oceniające treści.
contentRating.ratingValue Text Wymagane, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Text Kod ostrzeżenia dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialogi, FV = przemoc w fantastycznym wydaniu, L = język, S = treści o charakterze seksualnym, V = przemoc.

Specyfikacje podmiotu stanowiącego zagrożenie

Właściwość actor w typach TVSeries, TVEpisode i TVSeason umożliwia podanie szczegółowych informacji o aktorach, w tym nazw ich postaci i ról, które odgrywają w programie telewizyjnym. W sekcjach poniżej znajdziesz te same informacje oraz kilka przykładów wyjaśniających sposób użycia.

Właściwość Oczekiwany typ Opis
actor Person lub PerformingGroup lub PerformanceRole Zdecydowanie zalecamy Dlaczego? : tablica z członkami obsady.
  • Użyj typu PerformanceRole, gdy znana jest rola i (opcjonalnie) nazwa postaci odgrywanej przez członków obsady. W tym przypadku wykonawca Person lub PerformingGroup jest osadzony w obiekcie PerformanceRole.
  • Użyj typu Person, aby wskazać poszczególnych aktorów, lub typu PerformingGroup, aby podać szczegóły dotyczące grup wykonawczych lub zespołów, gdy role odgrywane przez członków obsady są nieznane.

Użyj tablicy, aby przedstawić wiele osób, grup wykonawczych lub ról wykonawczych.

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 ustawiony na Person lub PerformingGroup.
@id Adres URL Zdecydowanie zalecamy Dlaczego? – identyfikator wykonawców lub grupy wykonawców w formacie URI, np.https://example.com/actor/abc; @id musi spełniać te wymagania:
  • Unikalny w skali globalnej w Twoim katalogu dla każdego aktora lub grupy wykonawczej.
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie. Będzie 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żyta we właściwości actor powinna być spójnie stosowana w całym pliku danych. Jeśli na przykład 2 filmy zawierają tego samego aktora, wartość @id powinna być taka sama w przypadku obu obiektów aktora.

name Text Wymagane – imię i nazwisko aktora lub aktorki, członka obsady lub grupy wykonawczej.
sameAs Adres URL Zdecydowanie zalecamy Dlaczego? – adres URL referencyjnej strony internetowej, która może zidentyfikować aktora lub grupę wykonawczą, np. strona 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 Wymagane – zawsze ustawione na PerformanceRole.
roleName Text Zdecydowanie zalecamy Dlaczego? – rola odgrywana, wykonywana lub obsadzona przez członka obsady; Listę akceptowanych wartości znajdziesz tutaj.
characterName Text Nazwa postaci, w którą wciela się aktor lub wykonawca. Nie ustawiaj tego pola, jeśli typ aktora to PerformingGroup.
actor Person lub PerformingGroup Wymagane
  • Członkowie obsady treści, gdy używany jest typ danych Person.
  • Wykonawca lub wykonawcy treści, gdy używany jest typ danych PerformingGroup.
actor.@type Person lub PerformingGroup Wymagany – zawsze ustawiony na Person lub PerformingGroup.
actor.@id Adres URL Zdecydowanie zalecamy Dlaczego? – identyfikator wykonawcy lub grupy wykonawczej w formacie URI, np.https://example.com/actor/abc; @id musi spełniać te wymagania:
  • Unikalny w skali globalnej w Twoim katalogu dla każdego aktora lub grupy wykonawczej.
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie. Będzie 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żyta we właściwości actor powinna być spójnie stosowana w całym pliku danych. Jeśli na przykład 2 filmy zawierają tego samego aktora, wartość @id powinna być taka sama w przypadku obu obiektów aktora.

actor.name Text Wymagane – imię i nazwisko aktora lub aktorki, członka obsady lub grupy wykonawczej.
actor.sameAs Adres URL Zdecydowanie zalecamy Dlaczego? – adres URL referencyjnej strony internetowej, która może zidentyfikować aktora lub grupę wykonawczą, np. strona aktora w Wikipedii; Musi się różnić od właściwości actor.@id.

Dopuszczalne nazwy ról

W przypadku tych wartości parametr actor.@type musi mieć wartość Person.

Wartość roleName Opis
„Cameo” Rola epizodyczna to krótki występ znanej osoby w dziele sztuki scenicznej.
„VoiceActor” Występ głosowy to taki, w którym wykorzystywany jest głos aktora, ale nie pojawia się on na ekranie. Najczęściej występuje w animacjach, ale także wtedy, gdy głos aktora jest dubbingowany w miejsce mowy innego aktora.
„Podwójna” Dubler to osoba, która zastępuje innego aktora w taki sposób, że jej twarz nie jest widoczna.
„MotionCaptureActor” MotionCaptureActor to osoba nagrywająca działania aktorów i wykorzystująca te informacje do animowania cyfrowych modeli postaci w animacji komputerowej 2D lub 3D.

Te wartości są zwykle akceptowane w przypadku typów PersonPerformingGroup.

Wartość roleName Opis
„Aktor” Aktor to osoba, która odgrywa rolę w przedstawieniu w tradycyjnym teatrze lub w nowoczesnych mediach, takich jak film, radio i telewizja.
„GuestStar” „Gościnnie występuje aktor, który gra fikcyjną postać i pojawia się w jednym lub kilku odcinkach. W niektórych przypadkach gościnnie występująca gwiazda może odgrywać ważną rolę drugoplanową i pojawiać się w serialu wiele razy, mimo że nie jest członkiem głównej obsady. Ustaw wartość „GuestStar”, jeśli w obsadzie jest gość lub gościnnie występuje w programie. Gościnne występy powinny być podawane tylko na poziomie odcinka i nie powinny być dodawane na poziomie serialu.
„Gość” „Gość w talk show. Pamiętaj, że „GuestStar” to fikcyjna rola, a „Guest” to występ w roli gościa.
„Announcer” Spiker to osoba, która wygłasza wstęp i zakończenie programu, przedstawia gospodarza, uczestników lub gości specjalnych, opisuje dostępne nagrody, rozgrzewa publiczność przed nagraniem i zapewnia jej rozrywkę podczas przerw.
„Komentator” Komentator na bieżąco komentuje grę lub wydarzenie, zwykle podczas transmisji na żywo.
„Impresjonizm” Impresjonista lub mim to wykonawca, którego występ polega na naśladowaniu dźwięków, głosów i zachowań celebrytów oraz postaci z kreskówek.
„Host” Osoba, która przedstawia lub prowadzi programy telewizyjne, często pełniąc rolę mediatora między programem a widzami. „Gospodarz” to zwykle rola w programie dokumentalnym.
„Współgospodarz” Osoba, która organizuje wydarzenie lub program wspólnie z inną osobą lub innymi osobami.
„GuestHost” Gospodarz zastępczy to gospodarz, zwykle talk show, który prowadzi program zamiast stałego gospodarza, gdy ten jest niedostępny.
„Newscaster” Osoba, która przedstawia i informuje opinię publiczną o wydarzeniach lokalnych, krajowych i międzynarodowych w programie informacyjnym.
„Korespondent” Korespondent lub reporter na miejscu to zwykle dziennikarz lub komentator magazynu albo agent, który przesyła raporty do gazety, radia, telewizji lub innej firmy z odległej lokalizacji.
„ShowJudge” Sędzia to osoba, która jest często uważana za eksperta w dziedzinie, której dotyczy program. Jej zadaniem jest ocenianie uczestników, którzy biorą udział w castingach i rywalizują w programie telewizyjnym.
„Uczestnik panelu” członek panelu dyskusyjnego lub doradczego w programie radiowym lub telewizyjnym;
„Uczestnik” Uczestnik konkursu lub teleturnieju to osoba, która w nim bierze udział.
„StoryNarrator” Narrator to osoba, która coś opowiada, zwłaszcza postać, która relacjonuje wydarzenia z powieści lub poematu narracyjnego.
„MusicalArtist” „Wykonawca muzyczny może być osobą, grupą lub postacią fikcyjną, 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 z informacji o utworze muzycznym wynika, że są oni również głównymi wykonawcami. Ten typ może służyć do przypisywania do programów stałych wykonawców lub grup muzycznych oraz gości.

Rozróżnianie głównych i drugoplanowych ról aktorów

Aby odróżnić głównych aktorów od gościnnych lub drugoplanowych w serialu, dodaj główną obsadę tylko do encji TVSeries, a obsadę gościnną lub drugoplanową tylko do encji TVEpisode. Upewnij się, że główna/regularna obsada nie została dodana do elementów TVEpisode.

Przykłady

TVSeries, TVEpisodeTVSeason

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 usług Actor

Rola podmiotu jest nieznana

Jeśli rola aktora jest nieznana, zalecamy podanie informacji o aktorze przy użyciu 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 podmiotu jest znana

Jeśli rola aktora jest znana, zalecamy podanie informacji o aktorze za pomocą typu PerformanceRole.

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

Znane role w przypadku podzbioru aktorów

Jeśli metadane dotyczące roli wykonawcy nie są znane, zalecamy podanie informacji o aktorze za pomocą typu Person lub PerformingGroup. W innych przypadkach, gdy te informacje są znane, użyj typu PerformanceRole . Te typy można dodać do tej samej tablicy.

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

Tematy związane z tymi usługami znajdziesz na tych stronach: