Properti markup konten film

Bagian ini memberikan detail properti markup konten untuk jenis entitas Movie.

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Di mana" xx" mewakili bahasa string dalam feed. Setiap konteks root entity harus memiliki @language-nya yang disetel ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama dianggap sebagai bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah bahasa Inggris.
@type Teks Wajib - Selalu ditetapkan ke Movie untuk film.
@id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
@id harus memenuhi persyaratan berikut:
  • Unik secara global di seluruh katalog Anda
  • Statis; ID harus stabil dan tidak berubah dari waktu ke waktu (meskipun jika properti URL acara berubah). String ini akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda.
Karena url entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
url URL Wajib - URL kanonis konten, yang digunakan Google untuk mencocokkan konten di feed Anda dengan konten di database Google.
url harus memenuhi persyaratan berikut:
  • url harus unik secara global
  • url harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.
Untuk deep link pemutaran, lihat properti urlTemplate objek target.
name Teks Wajib - Nama film.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
titleEIDR Teks Sangat Direkomendasikan Mengapa? - ID EIDR (Entertainment Identifier Registry) yang mewakili tingkat paling umum/abstrak, suatu karya film atau televisi.

Misalnya, judulEIDR untuk film yang dikenal sebagai "Ghostbusters" adalah "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Teks Sangat Direkomendasikan Mengapa? - ID EIDR (Entertainment Identifier Registry) yang mewakili pengeditan / edisi tertentu untuk sebuah karya film atau televisi.

Misalnya, film yang dikenal sebagai "Ghostbusters" yang titleEIDR adalah "10.5240/7EC7-228A-510A-053E-CBB8-J", memiliki beberapa pengeditan mis. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" dan "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

titleEIDR Properti wajib diisi jika editEIDR diberikan.
potentialAction WatchAction Wajib jika berlaku - Objek markup Action yang memberikan detail tindakan.
  • Jika konten tersedia di Video on Demand (VoD), properti ini wajib ada; objek markup Action harus menyediakan deep link konten.
  • Jika konten tersedia di channel LiveTV, properti ini bersifat opsional; Sebagai gantinya, entity BroadcastService terkait memberikan deep link ke saluran tersebut.
  • Movie dapat tersedia di VoD dan LiveTV.
Gunakan array untuk menentukan deep link yang berbeda di beberapa wilayah. Lihat contoh Beberapa wilayah dan bahasa.
sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman web referensi yang dapat mengidentifikasi film; misalnya, halaman Wikipedia film tersebut. Properti ini harus berbeda dari properti url.
inLanguage Teks Bahasa asli film dalam format BCP 47.
genre Teks Daftar berurutan dari semua genre yang relevan. Misalnya : ["Action", "Fashion", "Environment", "Football"]
keywords Teks Kata kunci atau tag yang digunakan untuk mendeskripsikan konten ini. Rangkaian kata kunci juga diizinkan. Misalnya, ["fitur, biografi"] dapat berupa array kata kunci untuk mendeskripsikan kontennya.
releasedEvent PublicationEvent, FeaturedEvent, atau ExclusiveEvent Sangat Direkomendasikan Mengapa? - PublicationEvent digunakan untuk menentukan rilis asli (global atau lokal) konten oleh penerbit, seperti tanggal rilis film yang di bioskop.

Selain itu, gunakan FeaturedEvent untuk menunjukkan bahwa layanan Anda memasarkan konten ini sebagai asli, unggulan, khusus, dan sebagainya.

ExclusiveEvent menetapkan bahwa layanan Anda memiliki hak distribusi eksklusif dan menyertakan tempat dan contohnya.

Lihat bagian contoh untuk detail dan contoh.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan properti ini ke salah satu dari yang berikut:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Negara Wajib - Wilayah yang terkait dengan acara ini.

Untuk PublicationEvent, ini adalah wilayah tempat konten dipublikasikan.

Untuk FeaturedEvent dan ExclusiveEvent, ini adalah wilayah tempat konten ditampilkan atau eksklusif.

Gunakan kode ISO 3166 untuk negara. Untuk menunjukkan di mana saja di seluruh dunia, tetapkan ke EARTH.
releasedEvent.startDate Date atau DateTime Direkomendasikan - Wajib untuk ExclusiveEvent - Tanggal mulai publikasi entitas.

Untuk PublicationEvent, tanggal ini menunjukkan tanggal rilis awal entitas ini, seperti tanggal film pertama kali dirilis di bioskop.

Untuk ExclusiveEvent dan FeaturedEvent, tanggal ini menunjukkan tanggal mulai saat entitas eksklusif atau diunggulkan.
releasedEvent.endDate Date atau DateTime Direkomendasikan - Wajib untuk ExclusiveEvent - Ini hanya berlaku untuk jenis ExclusiveEvent dan FeaturedEvent.

Untuk ExclusiveEvent, ini menunjukkan tanggal saat hak atas konten berakhir.

Untuk FeaturedEvent, ini menunjukkan tanggal terakhir saat penyedia menampilkan entitas.

Jika konten bersifat eksklusif atau unggulan selamanya, setel endDate ke 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organisasi atau Individu Opsional - Organisasi atau orang yang memublikasikan entitas ini.
description Teks Sangat Direkomendasikan Mengapa? Sinopsis filmnya. Sinopsis plot lebih disukai daripada ringkasan faktual. Batas 300 karakter.
duration Durasi Runtime film dalam format ISO 8601. Gunakan format: "PT00H00M".
director Orang Sangat Direkomendasikan Mengapa? Sutradara film.
actor Orang Sangat Direkomendasikan Mengapa? Anggota pemeran film.
producer Organisasi atau Individu Sangat Direkomendasikan Mengapa? Produser film.
image ImageObject Diperlukan untuk Google TV - Gambar yang terkait dengan Film. Untuk detail selengkapnya tentang properti wajib dan opsional yang perlu disertakan dengan image, lihat Properti gambar.
trailer.description Teks Deskripsi cuplikan. Lihat contoh Trailer.
trailer.inLanguage Teks Bahasa cuplikan dalam format BCP 47.
trailer.url URL URL cuplikan yang dihosting secara publik dan diupload oleh studio produksi masing-masing atau sumber resmi.
trailer.regionsAllowed Tempat Wilayah tempat media diizinkan. Jika tidak ditentukan, layanan dianggap diizinkan di mana saja. Tentukan negara dalam format ISO 3166.
identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID Eksternal atau ID lain yang secara jelas mengidentifikasi entitas ini. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.
review Ulasan Tinjau rating Film
review.reviewRating Rating Wajib diisi jika peninjauan diberikan. Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan jika tidak Mengapa? - Rating konten secara keseluruhan. Jika rating konten diberikan dalam bentuk string teks, dua variasi dapat diterima:
  • Lembaga rating menambahkan spasi kosong di antaranya sebelum rating ditambahkan. Misalnya, "PG-13" rating dari agensi "MPAA" di Amerika Serikat harus dideskripsikan sebagai "MPAA PG-13". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak mengetahui rating Film.
contentRating.author Teks atau Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating.
contentRating.ratingValue Teks Wajib jika contentRating menggunakan Rating - Nilai rating.
contentRating.advisoryCode Teks Kode saran untuk konten. Nilai yang diterima termasuk D, FV, L, S, dan V. D = Dialog, FV = Kekerasan Fantasi , L = Bahasa, S = Konten Seksual, V = Kekerasan.
popularityScore PopularityScoreSpecification Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten dalam kaitannya dengan konten lain di katalog Anda; Oleh karena itu, skala skor harus konsisten di seluruh feed Anda, di antara semua entitas dalam katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
popularityScore.@type Teks Selalu ditetapkan ke PopularityScoreSpecification.
popularityScore.value Number Nilai numerik non-negatif yang menunjukkan popularitas entitas; skor yang lebih tinggi berarti popularitas yang lebih tinggi.
popularityScore.eligibleRegion Negara Wilayah tempat skor popularitas ini berlaku. Jika skor popularitas berlaku secara global, tetapkan ke EARTH. Secara default, properti ini ditetapkan ke EARTH.
Note: Popularitas khusus lokal lebih diutamakan daripada popularitas global (EARTH)
category Teks Wajib jika berlaku - Isi properti ini jika entitas merupakan varian Movie. Tetapkan category ke salah satu dari nilai berikut:
  • Home Release: Versi yang dijual atau disewa untuk ditonton di rumah.
  • Theatrical Release: Versi yang dirilis di bioskop.
  • International Release: Versi yang diedit untuk dirilis secara internasional.
  • Remastered: Versi yang gambar, suara, atau keduanya telah ditingkatkan kualitasnya ke standar yang lebih baru.
  • Unrated: Versi yang tidak disaring oleh MPAA atau lembaga serupa.
  • Director Cut: Versi yang merepresentasikan hasil edit yang disetujui oleh direktur.
  • Extended Cut: Versi yang lebih panjang dari rilis bioskop.
workExample Film Menentukan varian film. Sertakan properti ini dalam entity Movie utama, bukan entity Movie untuk versi varian.
workExample.@id URL Untuk varian Movie, properti ini memberikan @id entity Movie yang merupakan varian tersebut.
workExample.@type Teks Wajib - Selalu ditetapkan ke Movie. Ini dapat direpresentasikan sebagai array untuk Movie dengan beberapa varian.
workExample.@id URL Wajib - @id dari varian Movie.
workExample.name Teks Wajib - Nama varian Movie.
workExample.category Teks Wajib - Jenis varian film dari versi tertentu. Tetapkan kategori ke salah satu dari berikut ini:
  • Home Release: Versi yang dijual atau disewa untuk ditonton di rumah.
  • Theatrical Release: Versi yang dirilis di bioskop.
  • International Release: Versi yang diedit untuk dirilis secara internasional.
  • Remastered: Versi yang gambar, suara, atau keduanya telah ditingkatkan kualitasnya ke standar yang lebih baru.
  • Unrated: Versi yang tidak disaring oleh MPAA atau lembaga serupa.
  • Director Cut: Versi yang merepresentasikan hasil edit yang disetujui oleh direktur.
  • Extended Cut: Versi yang lebih panjang dari rilis bioskop.

Contoh

Film utama

Film dengan varian potongan yang diperluas.

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

Varian potongan yang diperluas

Versi potongan yang diperluas dari film utama.

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

Lihat halaman berikut untuk topik yang terkait dengan properti ini: