Właściwości znaczników treści w filmach

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"}]
  • Gdzie „xx” oznacza język ciągów w pliku danych. Każdy kontekst elementu wyższego poziomu powinien mieć ustawioną wartość @language na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład ustawisz język hiszpański, nazwy będą w tym języku, nawet jeśli język napisów lub dubbingu to angielski.
@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:
  • Niepowtarzalny na całym świecie w katalogu.
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość adresu URL programu). Jest on traktowany jako ciąg nieprzejrzysty, więc nie musi być działającym linkiem.
  • w formie ujednoliconego identyfikatora zasobu (URI);
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Ponieważ 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:
  • url musi być globalnie niepowtarzalny
  • url musi zawierać działający kanoniczny adres URL, który Google może zindeksować.
Aby uzyskać dostęp do precyzyjnego linku odtwarzania, użyj właściwości urlTemplate obiektu docelowego.
name Text Wymagany – nazwa filmu.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
  • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
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.
  • Jeśli treści są dostępne w ramach usługi wideo na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników działania musi zawierać link do treści.
  • Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna; powiązany element BroadcastService zawiera link do kanału.
  • Movie może być dostępny zarówno w przypadku VoD, jak i LiveTV.
Aby określić różne precyzyjne linki w różnych regionach, użyj tablicy. Zobacz przykład dotyczący wielu regionów i języków.
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:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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:
  • Agencja ratingowa dołączyła do oceny znak odstępu. Na przykład ocena „PG-13” przyznana przez agencję „MPAA” w Stanach Zjednoczonych powinna być opisana jako „MPAA PG-13”. Zobacz listę agencji.
  • wartość „RATING NOT KNOWN” (bez rozróżniania wielkości liter), aby wskazać, że nie znasz oceny filmu;
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:
  • Home Release: wersja sprzedawana lub wypożyczana do oglądania w domu.
  • Theatrical Release: wersja wydana w kinach.
  • International Release: wersja zmodyfikowana na potrzeby międzynarodowego wydania.
  • Remastered: wersja, w której obrazy, dźwięk lub oba te elementy zostały ulepszone do najnowszego standardu.
  • Unrated: wersja, która nie została zweryfikowana przez MPAA lub podobną agencję.
  • Director Cut: wersja, która przedstawia zatwierdzone przez reżysera zmiany.
  • Extended Cut: wersja dłuższa niż ta, która trafiła do kin.
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:
  • Home Release: wersja sprzedawana lub wypożyczana do oglądania w domu.
  • Theatrical Release: wersja wydana w kinach.
  • International Release: wersja zmodyfikowana na potrzeby międzynarodowego wydania.
  • Remastered: wersja, w której obrazy, dźwięk lub oba te elementy zostały ulepszone do najnowszego standardu.
  • Unrated: wersja, która nie została zweryfikowana przez MPAA lub podobną agencję.
  • Director Cut: wersja, która przedstawia zatwierdzone przez reżysera zmiany.
  • Extended Cut: wersja dłuższa niż ta, która trafiła do kin.

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"
}

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami: