Właściwości znaczników filmów

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku typu encji Movie.

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@context tekstowy. Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
  • Gdzie „xx” oznacza język ciągów znaków w pliku danych. Każdy kontekst główny jednostki powinien mieć ustawiony język @language w formacie BCP 47. Jeśli np. język to hiszpański, zakłada się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów jest w języku angielskim.
@type tekstowy. Wymagane – 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:
  • Niepowtarzalny na całym świecie katalog
  • Statyczny – identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli właściwość adresu URL programu się zmienia). Będzie on traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem.
  • W formie identyfikatora ujednoliconego zasobu (URI)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
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:
  • url musi być globalnie niepowtarzalna
  • url musi zawierać działający kanoniczny URL, który Google może indeksować.
Szczegółowe informacje o precyzyjnych linkach odtwarzania znajdziesz w opisie właściwości target obiektu urlTemplate.
name tekstowy. Wymagane – nazwa filmu.
  • Użyj tablicy do wyświetlenia nazw w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego języka obsługiwana jest tylko jedna nazwa (para język–kraj).
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 filmu ruchomego o nazwie „Pogromcy duchów” to „10.5240/7EC7-228A-510A-053E-CBB8-J”.
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 film ruchomy znany jako „Pogromcy duchów”, którego tytuł EIDR to „10.5240/7EC7-228A-510A-053E-CBB8-J”, zawiera kilka zmian, takich jak „10.5240/1F2A-E1C5-680A-14C6-E74B”44”.

Właściwość titleEIDR jest wymagana, jeśli podano właściwość EditEIDR.
potentialAction WatchAction (oglądanie) Wymagany, jeśli ma zastosowanie – obiekt znaczników działania, który zawiera szczegóły działania.
  • Jeśli treści są dostępne w filmach na żądanie (VoD), ta właściwość jest wymagana. Obiekt znaczników akcji musi zawierać precyzyjny link.
  • Jeśli treści są dostępne na kanale LiveTV, ta właściwość jest opcjonalna, ponieważ powiązany element BroadcastService dostarcza precyzyjny link do kanału.
  • Movie może być dostępne zarówno w usługach VoD, jak i LiveTV.
Użyj tablicy, aby określić różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
sameAs Adres URL Zdecydowanie zalecane dlaczego? Adres URL referencyjnej strony internetowej umożliwiającej identyfikację filmu, np. strony Wikipedii dotyczącej filmu. Ta właściwość musi różnić się od właściwości url.
inLanguage tekstowy. Oryginalny język filmu 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 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:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 filmu. Streszczenia faworytów są preferowane w przypadku podsumowań faktów. 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 filmu.
actor Person Zdecydowanie zalecane dlaczego? Członkowie obsady filmu.
producer Organizacja lub Osoba Zdecydowanie zalecane dlaczego? Producent filmu.
image ImageObject Wymagane w przypadku Google TV – obrazy związane z filmem. 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.
review Review Recenzje filmu
review.reviewRating Ocena Wymagane, jeśli opinia została przesłana. Pozwala określić ocenę przyznaną w opinii.
contentRating Tekst lub Ocena Wymagany w przypadku treści dla dorosłych, zdecydowanie zalecany w innych przypadkach Dlaczego? – Ogólna ocena treści. Jeśli ocena treści jest podana w postaci ciągu tekstowego, akceptowane są te 2 warianty:
  • Agencja oceniająca dołącza na początku ocenę, rozdzielając je spacjami. Na przykład ocena „PG-13” przyznawana przez agencję „MPAA” w USA powinna być określona jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana) wskazuje, że nie znasz oceny filmu.
contentRating.author Tekst lub Organizacja Wymagany, jeśli contentRating używa Rating – nazwa agencji oceniającej.
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.
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ą
category tekstowy. Wymagany, jeśli ma zastosowanie – wypełnij tę właściwość, jeśli element jest wariantem Movie. Ustaw category na dowolną z tych wartości:
  • Home Release: wersja sprzedana lub wypożyczona do oglądania w domu.
  • Theatrical Release: wersja premierowa w kinach.
  • International Release: wersja edytowana w celu udostępnienia jej w wielu krajach.
  • Remastered: wersja, której obrazy, dźwięk lub oba te elementy są ulepszone i bardziej aktualne.
  • Unrated: wersja, która nie została sprawdzona przez MPAA lub podobną agencję.
  • Director Cut: wersja, która reprezentuje zatwierdzoną zmianę reżysera.
  • Extended Cut: wersja, która jest dłuższa niż premiera kinowa.
workExample Film Określa warianty filmu. Umieść tę właściwość w głównym elemencie Movie, a nie w elementach Movie w wersjach wariantu.
workExample.@id Adres URL W przypadku Movie właściwość ta udostępnia właściwość @id elementu Movie, która jest wersją.
workExample.@type tekstowy. Wymagane – zawsze ma wartość Movie. Ten wykres może mieć postać tablicy Movie z wieloma wariantami.
workExample.@id Adres URL Wymagany – wartość @id wariantu Movie.
workExample.name tekstowy. Wymagany – nazwa wariantu Movie.
workExample.category tekstowy. Wymagany – typ wariantu filmu w danej wersji. Ustaw kategorię na dowolną z tych opcji:
  • Home Release: wersja sprzedana lub wypożyczona do oglądania w domu.
  • Theatrical Release: wersja premierowa w kinach.
  • International Release: wersja edytowana w celu udostępnienia jej w wielu krajach.
  • Remastered: wersja, której obrazy, dźwięk lub oba te elementy są ulepszone i bardziej aktualne.
  • Unrated: wersja, która nie została sprawdzona przez MPAA lub podobną agencję.
  • Director Cut: wersja, która reprezentuje zatwierdzoną zmianę reżysera.
  • Extended Cut: wersja, która jest dłuższa niż premiera kinowa.

Przykład

Główny film

Film z dłuższym 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"
  }
}

Rozszerzony wariant cięcia

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

Zajrzyj na te tematy, aby znaleźć materiały związane z tymi właściwościami: