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 typu elementu Movie.

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@context Tekst Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
    .
  • Gdzie” xx” odpowiada językowi ciągów znaków w pliku danych. Każdy kontekst elementu głównego powinien mieć parametr @language ustawiony na odpowiedni kod języka w formacie BCP 47. Jeśli na przykład język jest ustawiony na hiszpański, przyjmuje się, że nazwy są w języku hiszpańskim, nawet jeśli język napisów lub dubbingu jest w języku angielskim.
@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:
  • Produkt unikalny w całym katalogu
  • statyczny; Identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Zostanie on potraktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W formacie URI (Unified Resource Identifier)
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut 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:
  • Pole url musi być unikalne globalnie
  • Plik url musi zawierać działający kanoniczny URL, który Google może zindeksować.
W przypadku precyzyjnego linku odtwarzania zapoznaj się z właściwością urlTemplate obiektu docelowego.
name Tekst Wymagany – tytuł filmu.
  • Użyj tablicy, aby wyświetlić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) obsługiwana jest tylko jedna nazwa.
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.
  • Jeśli treść jest dostępna w ramach funkcji Wideo na żądanie (VoD), ta właściwość jest wymagana. obiekt znaczników Action musi zawierać precyzyjny link do treści.
  • Jeśli treści są dostępne na kanale LiveTV, właściwość ta jest opcjonalna. powiązany element BroadcastService zawiera precyzyjny link do kanału.
  • Element Movie może być dostępny zarówno w VD, jak i LiveTV.
Za pomocą tablicy określ różne precyzyjne linki w wielu regionach. Zobacz przykład Wiele regionów i języków.
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:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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:
  • Agencja oceniająca została dodana do oceny ze spacją pomiędzy. Przykład: „PG-13” ocena agencji „MPAA” w USA powinna być oznaczona jako „MPAA PG-13”. Zobacz listę agencji.
  • Wartość „RATING NOT KNOWN” (wielkość liter nie jest rozróżniana), aby wskazać, że nie znasz oceny filmu.
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:
  • Home Release: wersja sprzedana lub wypożyczona do oglądania w domu.
  • Theatrical Release: wersja udostępniona w kinie.
  • International Release: wersja zmieniona w celu udostępnienia międzynarodowej.
  • Remastered: wersja, w której obrazy, dźwięk lub oba te elementy zostały ulepszone do bardziej aktualnego standardu.
  • Unrated: wersja, która nie została sprawdzona przez MPAA ani podobną agencję.
  • Director Cut: wersja, która reprezentuje zatwierdzoną zmianę reżysera.
  • Extended Cut: wersja, która jest dłuższa niż kinowa.
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:
  • Home Release: wersja sprzedana lub wypożyczona do oglądania w domu.
  • Theatrical Release: wersja udostępniona w kinie.
  • International Release: wersja zmieniona w celu udostępnienia międzynarodowej.
  • Remastered: wersja, w której obrazy, dźwięk lub oba te elementy zostały ulepszone do bardziej aktualnego standardu.
  • Unrated: wersja, która nie została sprawdzona przez MPAA ani podobną agencję.
  • Director Cut: wersja, która reprezentuje zatwierdzoną zmianę reżysera.
  • Extended Cut: wersja, która jest dłuższa niż kinowa.

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

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami: