Properti markup konten film

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

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Dengan"xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
@type Teks Wajib - Selalu tetapkan 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 properti URL acara berubah). URL 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 entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity 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 bahasa yang berbeda. 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 karya film atau televisi pada tingkat yang paling umum/abstrak.

Misalnya, titleEIDR 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 karya film atau televisi.

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

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

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

ExclusiveEvent menentukan bahwa layanan Anda memiliki hak distribusi eksklusif dan menyertakan tempat dan waktu.

Lihat bagian contoh untuk mengetahui detail dan contoh.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan properti ini ke salah satu dari hal berikut:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Negara Wajib - Wilayah yang terkait dengan peristiwa 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 dunia, tetapkan ke EARTH.
releasedEvent.startDate Date atau DateTime Direkomendasikan - Wajib untuk ExclusiveEvent - Tanggal mulai publikasi entity.

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

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

Untuk ExclusiveEvent, ini menunjukkan tanggal berakhirnya hak atas konten.

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

Jika konten bersifat eksklusif atau ditampilkan secara permanen, tetapkan endDate ke 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organization atau Person Opsional - Organisasi atau orang yang memublikasikan entitas ini.
description Teks Sangat Direkomendasikan Mengapa? Sinopsis film. 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 Organization atau Person Sangat Direkomendasikan Mengapa? Produser film.
image ImageObject Wajib untuk Google TV - Gambar yang terkait dengan Film. Untuk mengetahui detail selengkapnya tentang properti wajib dan opsional yang akan disertakan dengan image, lihat Properti gambar.
trailer.description Teks Deskripsi cuplikan. Lihat contoh Cuplikan.
trailer.inLanguage Teks Bahasa cuplikan dalam format BCP 47.
trailer.url URL URL cuplikan yang dihosting secara publik dan diupload oleh studio produksi atau sumber resmi masing-masing.
trailer.regionsAllowed Tempat Wilayah tempat media diizinkan. Jika tidak ditentukan, video diasumsikan diizinkan di mana saja. Tentukan negara dalam format ISO 3166.
identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang secara jelas menunjukkan entitas ini. Beberapa ID diizinkan. Lihat bagian Properti ID untuk mengetahui detailnya.
review Ulasan Meninjau rating untuk Film
review.reviewRating Rating Wajib ada jika ulasan diberikan. Kolom ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Text 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 akan diterima:
  • Lembaga pemeringkat ditambahkan di awal rating dengan spasi kosong di antaranya. Misalnya, rating "PG-13" dari lembaga "MPAA" di Amerika Serikat harus dijelaskan sebagai "MPAA PG-13". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak mengetahui rating untuk Film.
contentRating.author 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 mencakup 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, beserta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed, di antara semua entitas di 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 lokalitas lebih diutamakan daripada popularitas global (EARTH)
category Teks Wajib diisi jika ada - Isi properti ini jika entity adalah varian Movie. Tetapkan category ke salah satu opsi 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 ditingkatkan ke standar yang lebih baru.
  • Unrated: Versi yang tidak diputar oleh MPAA atau lembaga serupa.
  • Director Cut: Versi yang mewakili hasil edit sutradara yang disetujui.
  • Extended Cut: Versi yang berdurasi lebih lama dari rilis bioskop.
workExample Film Menentukan varian film. Sertakan properti ini dalam entitas Movie utama, bukan entitas Movie untuk versi varian.
workExample.@id URL Untuk varian Movie, properti ini menyediakan @id dari entitas Movie yang merupakan variannya.
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 opsi 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 ditingkatkan ke standar yang lebih baru.
  • Unrated: Versi yang tidak diputar oleh MPAA atau lembaga serupa.
  • Director Cut: Versi yang mewakili hasil edit sutradara yang disetujui.
  • Extended Cut: Versi yang berdurasi lebih lama dari rilis bioskop.

Contoh

Film dengan varian potongan panjang.

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

Versi film utama yang dipotong panjang.

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