W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku elementów typu TVSeries
, TVEpisode
i TVSeason
.
Podanie TVSeason
jako pełnego elementu jest opcjonalne. Więcej informacji znajdziesz w sekcji dotyczącej serii TV, seriali i programów telewizyjnych.
Tabela specyfikacji
TVSeries
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
tekstowy. | Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
|
@type |
tekstowy. | 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:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.url musi spełniać te wymagania:
urlTemplate . |
name |
tekstowy. | Wymagane – nazwa programu.
|
titleEIDR |
tekstowy. | Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji. Na przykład tytuł EIDR serialu telewizyjnego o nazwie „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 zalecane dlaczego? Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url . |
inLanguage |
tekstowy. | Oryginalny język serii w formacie BCP 47. |
genre |
tekstowy. | Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"] |
keywords |
tekstowy. | Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść. |
releasedEvent |
PublicationEvent , FeaturedEvent lub ExclusiveEvent |
Zdecydowanie zalecane dlaczego? – PublicationEvent pozwala określić oryginalne (globalne lub lokalne) wydanie treści przez wydawcę, takie jak oryginalna data premiery w kinie.Dodatkowo użyj właściwości FeaturedEvent , aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.ExclusiveEvent , że Twoja usługa ma wyłączne prawa do dystrybucji, oraz dołącz, gdzie i kiedy.Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji. |
releasedEvent.@type |
tekstowy. | Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym zdarzeniem. W przypadku PublicationEvent jest to region, w którym opublikowano treść.W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH . |
releasedEvent.startDate |
Data lub DateTime | Zalecany – wymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu. |
releasedEvent.endDate |
Data lub DateTime | Zalecane – Wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent .W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organizacja lub Osoba | Opcjonalnie – organizacja lub osoba, która opublikowała ten element. |
description |
tekstowy. | Zdecydowanie zalecane dlaczego? Krótki opis programu. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
|
actor |
Person, PerformingGroup lub PerformanceRole | Zdecydowanie zalecane dlaczego? Tablica członków obsady. Wskazówki dotyczące modelowania znajdziesz tutaj. |
director |
Person | Zdecydowanie zalecane dlaczego? Reżyser(y) programu. |
producer |
Organizacja lub Osoba | Zdecydowanie zalecane dlaczego? Producent programu. |
image |
ImageObject | Wymagane w przypadku Google TV – obrazy związane z serią TVTV. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu. |
trailer.description |
tekstowy. | Opis zwiastuna. Zobacz przykład zwiastuna. |
trailer.inLanguage |
tekstowy. | Język zwiastuna w formacie BCP 47. |
trailer.url |
Adres URL | Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła. |
trailer.regionsAllowed |
Miejsce | Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166. |
identifier |
PropertyValue | Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora. |
popularityScore |
Specyfikacjapopularności | Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
tekstowy. | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH . Domyślnie ta właściwość ma wartość EARTH . Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością |
review |
Review | Recenzje serialu telewizyjnego |
review.reviewRating |
Ocena | Wymagany, jeśli podano review . Służy do określania oceny podanej w opinii. |
contentRating |
Tekst lub Ocena | Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
|
contentRating.author |
Tekst lub Organizacja | Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści |
contentRating.ratingValue |
tekstowy. | Wymagany, jeśli contentRating używa Rating – wartość oceny. |
contentRating.advisoryCode |
tekstowy. | Kod porad dotyczących treści. Możliwe wartości to D, FV, L, S i V. D = dialog, FV = przemoc fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc. |
TVEpisode
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
tekstowy. | Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
|
@type |
tekstowy. | 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:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.url musi spełniać te wymagania:
urlTemplate . |
name |
tekstowy. | Wymagane – nazwa odcinka.
|
titleEIDR |
tekstowy. | Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji. Na przykład tytuł EIDR pierwszego sezonu serialu telewizyjnego znanego jako „Gra o Tron” to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”. |
editEIDR |
tekstowy. | Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje określoną edycję lub wydanie filmu lub programu telewizyjnego. Na przykład pierwszy odcinek pierwszego sezonu serialu telewizyjnego o nazwie „Gra o tron”, którego tytuł EIDR to „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X”, zawiera jedną zmianę, taką jak „10.5240/FB97-C847-2AB69-2AB69-2AB69”. Właściwość titleEIDR jest wymagana, jeśli podano właściwość EditEIDR. |
inLanguage |
tekstowy. | Oryginalny język serii w formacie BCP 47. |
episodeNumber |
Liczba całkowita | Wymagany – liczba, która określa pozycję odcinka w kolejności odcinków. episodeNumber musi zostać ponownie uruchomiony w przypadku każdego sezonu. Oznacza to, że pierwszy odcinek każdego sezonu musi wynosić 1. |
partOfSeason |
Sezon | Wymagany – sezon serialu, do którego należy ten odcinek. Nawet jeśli TVEpisode nie ma powiązanego elementu TVSeason , musisz podać właściwości partOfSeason.@id i partOfSeason.seasonNumber . Możesz obejść ten problem:
|
partOfSeason.@type |
tekstowy. | Wymagane – zawsze ma wartość TVSeason . |
partOfSeason.@id |
Adres URL | Wymagane – @id z TVSeason , do których należy ten odcinek. |
partOfSeason.seasonNumber |
Liczba całkowita | Wymagany – liczba, która wskazuje pozycję sezonu w kolejności sezonów. |
partOfSeries |
Serial telewizyjny | Wymagany – serial, do którego należy ten odcinek. |
partOfSeries.@type |
tekstowy. | Wymagane – zawsze ma wartość TVSeries . |
partOfSeries.@id |
Adres URL | Wymagane – @id z TVSeries , do których należy ten odcinek. |
partOfSeries.name |
tekstowy. | Wymagane – nazwa serialu telewizyjnego. |
partOfSeries.sameAs |
tekstowy. | Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url . |
potentialAction |
WatchAction (oglądanie) | Wymagany, jeśli ma zastosowanie – obiekt znaczników działania, który zawiera szczegóły działania.
|
sameAs |
Zdecydowanie zalecane dlaczego? Adres URL | Adres URL odniesienia do strony internetowej, na której można zidentyfikować dany odcinek. Na przykład strona egzaminacyjna w Wikipedii. Ta właściwość musi różnić się od właściwości url . |
duration |
Czas trwania | Czas trwania odcinka w formacie ISO 8601. Użyj formatu: „PT00H00M”. |
releasedEvent |
PublicationEvent , FeaturedEvent lub ExclusiveEvent |
Zdecydowanie zalecane dlaczego? – PublicationEvent pozwala określić oryginalne (globalne lub lokalne) wydanie treści przez wydawcę, takie jak oryginalna data premiery w kinie.Dodatkowo użyj właściwości FeaturedEvent , aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.ExclusiveEvent , że Twoja usługa ma wyłączne prawa do dystrybucji, oraz dołącz, gdzie i kiedy.Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji. |
releasedEvent.@type |
tekstowy. | Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym zdarzeniem. W przypadku PublicationEvent jest to region, w którym opublikowano treść.W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH . |
releasedEvent.startDate |
Data lub DateTime | Zalecany – wymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu. |
releasedEvent.endDate |
Data lub DateTime | Zalecane – Wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent .W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organizacja lub Osoba | Opcjonalnie – organizacja lub osoba, która opublikowała ten element. |
description |
tekstowy. | Zdecydowanie zalecane dlaczego? Krótki opis odcinka. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
|
genre |
tekstowy. | Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"] |
keywords |
tekstowy. | Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść. |
actor |
Person, PerformingGroup lub PerformanceRole | Zdecydowanie zalecane dlaczego? Tablica obsady odcinka. Wskazówki dotyczące modelowania znajdziesz tutaj. |
director |
Person | Zdecydowanie zalecane dlaczego? Reżyser odcinka. |
producer |
Organizacja lub Osoba | Zdecydowanie zalecane dlaczego? Twórcy sezonu. |
image |
ImageObject | Zdecydowanie zalecane dlaczego? w przypadku Google TV – różne obrazy powiązane z odcinkiem serialu telewizyjnego. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu. |
trailer.description |
tekstowy. | Opis zwiastuna. Zobacz przykład zwiastuna. |
trailer.inLanguage |
tekstowy. | Język zwiastuna w formacie BCP 47. |
trailer.url |
Adres URL | Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła. |
trailer.regionsAllowed |
Miejsce | Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166. |
review |
Review | Oceny dotyczące odcinka programu telewizyjnego |
review.reviewRating |
Ocena | Wymagany, jeśli podano review . Służy do określania oceny podanej w opinii. |
contentRating |
Tekst lub Ocena | Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
|
contentRating.author |
Tekst lub Organizacja | Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści |
contentRating.ratingValue |
tekstowy. | Wymagany, jeśli contentRating używa Rating – wartość oceny. |
contentRating.advisoryCode |
tekstowy. | Kod porad dotyczących treści. Możliwe wartości to D, FV, L, S i V. D = dialog, FV = przemoc fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc. |
identifier |
PropertyValue | Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora. |
popularityScore |
Specyfikacjapopularności | Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
tekstowy. | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH . Domyślnie ta właściwość ma wartość EARTH . Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością |
TVSeason
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
tekstowy. | Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
|
@type |
tekstowy. | 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:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie właściwości url jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny URL treści, którego Google używa do dopasowania treści w Twoim kanale do baz danych Google.url musi spełniać te wymagania:
urlTemplate . |
name |
tekstowy. | Wymagany – nazwa tego sezonu programu telewizyjnego.
|
titleEIDR |
tekstowy. | Zdecydowanie zalecane dlaczego? – identyfikator EIDR (Entertainment Identifier Registry), który reprezentuje najbardziej ogólny lub abstrakcyjny charakter filmu albo telewizji. Na przykład tytuł EIDR pierwszego sezonu serialu telewizyjnego o nazwie „Gra o Tron” to „10.5240/FD91-C72C-4161-FCBA-058B-1”. |
seasonNumber |
Liczba całkowita | Wymagany – liczba, która wskazuje pozycję sezonu w kolejności sezonów. |
partOfSeries |
Serial telewizyjny | Wymagany – serial, do którego należy ten sezon. |
partOfSeries.@type |
tekstowy. | Wymagane – zawsze ma wartość TVSeries . |
partOfSeries.@id |
Adres URL | Wymagany – wartość @id z TVSeries , do której należy ten sezon. |
partOfSeries.name |
tekstowy. | Wymagane – nazwa serialu telewizyjnego. |
partOfSeries.sameAs |
tekstowy. | Adres URL referencyjnej strony internetowej, na której można zidentyfikować program, np. strona Wikipedii programu. Ta właściwość musi różnić się od właściwości url . |
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 zalecane dlaczego? Adres URL referencyjnej strony internetowej, na której można zidentyfikować sezon, na przykład strona Wikipedii dotycząca sezonu. Ta właściwość musi różnić się od właściwości url . |
releasedEvent |
PublicationEvent , FeaturedEvent lub ExclusiveEvent |
Zdecydowanie zalecane dlaczego? – PublicationEvent umożliwia określenie pierwotnej (globalnej lub lokalnej) premiery treści przez wydawcę, np. pierwotna data premiery filmu w kinie.Dodatkowo użyj właściwości FeaturedEvent , aby wskazać, że Twoja usługa promuje treści jako oryginalne, polecane, specjalne itd.ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz gdzie i kiedy.Szczegółowe informacje i przykłady znajdziesz w przykładowej sekcji. |
releasedEvent.@type |
tekstowy. | Wymagane – pamiętaj, aby zawsze ustawić tę właściwość na jedną z tych wartości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym zdarzeniem. W przypadku PublicationEvent jest to region, w którym opublikowano treść.W przypadku regionów FeaturedEvent i ExclusiveEvent jest to region, w którym treść jest polecana lub dostępna tylko dla subskrybentów.Użyj kodów ISO 3166 dla krajów. Aby wskazać, że jest na całym świecie, ustaw EARTH . |
releasedEvent.startDate |
Data lub DateTime | Zalecany – wymagany w przypadku elementu ExclusiveEvent – data rozpoczęcia publikacji elementu.W przypadku PublicationEvent oznacza datę premiery tego elementu, np. datę premiery filmu w kinie.W przypadku elementów ExclusiveEvent i FeaturedEvent oznacza datę rozpoczęcia dostępności danego elementu. |
releasedEvent.endDate |
Data lub DateTime | Zalecane – Wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent .W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to data ostatniego wykorzystania materiału przez dostawcę.Jeśli treści są bezterminowe lub wyłączne, ustaw endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organizacja lub Osoba | Opcjonalnie – organizacja lub osoba, która opublikowała ten element. |
description |
tekstowy. | Zdecydowanie zalecane dlaczego? Krótki opis sezonu. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. Limit 300 znaków.
|
actor |
[Person, PerformingGroup lub PerformanceRole | Zdecydowanie zalecane dlaczego? Tablica obsady sezonu. Wskazówki dotyczące modelowania znajdziesz tutaj. |
director |
Person | Zdecydowanie zalecane dlaczego? Tablica reżyserów programu. |
producer |
Organizacja lub Osoba | Zdecydowanie zalecane dlaczego? Twórcy sezonu. |
image |
ImageObject | Zdjęcia związane z serialem telewizyjnym. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnianych w zasadzie image znajdziesz w artykule Właściwości obrazu. |
genre |
tekstowy. | Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Action", "Fashion", "Environment", "Football"] |
keywords |
tekstowy. | Słowa kluczowe lub tagi opisujące treść. Dozwolony jest również zestaw słów kluczowych. Na przykład ["feature, bioography"] może być tablicą słów kluczowych opisujących treść. |
trailer.description |
tekstowy. | Opis zwiastuna. Zobacz przykład zwiastuna. |
trailer.inLanguage |
tekstowy. | Język zwiastuna w formacie BCP 47. |
trailer.url |
Adres URL | Adres URL zwiastuna udostępnionego publicznie i przesłanego przez odpowiednie studio produkcyjne lub autoryzowane źródła. |
trailer.regionsAllowed |
Miejsce | Regiony, w których multimedia są dozwolone. Jeśli zasada nie została określona, jest dopuszczana wszędzie. Podaj kraje w formacie ISO 3166. |
identifier |
PropertyValue | Zdecydowanie zalecane dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolonych jest wiele identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora. |
popularityScore |
Specyfikacjapopularności | Zdecydowanie zalecane dlaczego? Wynik wykorzystywany przez Google wraz z innymi sygnałami do określania, które multimedia są odtwarzane użytkownikom. Wynik pokazuje popularność treści w porównaniu z innymi treściami w Twoim katalogu – dlatego skala wyniku musi być spójna we wszystkich kanałach w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
tekstowy. | Zawsze ustawiona na PopularityScoreSpecification . |
popularityScore.value |
Number | Nieujemna wartość liczbowa, która wskazuje popularność danego elementu; wyższy wynik oznacza większą popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których dany wynik popularności ma zastosowanie. Jeśli wynik popularności ma zastosowanie globalnie, ustaw wartość EARTH . Domyślnie ta właściwość ma wartość EARTH . Note: Popularność w poszczególnych regionach ma pierwszeństwo przed globalną (EARTH) popularnością |
review |
Review | Recenzje sezonu serialu |
review.reviewRating |
Ocena | Wymagany, jeśli podano review . Służy do określania oceny podanej w opinii. |
contentRating |
Tekst lub Ocena | Wymagane w przypadku treści dla dorosłych – zdecydowanie zalecane – ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
|
contentRating.author |
Tekst lub Organizacja | Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. Listę akceptowanych agencji znajdziesz na stronie Agencje oceny treści |
contentRating.ratingValue |
tekstowy. | Wymagany, jeśli contentRating używa Rating – wartość oceny. |
contentRating.advisoryCode |
tekstowy. | Kod porad dotyczących treści. Możliwe wartości to D, FV, L, S i V. D = dialog, FV = przemoc fantasy, L = język, S = treści o charakterze seksualnym, V = przemoc. |
Specyfikacja użytkownika
Właściwość actor
typów encji TVSeries
, TVEpisode
i TVSeason
pozwala podać więcej informacji o aktorach, w tym o ich imionach i rolach, które odgrywają w programie. W sekcjach poniżej opisano to samo, wraz z kilkoma przykładami wyjaśniającymi wykorzystanie.
Właściwość | Oczekiwany typ | Opis |
---|---|---|
actor |
Person, PerformingGroup lub PerformanceRole | Zdecydowanie zalecane dlaczego? : tablica członków obsady.
Użyj tablicy do reprezentowania wielu osób, grup wykonujących wykonania lub ról wydajności. |
Typy Person
lub PerformingGroup
Jeśli używasz typu Person lub PerformingGroup, podaj te właściwości
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@type |
Person lub PerformingGroup | Wymagany – zawsze ustawiony na Person lub PerformingGroup. |
@id |
Adres URL | Zdecydowanie zalecane dlaczego? – Identyfikator aktorów lub grupy wykonującej czynność w formacie identyfikatora URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania:
Pamiętaj, że parametr |
name |
tekstowy. | Wymagane – nazwa aktora, aktora, członka obsady lub grupy aktorskiej. |
sameAs |
Adres URL | Zdecydowanie zalecane dlaczego? – adres URL odniesienia do strony internetowej, na której może zostać zidentyfikowany użytkownik lub grupa wykonania, np. strona Wikipedii użytkownika. Ta właściwość musi różnić się od właściwości @id . |
Użycie typu PerformanceRole
Jeśli używasz typu PerformanceRole, podaj te właściwości
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@type |
Rola wydajności | Wymagane – zawsze ma wartość PerformanceRole |
roleName |
tekstowy. | Zdecydowanie zalecane dlaczego? - Rola odgrywana, wykonywanej lub wypełniana przez członka obsady. Listę dopuszczalnych wartości znajdziesz tutaj. |
characterName |
tekstowy. | Imię postaci występującej w rolach aktorskich lub aktorskich. Nie ustawiaj tego pola, jeśli typ aktora to PerformingGroup. |
actor |
Person lub PerformingGroup | Wymagany –
|
actor.@type |
Person lub PerformingGroup | Wymagany – zawsze ustawiony na Person lub PerformingGroup. |
actor.@id |
Adres URL | Zdecydowanie zalecane dlaczego? – Identyfikator aktora lub grupy wykonującej czynność w formacie identyfikatora URI, np. https://example.com/actor/abc. @id musi spełniać te wymagania:
Pamiętaj, że parametr |
actor.name |
tekstowy. | Wymagane – nazwa aktora, aktora, członka obsady lub grupy aktorskiej. |
actor.sameAs |
Adres URL | Zdecydowanie zalecane dlaczego? – adres URL odniesienia do strony internetowej, na której może zostać zidentyfikowany użytkownik lub grupa wykonania, np. strona Wikipedii użytkownika. Ta wartość musi być inna niż właściwość actor.@id. |
Dopuszczalne nazwy ról
Wartości actor.@type
muszą być ustawione na Person
.
Wartość: roleName |
Opis |
---|---|
„Cameo” | Rola epizodowa to krótka prezentacja znanej osoby w sztuce sztuk scenicznych. |
„VoiceActor” | Występy głosowe to akcja aktorska, która nie pojawia się na ekranie. Najczęściej pojawia się w animacji, ale pojawia się też, gdy głos aktora jest dublowany przez przemówienie innego aktora. |
„Podwójna” | Podwójny obraz oznacza inną osobę, która nie pokazuje twarzy. |
„MotionCaptureActor” | MotionCaptureActor to sytuacja, w której osoba nagrywa działania ludzi i wykorzystuje je do animowania cyfrowych modeli postaci w animacjach komputerowych 2D i 3D. |
Wartości te są zwykle akceptowane w przypadku typów Person
i PerformingGroup
.
Wartość: roleName |
Opis |
---|---|
„Użytkownik, który wykonał czynność” | Aktor to osoba, która wciela się w rolę aktora w tradycyjnej kinie lub nowoczesnych mediach, takich jak filmy, audycje radiowe czy telewizyjne. |
„Gwiazda Star” | „Gościnny gość to aktor, który wciela się w postać fikcyjną i pojawia się w 1 lub kilku odcinkach. W niektórych przypadkach gość może odgrywać ważną postać cykliczną i pojawia się wielokrotnie w serii, ale nie należy do głównej obsady. Ustaw wartość „Gwiazda Stara”, gdy występują obsady lub goście występują w programie. Oceny gości należy podawać tylko na poziomie odcinka, a nie na poziomie serialu. |
„Gość” | "Gość w talk show Pamiętaj, że „Gość Starsza” jest fikcyjnym, ale nie gości. |
„Spiker” | Prezenter to osoba, która wprowadza i kończy sceny programu, przedstawia gospodarza, uczestników lub celebrytów, przedstawia dostępne nagrody i zabawa widzów przed atrakcją filmową. |
„Komentator” | Komentator dodaje komentarz w czasie rzeczywistym o grze lub wydarzeniu, zwykle podczas transmisji na żywo. |
„Impresjonista” | Impresjonista lub naśladujący to twórca, którego aktorem jest imitacja dźwięków, głosów i stylów celebrytów oraz postaci z kreskówek. |
„Host” | Osoba, która przedstawia, prowadzi lub hostuje programy telewizyjne, często pełniąc funkcję mediatora w ramach programu i odbiorców. Rola gospodarza nie ma charakteru faktu. |
„Współgospodarz” | Osoba, która organizuje wydarzenie lub program wspólnie z innymi osobami. |
„HostHost” | Gospodarz jest gospodarzem, zwykle w ramach programu talk show, w którym zamiast zwykłego gospodarza odbywa się program. |
„Newscast” | Osoba, która prezentuje lub informuje o wiadomościach i wydarzeniach w lokalnej, krajowej i międzynarodowej skali działalności za pomocą programów informacyjnych. |
„Korespondent” | Korespondent lub osoba zajmująca się sceną znajduje się zwykle w roli reportera lub komentatora czasopisma albo agent, który publikuje artykuły w gazecie, radiu, telewizji lub innego rodzaju biznesie, często na odległość. |
„Sędzia Show” | Sędzia jest osobą, która często jest uznawana za specjalistę w zakresie programu. Pełni rolę sędziego i krytykuje uczestników konkursu, który weźmie udział w aukcji i bierze udział w konkursie serialu telewizyjnego. |
„Panelista” | uczestnik panelu dyskusyjnego lub doradczego w radiu lub telewizji. |
„Konkurs” | Uczestnik zawodu lub teleturnieju to osoba, która w nim uczestniczy. |
„Narrator” | Narracja to osoba, która coś opowiada, zwłaszcza postacia, która przeplata zdarzenia z danego wiersza lub wiersza z narracją. |
„Artysta” | „Wykonawcą muzycznym może być osoba, grupa lub postać fikcyjna, która zwykle występuje regularnie przed publicznością lub nagrywa utwory muzyczne albo albumy muzyczne. Kompozytorzy i tekściarze powinni tworzyć utwory tego typu tylko wtedy, gdy w informacjach o jakichś dziełach muzycznych stwierdzono, że odgrywają one główną rolę. Tego typu możesz używać do powiązania stałych muzyków lub grup muzyków oraz gościnnych muzyków lub grup muzyków do wyświetlania. |
Rozróżnienie głównej i dodatkowej roli aktora
Aby odróżnić głównych, regularnych i dodatkowych gości w programie telewizyjnym, dodaj tylko główną obsadę tylko do elementów TVSeries
, a do treści TVEpisode
– tylko gości. Upewnij się, że podstawowe/regularne przesyłanie nie jest dodane do elementów TVEpisode
.
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"
}
]
}
Przykłady właściwości Actor
Rola użytkownika jest nieznana
Gdy rola aktora jest nieznana, zalecamy podanie informacji o aktorze za pomocą typu Person lub PerformingGroup.
"actor": [
{
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "PerformingGroup",
"@id": "https://example.com/artists/ramones",
"name": "Ramones",
"sameAs": "https://en.wikipedia.org/wiki/Ramones"
}
]
Rola aktora jest znana
Gdy rola użytkownika jest znana, zalecamy podanie informacji o jakimś użytkowniku, przy użyciu 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"
}
}
]
Role znane z podzbioru aktorów
W przypadku metadanych roli wydajności zalecamy podać informacje o podmiocie, używając typu Person lub PerformingGroup W pozostałych przypadkach, gdzie informacje te są znane, wybierz typ PerformanceRole . Te typy 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"
}
]
Powiązane artykuły
Zajrzyj na te tematy, aby znaleźć materiały związane z tymi właściwościami: