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 entitas root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama diasumsikan dalam bahasa Spanyol meskipun bahasa subtitle/sulih suara dalam 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 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 Anda menggunakan 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 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 merepresentasikan 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 merepresentasikan pengeditan / edisi tertentu untuk karya film atau televisi. Misalnya, film yang dikenal sebagai "Ghostbusters" yang EIDR judulnya adalah "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 wajib diisi jika editEIDR diberikan.
potentialAction	WatchAction	Wajib jika berlaku - Objek markup Tindakan yang memberikan detail tindakan. Jika konten tersedia di Video on Demand (VoD), properti ini wajib diisi; objek markup Tindakan harus menyediakan deep link konten. Jika konten tersedia di channel LiveTV, properti ini bersifat opsional; entity BroadcastService terkait memberikan deep link channel 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. Nilai ini harus berbeda dari properti url.
inLanguage	Teks	Sangat Direkomendasikan Bahasa asli film dalam format BCP 47.
genre	Teks	Daftar berurutan semua genre yang relevan. Misalnya : ["Aksi", "Mode", "Lingkungan", "Sepak Bola"]
keywords	Teks	Kata kunci atau tag yang digunakan untuk mendeskripsikan konten ini. Array kata kunci juga diizinkan. Misalnya, ["fitur, biografi"] dapat berupa array kata kunci untuk mendeskripsikan konten.
releasedEvent	PublicationEvent, FeaturedEvent, atau ExclusiveEvent	Sangat Direkomendasikan Mengapa? - PublicationEvent digunakan untuk menentukan rilis asli (global atau lokal) konten oleh penayang, seperti tanggal rilis teater asli sebuah film. Selain itu, gunakan FeaturedEvent untuk menunjukkan bahwa layanan Anda memasarkan konten ini sebagai konten asli, unggulan, khusus, dan sebagainya. ExclusiveEvent menentukan bahwa layanan Anda memiliki hak distribusi eksklusif dan mencakup tempat dan waktu. Lihat bagian contoh untuk mengetahui detail dan contohnya.
releasedEvent.@type	Teks	Wajib - Pastikan untuk selalu menyetel properti ini ke salah satu nilai 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 semua tempat 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 eksklusif atau ditampilkan.
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 entity. Jika konten secara eksklusif atau ditampilkan secara terus-menerus, tetapkan endDate hingga 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. Gunakan array untuk menandai deskripsi dalam beberapa bahasa. Lihat contoh Beberapa wilayah dan bahasa.
duration	Durasi	Durasi film dalam format ISO 8601. Gunakan format: "PT00H00M".
director	Orang	Sangat Direkomendasikan Mengapa? Sutradara film.
actor	Orang	Sangat Direkomendasikan Mengapa? 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 disertakan dengan image, lihat Properti gambar.
trailer.description	Teks	Deskripsi cuplikan. Lihat contoh Cuplikan.
trailer.inLanguage	Teks	Sangat Direkomendasikan Bahasa cuplikan dalam format BCP 47.
trailer.url	URL	URL cuplikan yang dihosting secara publik dan diupload oleh studio produksi terkait atau sumber resmi.
trailer.regionsAllowed	Tempat	Wilayah tempat media diizinkan. Jika tidak ditentukan, maka diasumsikan 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	Rating ulasan untuk Film
review.reviewRating	Rating	Wajib jika ulasan diberikan. Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating	Text atau Rating	Wajib untuk konten dewasa, sangat direkomendasikan untuk konten lainnya Mengapa? - Rating konten keseluruhan. Jika rating konten diberikan dalam bentuk string teks, dua variasi diterima: Lembaga pemeringkat ditambahkan ke rating dengan spasi di antaranya. Misalnya, rating "PG-13" dari lembaga "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	Organisasi	Wajib jika contentRating menggunakan Rating - Nama lembaga pemberi rating.
contentRating.ratingValue	Teks	Wajib diisi 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, ditambah sinyal lainnya, untuk menentukan media mana yang akan diputar bagi pengguna. Skor ini menunjukkan popularitas konten dibandingkan dengan konten lain dalam 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 lokalitas lebih diutamakan daripada popularitas global (EARTH)
category	Teks	Wajib diisi jika berlaku - Isi properti ini jika entity adalah varian Movie. Tetapkan category ke salah satu opsi berikut: Home Release: Versi yang dijual atau disewakan 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 disaring oleh MPAA atau lembaga serupa. Director Cut: Versi yang mewakili hasil edit yang disetujui sutradara. Extended Cut: Versi yang lebih panjang 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 memberikan @id dari entitas Movie yang merupakan varian ini.
workExample.@type	Teks	Wajib - Selalu ditetapkan ke Movie. Hal ini dapat direpresentasikan sebagai array untuk Movie dengan beberapa varian.
workExample.@id	URL	Wajib - @id 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 disewakan 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 disaring oleh MPAA atau lembaga serupa. Director Cut: Versi yang mewakili hasil edit yang disetujui sutradara. Extended Cut: Versi yang lebih panjang dari rilis bioskop.

Contoh

Film utama

Film dengan varian versi 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"
  }
}

Varian potongan panjang

Versi extended cut 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"
}

Halaman terkait

Lihat halaman berikut untuk mengetahui topik yang terkait dengan properti ini:

• Mengidentifikasi jenis entitas konten Anda
• Kumpulkan ID, URL, dan nama konten Anda
• Mengumpulkan metadata konten Anda