W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści dla typu elementu Movie.
Tabela specyfikacji
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | Wymagany – w przypadku filmów zawsze ustawiaj wartość Movie. |
@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 identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
url |
Adres URL | Wymagany – kanoniczny adres URL treści, którego Google używa do dopasowywania treści z pliku danych do treści z baz danych Google.url musi spełniać te wymagania:
urlTemplate obiektu docelowego. |
name |
Text | Wymagany – nazwa filmu.
|
titleEIDR |
Text | Zdecydowanie zalecane (dlaczego?) – identyfikator EIDR (Entertainment Identifier Registry) reprezentujący na najbardziej ogólnym/abstrakcyjnym poziomie film lub program telewizyjny. Na przykład identyfikator titleEIDR filmu „Ghostbusters” to „10.5240/7EC7-228A-510A-053E-CBB8-J”. |
editEIDR |
Text | Zdecydowanie zalecane (dlaczego?) – EIDR (Entertainment Identifier Registry) odpowiadający konkretnej wersji filmu lub programu telewizyjnego. Na przykład film pt. „Ghostbusters” (identyfikator titleEIDR: „10.5240/7EC7-228A-510A-053E-CBB8-J”) ma kilka wersji, np. „10.5240/1F2A-E1C5-680A-14C6-E76B-I” i „10.5240/8A35-3BEE-6497-5D12-9E4F-3”. Właściwość titleEIDR jest wymagana, gdy podano editEIDR. |
potentialAction |
WatchAction (oglądanie) | Wymagany w odpowiednich przypadkach – obiekt znaczników działania zawierający szczegóły działania.
|
sameAs |
Adres URL | Zdecydowanie zalecane (dlaczego?) Adres URL strony referencyjnej, która może zidentyfikować film, np. jego stronę w Wikipedii. Musi się różnić od właściwości url. |
inLanguage |
Text | Oryginalny język filmu w formacie BCP 47. |
genre |
Text | uporządkowana lista wszystkich odpowiednich gatunków. Przykład : ["Akcja", "Moda", "Środowisko", "Piłka nożna"] |
keywords |
Text | Słowa kluczowe lub tagi używane do opisania tych treści. Dozwolona jest też tablica słów kluczowych. Na przykład [„feature, biography”] może być tablicą zawierającą słowa kluczowe opisujące treści. |
releasedEvent |
PublicationEvent, FeaturedEvent lub ExclusiveEvent |
Zdecydowanie zalecane (dlaczego?) – PublicationEvent służy do określenia pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, np. pierwotna data premiery filmu w kinach.Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, wyróżnione, specjalne itp.ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji i określa, gdzie i kiedy.Zobacz szczegóły i przykłady w sekcji z przykładami. |
releasedEvent.@type |
Text | Wymagany – zawsze ustawiaj tę właściwość na jedną z tych wartości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym wydarzeniem. W przypadku PublicationEvent jest to region, w którym treści zostały opublikowane.W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są wyróżnione lub dostępne wyłącznie.Użyj kodów ISO 3166 dla krajów. Aby wskazać wszystkie miejsca na świecie, ustaw wartość EARTH. |
releasedEvent.startDate |
Date lub DateTime | Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu.W przypadku PublicationEvent oznacza to datę premiery tego elementu, np. datę premiery filmu w kinach.W przypadku ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny wyłącznie w danym miejscu lub jako element polecany. |
releasedEvent.endDate |
Date lub DateTime | Zalecane – wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to ostatnia data, w której dostawca wyświetlał element.Jeśli treści są stale dostępne lub są wyróżnione, ustaw wartość endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organization lub Person | Opcjonalnie – organizacja lub osoba, która opublikowała tę jednostkę. |
description |
Text | Zdecydowanie zalecane (dlaczego?) streszczenie filmu; Zamiast streszczenia faktów lepiej użyć streszczenia fabuły. Limit 300 znaków.
|
duration |
Czas trwania | Czas trwania filmu w formacie ISO 8601. Użyj formatu „PT00H00M”. |
director |
Person | Zdecydowanie zalecane (dlaczego?) Reżyser lub reżyserzy filmu. |
actor |
Person | Zdecydowanie zalecane (dlaczego?) Aktorzy grający w filmie. |
producer |
Organization lub Person | Zdecydowanie zalecane (dlaczego?) Producenci filmu. |
image |
ImageObject | Wymagany w Google TV – obrazy związane z filmem. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w artykule Właściwości obrazu. |
trailer.description |
Text | Opis zwiastuna. Zobacz przykład zwiastuna. |
trailer.inLanguage |
Text | Język zwiastuna w formacie BCP 47. |
trailer.url |
Adres URL | Adres URL zwiastuna opublikowanego publicznie i przesłanego przez odpowiednie studia produkcyjne lub autoryzowane źródła. |
trailer.regionsAllowed |
Miejsce | Regiony, w których multimedia są dozwolone. Jeśli nie określisz ich, założymy, że są dozwolone wszędzie. Określ kraje w formacie ISO 3166. |
identifier |
PropertyValue | Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator jednoznacznie identyfikujący ten podmiot. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatorów. |
review |
Opinia | Sprawdź oceny filmu. |
review.reviewRating |
Ocena | Wymagana, jeśli podano opinię. Służy do określenia oceny w opinii. |
contentRating |
Tekst lub Ocena | Wymagane w przypadku treści dla dorosłych, zdecydowanie zalecane w innych przypadkach Dlaczego? – Ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są 2 warianty:
|
contentRating.author |
Organizacja | Wymagany, jeśli contentRating używa Rating – nazwa agencji ratingowej. |
contentRating.ratingValue |
Text | Wymagane, jeśli contentRating używa Rating – wartość oceny. |
contentRating.advisoryCode |
Text | Kod ostrzeżenia dotyczącego treści. Akceptowane wartości to D, FV, L, S i V. D = dialog, FV = przemoc w fantastyce, L = język, S = treści o podtekście seksualnym, V = przemoc. |
popularityScore |
PopularityScoreSpecification | Zdecydowanie zalecane (dlaczego?) Wynik, który Google używa razem z innymi sygnałami do określania, które multimedia wyświetlać użytkownikom. Ten wynik odzwierciedla popularność treści w porównaniu z innymi treściami w katalogu. Dlatego skala wyniku musi być spójna w przypadku wszystkich plików danych i wszystkich elementów w katalogu. Domyślnie wynik popularności elementu jest ustawiony na 0. |
popularityScore.@type |
Text | Zawsze ustawiona na PopularityScoreSpecification. |
popularityScore.value |
Number | Wartość liczbowa większa od zera, która wskazuje popularność elementu. Im wyższa wartość, tym większa popularność. |
popularityScore.eligibleRegion |
Kraj | Regiony, w których obowiązuje ten wynik popularności. Jeśli wynik popularności jest stosowany globalnie, ustaw go na EARTH. Domyślnie ta właściwość jest ustawiona na EARTH. Note: Popularność w danym regionie ma pierwszeństwo przed popularnością globalną (EARTH). |
category |
Text | Wymagany w odpowiednich przypadkach – wypełnij tę właściwość, jeśli element jest wersją Movie. Ustaw category na jedną z tych opcji:
|
workExample |
Film | Określa wersje filmu. Uwzględnij tę właściwość w głównym elemencie Movie, a nie w elementach Movie dla wersji wariantów. |
workExample.@id |
Adres URL | W przypadku wersji Movie ta właściwość podaje @id elementu Movie, którego jest wersją. |
workExample.@type |
Text | Wymagany – zawsze ma wartość Movie. Może to być tablica zawierająca Movie z wieloma wariantami. |
workExample.@id |
Adres URL | Wymagany – @id wariantu Movie. |
workExample.name |
Text | Wymagany – nazwa wariantu Movie. |
workExample.category |
Text | Wymagany: typ wariantu filmu w danej wersji. Ustaw kategorię na jedną z tych opcji:
|
Przykład
Główny film
Film z wersją rozszerzoną.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
Wersja rozszerzona
Rozszerzona wersja filmu głównego.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
Powiązane artykuły
Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: