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 typach TVSeries, TVEpisode i TVSeason.

Podanie pola TVSeason jako pełnego elementu jest opcjonalne. Szczegółowe informacje znajdziesz w sekcji dotyczącej seriali telewizyjnych, sezonów i odcinków TV.

Tabela specyfikacji

TVSeries

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie” xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@type Tekst Wymagane – zawsze ma wartość TVSeries.
@id Adres URL Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Produkt unikalny w całym katalogu
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 z pliku danych do treści w bazach danych Google.
url musi spełniać te wymagania:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagany – nazwa programu.
  • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR Tekst Dlaczego warto wybraćEIDR (Entertainment Identifier Registry) – identyfikator na najbardziej ogólnym lub abstrakcyjnym poziomie, film lub telewizja.

Na przykład tytułEIDR serialu telewizyjnego znanego jako „Gra o tron” to „10.5240/C1B5-3BA1-8991-A571-8472-W”.
potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczyobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treść jest dostępna w ramach funkcji Wideo na żądanie (VoD), ta właściwość jest wymagana. obiekt znaczników Action musi zawierać precyzyjny link do treści.
  • Jeśli treści są dostępne na kanale LiveTV, właściwość ta jest opcjonalna. powiązany element BroadcastService zawiera precyzyjny link do kanału.
  • Element TVSeries może być dostępny zarówno w VD, jak i LiveTV.
Za pomocą tablicy określ różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Dlaczego warto wybrać Adres URL referencyjnej strony internetowej, która może zidentyfikować program. na przykład stronę programu w Wikipedii. Musi się ona różnić od właściwości url.
inLanguage Tekst Oryginalny język serii w formacie BCP 47.
genre Tekst Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Tekst Słowa kluczowe lub tagi opisujące te treści. Dozwolona jest również tablica słów kluczowych. Na przykład ["funkcja, biografia"] może być zestawem słów kluczowych opisujących treść.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Dlaczego warto wybrać – Atrybut PublicationEvent służy do określenia oryginalnych (globalnych lub lokalnych) publikacji treści przez wydawcę, na przykład 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 określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz podaj miejsce i czas publikacji.

Zobacz sekcję przykładową.
releasedEvent.@type Tekst Wymagane – pamiętaj, aby zawsze wybierać w tej usłudze jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym wydarzeniem.

W przypadku regionu PublicationEvent jest to region, w którym treść została opublikowana.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są polecane lub niedostępne.

Użyj kodów ISO 3166 dla poszczególnych krajów. Aby wskazać wszystkie lokalizacje na świecie, ustaw EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji podmiotu.

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

W przypadku ExclusiveEvent i FeaturedEvent jest to data rozpoczęcia wyłączności lub prezentacji.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

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

W przypadku FeaturedEvent jest to ostatni dzień, w którym dostawca promuje dany podmiot.

Jeśli treści są bezterminowo prezentowane lub niedostępne na wyłączność, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalne – organizacja lub osoba, która opublikowała dany element.
description Tekst Dlaczego warto wybrać Streszczenie programu. Preferowane są streszczenia fabuły. Limit 300 znaków.
actor Person, PerformingGroup lub PerformanceRole Dlaczego warto wybrać Tablica z obsadą serialu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Dlaczego warto wybrać Reżyser programu.
producer Organizacja lub Osoba Dlaczego warto wybrać Producenci programu.
image ImageObject Wymagany w przypadku Google TV – obrazy związane z serialem telewizyjnym. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w elemencie image, znajdziesz w artykule o właściwościach obrazów.
trailer.description Tekst Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage Tekst 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 treści multimedialne są dozwolone. Jeśli jej nie określisz, prawdopodobnie będą dozwolone wszędzie. Podaj kraje w formacie ISO 3166.
identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje dany podmiot. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0.
popularityScore.@type Tekst Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH. Domyślnie ustawiona jest wartość EARTH.
Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI)
review Review Oceny seriali i programów telewizyjnych
review.reviewRating Ocena Wymagany, jeśli podano review Ta wartość służy do określenia oceny przyznanej w opinii.
contentRating Tekst lub Ocena Wymagany w przypadku treści dla dorosłych; w przeciwnym razie zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptujemy 2 odmiany:
  • Agencja oceniająca została dodana do oceny ze spacją pomiędzy. Na przykład: „TV-MA” ocena agencji „TVPG” w USA musi być oznaczona jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Na stronie Agencje oceniające treści znajdziesz listę akceptowanych agencji oceniających.
contentRating.ratingValue Tekst Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w świecie fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.

TVEpisode

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie” xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@type Tekst Wymagane – zawsze ma wartość TVEpisode.
@id Adres URL Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Produkt unikalny w całym katalogu
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 z pliku danych do treści w bazach danych Google.
url musi spełniać te wymagania:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagany – nazwa odcinka.
  • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Reprezentacja wielu języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR Tekst Dlaczego warto wybraćEIDR (Entertainment Identifier Registry) – identyfikator na najbardziej ogólnym lub abstrakcyjnym poziomie, film lub telewizja.

Na przykład: tytułEIDR pierwszego odcinka pierwszego sezonu serialu „Gra o tron” to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”.
editEIDR Tekst Dlaczego warto wybraćEIDR (Entertainment Identifier Registry) – identyfikator określający konkretną edycję lub edycję utworu filmowego lub telewizyjnego.

Na przykład pierwszy odcinek pierwszego sezonu serialu „Gra o tron” o tytule „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X” ma jedną edycję, np. "10.5240/FB97-C847-2969-D0AB-ECD1-C".

Jeśli podano parametr EditEIDR, wymagana jest właściwość titleEIDR.
inLanguage Tekst Oryginalny język serii w formacie BCP 47.
episodeNumber Liczba całkowita Wymagany – liczba określająca pozycję odcinka w kolejności odcinków w sezonie. episodeNumber muszą uruchamiać się ponownie na każdy sezon. Oznacza to, że pierwszy odcinek każdego sezonu musi mieć 1.
partOfSeason TVSeason Wymagany – sezon programu telewizyjnego, do którego należy ten odcinek.

Nawet jeśli TVEpisode nie ma odpowiadającego mu elementu TVSeason, musisz podać właściwości partOfSeason.@id i partOfSeason.seasonNumber. Można to obejść:
  • Weź pod uwagę partofSeries.@id (np. http://www.example.com/my_favorite_tv_show) i dołącz zastępcze pole zapytania (np. http://www.example.com/my_favorite_tv_show), aby utworzyć unikalny partOfSeason.@id (np. http://www.example.com/my_favorite_tv_show).
  • Ustaw partOfSeason.seasonNumber na 1.
partOfSeason.@type Tekst Wymagane – zawsze ma wartość TVSeason.
partOfSeason.@id Adres URL Wymagany – właściwość @id elementu TVSeason, do której należy ten odcinek.
partOfSeason.seasonNumber Liczba całkowita Wymagany – liczba określająca pozycję tego sezonu w kolejności sezonów w programie telewizyjnym.
partOfSeries TVSeries Wymagany – serial telewizyjny, do którego należy ten odcinek.
partOfSeries.@type Tekst Wymagane – zawsze ma wartość TVSeries.
partOfSeries.@id Adres URL Wymagany – właściwość @id elementu TVSeries, do której należy ten odcinek.
partOfSeries.name Tekst Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs Tekst Adres URL referencyjnej strony internetowej, która może zidentyfikować program. na przykład stronę programu w Wikipedii. Musi się ona różnić od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczyobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treść jest dostępna w ramach funkcji Wideo na żądanie (VoD), ta właściwość jest wymagana. obiekt znaczników Action musi zawierać precyzyjny link do treści.
  • Jeśli treści są dostępne na kanale LiveTV, właściwość ta jest opcjonalna. powiązany element BroadcastService zawiera precyzyjny link do kanału.
  • Element TVEpisode może być dostępny zarówno w VD, jak i LiveTV.
Za pomocą tablicy określ różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Dlaczego warto wybrać Adres URL Adres URL referencyjnej strony internetowej, która może zidentyfikować odcinek. np. stronę tego odcinka w Wikipedii. Musi się ona 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 Dlaczego warto wybrać – Atrybut PublicationEvent służy do określenia oryginalnych (globalnych lub lokalnych) publikacji treści przez wydawcę, na przykład 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 określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz podaj miejsce i czas publikacji.

Zobacz sekcję przykładową.
releasedEvent.@type Tekst Wymagane – pamiętaj, aby zawsze wybierać w tej usłudze jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym wydarzeniem.

W przypadku regionu PublicationEvent jest to region, w którym treść została opublikowana.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są polecane lub niedostępne.

Użyj kodów ISO 3166 dla poszczególnych krajów. Aby wskazać wszystkie lokalizacje na świecie, ustaw EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji podmiotu.

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

W przypadku ExclusiveEvent i FeaturedEvent jest to data rozpoczęcia wyłączności lub prezentacji.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

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

W przypadku FeaturedEvent jest to ostatni dzień, w którym dostawca promuje dany podmiot.

Jeśli treści są bezterminowo prezentowane lub niedostępne na wyłączność, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalne – organizacja lub osoba, która opublikowała dany element.
description Tekst Dlaczego warto wybrać Streszczenie odcinka. Preferowane są streszczenia fabuły. Limit 300 znaków.
genre Tekst Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Tekst Słowa kluczowe lub tagi opisujące te treści. Dozwolona jest również tablica słów kluczowych. Na przykład ["funkcja, biografia"] może być zestawem słów kluczowych opisujących treść.
actor Person, PerformingGroup lub PerformanceRole Dlaczego warto wybrać Tablica z obsadą odcinka. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Dlaczego warto wybrać Reżyser odcinka.
producer Organizacja lub Osoba Dlaczego warto wybrać Producenci sezonu.
image ImageObject Dlaczego? w Google TV – różne obrazy związane z odcinkiem telewizyjnym. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w elemencie image, znajdziesz w artykule o właściwościach obrazów.
trailer.description Tekst Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage Tekst 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 treści multimedialne są dozwolone. Jeśli jej nie określisz, prawdopodobnie będą dozwolone wszędzie. Podaj kraje w formacie ISO 3166.
review Review Sprawdź oceny odcinka programu telewizyjnego
review.reviewRating Ocena Wymagany, jeśli podano review Ta wartość służy do określenia oceny przyznanej w opinii.
contentRating Tekst lub Ocena Wymagany w przypadku treści dla dorosłych; w przeciwnym razie zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptujemy 2 odmiany:
  • Agencja oceniająca została dodana do oceny ze spacją pomiędzy. Na przykład: „TV-MA” ocena agencji „TVPG” w USA musi być oznaczona jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Na stronie Agencje oceniające treści znajdziesz listę akceptowanych agencji oceniających.
contentRating.ratingValue Tekst Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w świecie fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.
identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje dany podmiot. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0.
popularityScore.@type Tekst Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH. Domyślnie ustawiona jest wartość EARTH.
Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI)

TVSeason

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie” xx” odpowiada językowi ciągów znaków w pliku danych. W przypadku każdego kontekstu elementu głównego parametr @language powinien być ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@type Tekst Wymagane – zawsze ma wartość TVSeason.
@id Adres URL Wymagany – identyfikator treści w formacie URI; np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Produkt unikalny w całym katalogu
  • Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy użycie właściwości url elementu 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 z pliku danych do treści w bazach danych Google.
url musi spełniać te wymagania:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagany – nazwa tego sezonu programu telewizyjnego.
  • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Reprezentacja wielu języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
titleEIDR Tekst Dlaczego warto wybraćEIDR (Entertainment Identifier Registry) – identyfikator na najbardziej ogólnym lub abstrakcyjnym poziomie, film lub telewizja.

Na przykład: tytułEIDR pierwszego sezonu serialu „Gra o tron” to „10.5240/FD91-C72C-4161-FCBA-058B-1”.
seasonNumber Liczba całkowita Wymagany – liczba określająca pozycję tego sezonu w kolejności sezonów w programie telewizyjnym.
partOfSeries TVSeries Wymagany – serial telewizyjny, do którego należy ten sezon.
partOfSeries.@type Tekst Wymagane – zawsze ma wartość TVSeries.
partOfSeries.@id Adres URL Wymagany@id pakietu TVSeries, do którego należy ten sezon.
partOfSeries.name Tekst Wymagany – nazwa serialu telewizyjnego.
partOfSeries.sameAs Tekst Adres URL referencyjnej strony internetowej, która może zidentyfikować program. na przykład stronę programu w Wikipedii. Musi się ona różnić od właściwości url.
potentialAction WatchAction (oglądanie) Wymagany, jeśli dotyczyobiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treść jest dostępna w ramach funkcji Wideo na żądanie (VoD), ta właściwość jest wymagana. obiekt znaczników Action musi zawierać precyzyjny link do treści.
  • Jeśli treści są dostępne na kanale LiveTV, właściwość ta jest opcjonalna. powiązany element BroadcastService zawiera precyzyjny link do kanału.
  • Element TVSeason może być dostępny zarówno w VD, jak i LiveTV.
Za pomocą tablicy określ różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Dlaczego warto wybrać Adres URL referencyjnej strony internetowej, która pozwala zidentyfikować sezon. np. strona sezonu w Wikipedii. Musi się ona różnić od właściwości url.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Dlaczego warto wybrać – Atrybut PublicationEvent służy do określenia oryginalnych (globalnych lub lokalnych) publikacji treści przez wydawcę, na przykład 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 określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz określa ich miejsce i czas.

Zobacz sekcję przykładową, aby dowiedzieć się więcej.
releasedEvent.@type Tekst Wymagane – pamiętaj, aby zawsze wybierać w tej usłudze jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym wydarzeniem.

W przypadku regionu PublicationEvent jest to region, w którym treść została opublikowana.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są polecane lub niedostępne.

Użyj kodów ISO 3166 dla poszczególnych krajów. Aby wskazać wszystkie lokalizacje na świecie, ustaw EARTH.
releasedEvent.startDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji podmiotu.

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

W przypadku ExclusiveEvent i FeaturedEvent jest to data rozpoczęcia wyłączności lub prezentacji.
releasedEvent.endDate Date lub DateTime Zalecanewymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

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

W przypadku FeaturedEvent jest to ostatni dzień, w którym dostawca promuje dany podmiot.

Jeśli treści są bezterminowo prezentowane lub niedostępne na wyłączność, ustaw endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organizacja lub Osoba Opcjonalne – organizacja lub osoba, która opublikowała dany element.
description Tekst Dlaczego warto wybrać Streszczenie sezonu. Preferowane są streszczenia fabuły. Limit 300 znaków.
actor [Person, PerformingGroup lub PerformanceRole Dlaczego warto wybrać Tablica z obsadą sezonu. Wskazówki dotyczące modelowania znajdziesz tutaj.
director Person Dlaczego warto wybrać Przedstawiciele reżyserów programu.
producer Organizacja lub Osoba Dlaczego warto wybrać 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 elemencie image, znajdziesz w artykule o właściwościach obrazów.
genre Tekst Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"]
keywords Tekst Słowa kluczowe lub tagi opisujące te treści. Dozwolona jest również tablica słów kluczowych. Na przykład ["funkcja, biografia"] może być zestawem słów kluczowych opisujących treść.
trailer.description Tekst Opis zwiastuna. Zobacz przykład zwiastuna.
trailer.inLanguage Tekst 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 treści multimedialne są dozwolone. Jeśli jej nie określisz, prawdopodobnie będą dozwolone wszędzie. Podaj kraje w formacie ISO 3166.
identifier PropertyValue Dlaczego warto wybrać – Zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje dany podmiot. Dozwolonych jest wiele identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora.
popularityScore PopularityScoreSpecification Dlaczego warto wybrać Wynik wykorzystywany przez Google, wraz z innymi sygnałami, do określania, które multimedia wyświetlić użytkownikom. Ocena ta określa popularność treści w porównaniu z innymi treściami w Twoim katalogu. dlatego skala wyniku musi być spójna we wszystkich plikach danych i we wszystkich elementach w katalogu. Domyślnie wynik popularności jednostki ma wartość 0.
popularityScore.@type Tekst Zawsze ustawiona na PopularityScoreSpecification.
popularityScore.value Number Nieujemna wartość liczbowa wskazująca popularność elementu. wyższy wynik oznacza większą popularność.
popularityScore.eligibleRegion Kraj Regiony, w których obowiązuje ten wskaźnik popularności. Jeśli wynik popularności ma zastosowanie na całym świecie, ustaw wartość EARTH. Domyślnie ustawiona jest wartość EARTH.
Note: Popularność w konkretnym regionie ma pierwszeństwo przed popularnością globalną (ZIEMI)
review Review Oceny treści dotyczących sezonu programu telewizyjnego
review.reviewRating Ocena Wymagany, jeśli podano review Ta wartość służy do określenia oceny przyznanej w opinii.
contentRating Tekst lub Ocena Wymagany w przypadku treści dla dorosłych; w przeciwnym razie zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptujemy 2 odmiany:
  • Agencja oceniająca została dodana do oceny ze spacją pomiędzy. Na przykład: „TV-MA” ocena agencji „TVPG” w USA musi być oznaczona jako „TVPG TV-MA”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana), aby wskazać, że nie znasz oceny treści.
contentRating.author Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Na stronie Agencje oceniające treści znajdziesz listę akceptowanych agencji oceniających.
contentRating.ratingValue Tekst Wymagany, jeśli contentRating używa Rating – wartość oceny.
contentRating.advisoryCode Tekst Kod porady dotyczący treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w świecie fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc.

Specyfikacje dotyczące aktorów

Właściwość actor w typach elementów TVSeries, TVEpisode i TVSeason umożliwia podanie dodatkowych informacji o aktorach, w tym imionach i nazwiskach oraz rolach, jakie odgrywają w programie telewizyjnym. W poniższych sekcjach opisano te same zasady wraz z kilkoma przykładami wyjaśniającymi ich zastosowanie.

Właściwość Oczekiwany typ Opis
actor Person, PerformingGroup lub PerformanceRole Dlaczego warto wybrać : tablica członków obsady.
  • Jeśli używana jest rola, użyj typu PerformanceRole, a opcjonalnie imię i nazwisko jej postaci jest znane. W tym przypadku aktor Person lub PerformingGroup jest osadzony w obiekcie PerformanceRole.
  • Użyj typu Person, aby wskazać poszczególnych aktorów, lub PerformingGroup, aby podać szczegółowe informacje o grupach/zespołach, gdy role odgrywane przez członków obsady są nieznane.

Użyj tablicy do reprezentowania wielu elementów Persons, PerformingGroups lub PerformanceRoles.

Używam typów Person lub PerformingGroup

Gdy używany jest typ Person lub PerformingGroup, podaj te właściwości

Właściwość Oczekiwany typ Opis
@type Person lub PerformingGroup Wymagane – zawsze ustawiana jako Person lub PerformingGroup.
@id Adres URL Dlaczego warto wybrać – identyfikator aktorów lub grupy wykonującej czynności w formacie URI; np. https://example.com/actor/abc. @id musi spełniać następujące wymagania:
  • Globalnie unikalne w całym katalogu dla danego aktora lub grupy wykonawców
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie. Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Twoja organizacja musi być właścicielem domeny używanej na potrzeby wartości @id.

Pamiętaj, że pole @id używane we właściwości aktor powinien być spójnie używane w całym kanale. Jeśli na przykład są 2 filmy z tym samym aktorem, to wartość @id powinna być taka sama dla tych 2 obiektów.

name Tekst Wymagane – imię i nazwisko aktora, aktorki, członka obsady lub grupy wykonywanej przez aktorów.
sameAs Adres URL Dlaczego warto wybrać – URL referencyjnej strony internetowej, która może zidentyfikować użytkownika lub grupę wykonawców; np. stronę tego aktora w Wikipedii. Musi się ona różnić od właściwości @id.

Używam typu PerformanceRole

Gdy używany jest typ PerformanceRole, podaj te właściwości

Właściwość Oczekiwany typ Opis
@type PerformanceRole Wymagany – zawsze ma wartość PerformanceRole.
roleName Tekst Dlaczego warto wybrać – rolę odgrywaną, wykonywaną lub wypełnioną przez członka obsady; Listę akceptowanych wartości znajdziesz tutaj.
characterName Tekst Imię i nazwisko postaci odgrywanej lub aktorskiej. Nie ustawiaj tego pola, jeśli typ aktora to PerformingGroup.
actor Person lub PerformingGroup Wymagane
  • Członek obsady treści, gdy używany jest typ danych Osoba.
  • Grupy/zakresy treści, w przypadku których używany jest typ danych PerformingGroup.
actor.@type Person lub PerformingGroup Wymagane – zawsze ustawiana jako Person lub PerformingGroup.
actor.@id Adres URL Dlaczego warto wybrać – identyfikator użytkownika, który wykonał czynność, lub grupy wykonującej dany utwór w formacie URI; np. https://example.com/actor/abc. @id musi spełniać następujące wymagania:
  • Globalnie unikalne w całym katalogu dla danego aktora lub grupy wykonawców
  • Ten identyfikator powinien być stały i nie zmieniać się w czasie. Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Twoja organizacja musi być właścicielem domeny używanej na potrzeby wartości @id.

Pamiętaj, że pole @id używane we właściwości aktor powinien być spójnie używane w całym kanale. Jeśli na przykład są 2 filmy z tym samym aktorem, to wartość @id powinna być taka sama dla tych 2 obiektów.

actor.name Tekst Wymagane – imię i nazwisko aktora, aktorki, członka obsady lub grupy wykonywanej przez aktorów.
actor.sameAs Adres URL Dlaczego warto wybrać – URL referencyjnej strony internetowej, która może zidentyfikować użytkownika lub grupę wykonawców; np. stronę tego aktora w Wikipedii. Musi się ona różnić od właściwości actor.@id.

Dopuszczalne nazwy ról

Te wartości wymagają, by actor.@type miał wartość Person.

Wartość: roleName Opis
„Cameo” Rola epizodyczna, nazywana również epizodem, to krótkie wystąpienie dobrze znanej osoby w dziełach sztuk scenicznych.
„VoiceActor” W odstępie głosowym pojawia się głos aktora, ale nie widać go na ekranie. Występuje najczęściej w animacji, ale pojawia się też wtedy, gdy głos aktora jest dubbingowany w stosunku do wypowiedzi innego aktora.
„Podwójna” Podwójny to osoba, która zastępuje innego aktora, tak aby jego twarz nie była widoczna.
„MotionCaptureActor” MotionCaptureActor to osoba nagrywająca działania ludzkich aktorów i wykorzystująca te informacje do animowania cyfrowych modeli postaci w animacji komputerowej 2D lub 3D.

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

Wartość: roleName Opis
„Użytkownik, który wykonał czynność” Aktor lub aktorka to osoba, która przedstawia postać w przedstawieniu w tradycyjnych środkach przekazu teatralnego lub w nowoczesnych mediach, takich jak film, radio i telewizja.
„GuestStar” „Gościenny występ to aktor, który wciela się w fikcyjną rolę i pojawia się w jednym lub kilku odcinkach. W niektórych przypadkach gość może odgrywać ważną rolę powracającą w serialu, co może pojawić się wielokrotnie w serii, mimo że nie należy do głównej obsady. Ustaw wartość na „GuestStar” gdy obsada występuje gościem lub występuje w programie. Gwiazdy gości należy dodawać tylko na poziomie odcinka i nie należy ich dodawać na poziomie serialu.
„Gość” „Gość w programie talk-show. Pamiętaj, że chociaż plik „GuestStar” to fikcyjna rola „Gość”. To nie jest coś fikcyjnego.
„Spiker” Komentator to osoba, która w początkowej i końcowej części programu przedstawia gospodarza, uczestników i celebrytów, opisuje dostępne nagrody, ogrzewa publiczność przed nagraniem materiału i zapewnia rozrywkę w czasie przerw.
„Komentator” Komentator komentuje rozgrywki lub wydarzenia w czasie rzeczywistym, zazwyczaj w czasie transmisji na żywo.
„impresjonista” impresjonista lub imitator to wykonawca, którego zachowanie polega na naśladowaniu dźwięków, głosów i manieryzmu celebrytów i postaci z kreskówek.
„Organizator” Osoba, która wprowadza, prezentuje lub prowadzi programy telewizyjne, często pełni rolę mediatora w sprawach dotyczących programu i odbiorców. Pole „Gospodarz” jest zwykle fikcyjny.
„Współgospodarz” Osoba, która wspólnie z inną osobą organizuje wydarzenie lub program.
„GuestHost” Gospodarz to osoba prowadząca, zwykle w formie talk-show, która poza zwykłym gospodarzem organizuje program, gdy jest on niedostępny.
„Prezenter” Osoba, która prezentuje lub informuje opinię publiczną o wiadomościach i wydarzeniach odbywających się na skalę lokalną, krajową i międzynarodową w telewizji informacyjnej.
„Korespondent” Korespondent lub komentator wydarzeń na scenie to zwykle dziennikarz lub komentator czasopisma albo agent, który publikuje reportaże w gazecie, radiu, telewizji lub firmie innego rodzaju, znajdujący się na odległym, często odległym miejscu.
„ShowJudge” Sędzia to osoba, która jest często uważana za eksperta w danej dziedzinie i jest traktowana jako sędzia. recenzowanie uczestników, którzy uczestniczą w przesłuchaniu do serialu telewizyjnego i wzięli w nim udział.
„Panelista” członek panelu dyskusyjnego lub grupy doradczej radio albo telewizyjnej.
Uczestnik Uczestnik w konkursie lub teleturnieju to osoba, która bierze w nim udział.
„StoryNarrator” Narrator to osoba, która coś pisze, zwłaszcza postać, która opowiada o wydarzeniach z powieści lub wiersza narracyjnego.
„MusicalArtist” „Wykonawcą muzycznym może być osoba, grupa lub fikcyjna postać, która zwykle regularnie występuje przed publicznością lub ma nagrane utwory muzyczne lub albumy muzyczne. Kompozytorzy i autorzy powinni używać tego typu treści tylko wtedy, gdy informacje o autorach niektórych utworów muzycznych sugerują, że są oni również głównym wykonawcą. Tego typu można użyć do powiązania stałych muzyków lub grup muzyków oraz gościnnych muzyków lub grup muzyków z występami.

Rozróżnienie między główną i dodatkową rolą aktora

Aby rozróżnić aktorów głównych/standardowych i gościnnych/dodatkowych, dodaj główną obsadę tylko w elementach TVSeries, a w elementach TVEpisode dodaj tylko gościnną obsadę lub rolę drugoplanową. Upewnij się, że do elementów TVEpisode nie dodano przesyłania głównego/standardowego.

Przykłady

Przykłady: TVSeries, TVEpisode i TVSeason

TVSeries

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

TVEpisode

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

TVSeason

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

Actor – przykłady właściwości

Rola użytkownika jest nieznana

Jeśli rola aktora nie jest znana, zalecamy podanie tylko informacji o niej 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 użytkownika jest znana

Jeśli rola użytkownika jest znana, zalecamy podanie jego danych 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 dla podzbioru aktorów

Jeśli metadane dotyczące roli wykonawcy nie są znane, zalecamy podanie informacji o użytkowniku za pomocą typu Person lub PerformingGroup . W drugim przypadku, w którym te informacje są znane, użyj typu PerformanceRole . Typy te można dodawać do tej samej tablicy.

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

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: