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"}]
|
@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:
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 | Wymagany – kanoniczny 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:
urlTemplate obiektu target. |
name |
Text | Wymagany – nazwa programu.
|
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.
|
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:
|
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 | Zalecane – wymagane 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 | Zalecane – wymagane 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:
|
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"}]
|
@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:
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 | Wymagany – kanoniczny 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:
urlTemplate obiektu target. |
name |
Text | Wymagany – nazwa odcinka.
|
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:
|
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.
|
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:
|
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 | Zalecane – wymagane 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 | Zalecane – wymagane 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:
|
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"}]
|
@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:
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 | Wymagany – kanoniczny 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:
urlTemplate obiektu target. |
name |
Text | Wymagany – nazwa sezonu serialu telewizyjnego.
|
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.
|
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:
|
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 | Zalecane – wymagane 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 | Zalecane – wymagane 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:
|
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 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:
Pamiętaj, że wartość |
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 –
|
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:
Pamiętaj, że wartość |
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 Person i PerformingGroup.
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, TVEpisode i TVSeason
TVSeries
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show/",
"url": "http://www.example.com/my_favorite_tv_show/",
"name": "My Favorite TV Show",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.1,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite TV show.",
"contentRating": "RATING NOT KNOWN",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0903747"
}
]
}
TVEpisode
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVEpisode",
"@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
"url": "http://www.example.com/my_favorite_tv_show/s7/e14",
"name": "John Doe returns with a horse.",
"episodeNumber": 14,
"contentRating": "TVPG TV-MA",
"partOfSeason": {
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"seasonNumber": 7
},
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
"duration": "PT00H25M",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2014-01-09",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.9,
"eligibleRegion": "EARTH"
},
"description": "John Doe returns to the village three years after his disappearance.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt3453320"
}
}
TVSeason
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"url": "http://www.example.com/my_favorite_tv_show/s7",
"name": "Season 7",
"seasonNumber": 7,
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2010-09-23",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "The seventh season of My Favorite TV Show.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
]
}
Przykłady 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"
}
]
Powiązane artykuły
Tematy związane z tymi usługami znajdziesz na tych stronach: