W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści typu elementu Movie.
Tabela specyfikacji
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Tekst | Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
|
@type |
Tekst | Wymagany – w przypadku filmów zawsze ma wartość Movie. |
@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 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 | Wymagany – kanoniczny 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:
urlTemplate obiektu docelowego. |
name |
Tekst | Wymagany – tytuł filmu.
|
titleEIDR |
Tekst | Dlaczego warto wybrać – EIDR (Entertainment Identifier Registry) – identyfikator na najbardziej ogólnym lub abstrakcyjnym poziomie, film lub telewizja. Na przykład identyfikator EIDR filmu kinowego „Pogromcy duchów” to „10.5240/7EC7-228A-510A-053E-CBB8-J”. |
editEIDR |
Tekst | Dlaczego warto wybrać – EIDR (Entertainment Identifier Registry) – identyfikator określający konkretną edycję lub edycję utworu filmowego lub telewizyjnego. Na przykład film kinowy pod nazwą „Pogromcy duchów” którego nazwa EIDR to „10.5240/7EC7-228A-510A-053E-CBB8-J”, ma kilka zmian, np. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" i „10.5240/8A35-3BEE-6497-5D12-9E4F-3”. Jeśli podano parametr EditEIDR, wymagana jest właściwość titleEIDR. |
potentialAction |
WatchAction (oglądanie) | Wymagany, jeśli dotyczy – obiekt znaczników działania, który zawiera szczegóły działania.
|
sameAs |
Adres URL | Dlaczego warto wybrać Adres URL referencyjnej strony internetowej, która może zidentyfikować film. na przykład stronę filmu w Wikipedii. Musi się ona różnić od właściwości url. |
inLanguage |
Tekst | Oryginalny język filmu w formacie BCP 47. |
genre |
Tekst | Uporządkowana lista wszystkich odpowiednich gatunków. Na przykład : ["Akcja", "Moda", "Środowisko", "Piłka nożna"] |
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 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:
|
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 | Zalecane – wymagane 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 | 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 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 filmu. Preferowane są streszczenia fabuły. Limit 300 znaków.
|
duration |
Czas trwania | Czas trwania filmu w formacie ISO 8601. Użyj formatu „PT00H00M”. |
director |
Person | Dlaczego warto wybrać Reżyser filmu. |
actor |
Person | Dlaczego warto wybrać Członkowie obsady filmu. |
producer |
Organizacja lub Osoba | Dlaczego warto wybrać Producenci filmu. |
image |
ImageObject | Wymagany w przypadku Google TV – obrazy powiązane z filmem. 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. |
review |
Review | Oceny filmu |
review.reviewRating |
Ocena | Wymagany w przypadku przesłania opinii. Służy do określenia oceny podanej w opinii. |
contentRating |
Tekst lub Ocena | Wymagane w przypadku treści dla dorosłych, a w przeciwnym razie zdecydowanie zalecane Dlaczego? – Ogólna ocena treści. Jeśli ocena treści jest podana w formie ciągu tekstowego, akceptujemy 2 odmiany:
|
contentRating.author |
Organizacja | Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej. |
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. |
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) |
category |
Tekst | Wymagane, jeśli dotyczy – wypełnij tę właściwość, jeśli element jest wariantem Movie. Ustaw category na dowolną z tych wartości:
|
workExample |
Film | Określa warianty filmu. Uwzględnij tę właściwość w głównym elemencie Movie, a nie w elementach Movie w wersjach wariantów. |
workExample.@id |
Adres URL | W przypadku wariantów atrybutu Movie ta właściwość udostępnia właściwość @id elementu Movie, którego jest wariantem. |
workExample.@type |
Tekst | Wymagane – zawsze ma wartość Movie. Może ona mieć postać tablicy dla elementu Movie z wieloma wariantami. |
workExample.@id |
Adres URL | Wymagany – wartość @id wariantu Movie. |
workExample.name |
Tekst | Wymagany – nazwa wariantu Movie. |
workExample.category |
Tekst | Wymagany – typ wariantu kliszy danej wersji. Ustaw kategorię na dowolną z tych wartości:
|
Przykład
Główny film
Film z rozszerzonym cięciem.
{
"@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"
}
}
Wariant o dłuższym kroju
Rozszerzona wersja głównego filmu.
{
"@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
Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: