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 tetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Dalam hal ini, "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah 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). Token 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 yang 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 lokal (pasangan bahasa-negara).
titleEIDR Teks Sangat Direkomendasikan Mengapa? - ID EIDR (Entertainment Identifier Registry) yang mewakili tingkat yang paling umum/abstrak, karya film atau televisi.

Misalnya, titleEIDR untuk film dengan kategori "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" yang titleEIDR-nya adalah "10.5240/7EC7-228A-510A-053E-CBB8-J", memiliki beberapa pengeditan, misalnya "10.5240/1F2A-E-B-A-3-4A4C-A5E7E-B5cF7 yang begitu menyenangkan.

Properti titleEIDR diperlukan saat editEIDR diberikan.
potentialAction WatchAction Wajib jika berlaku - Objek markup tindakan yang menyediakan detail tindakan.
  • Jika konten tersedia di Video on Demand (VoD), properti ini wajib ada; objek markup Tindakan harus menyediakan deep link konten.
  • Jika konten tersedia di saluran TV Live, properti ini bersifat opsional; entitas BroadcastService terkait menyediakan 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 tersebut. Ini harus berbeda dari properti url.
inLanguage Teks Bahasa asli film dalam format BCP 47.
genre Teks Daftar terurut 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 asli (global atau lokal) konten oleh penerbit, seperti tanggal rilis bioskop asli 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 menyertakan tempat dan waktu.

Lihat bagian contoh untuk mengetahui detail dan contohnya.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan properti ini ke salah satu properti 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, ini menunjukkan tanggal rilis awal entitas ini, seperti tanggal film pertama kali dirilis di bioskop.

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

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

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

Jika konten bersifat eksklusif atau eksklusif, tetapkan endDate ke 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organisasi atau Orang Opsional - Organisasi atau orang yang memublikasikan entitas ini.
description Teks Sangat Direkomendasikan Mengapa? Sinopsis film. Sintesis plot lebih disukai untuk ringkasan faktual. Batas karakter 300.
duration Durasi Runtime film dalam format ISO 8601. Harap gunakan format: "PT00H00M".
director Person Sangat Direkomendasikan Mengapa? Sutradara film.
actor Person Sangat Direkomendasikan Mengapa? Anggota pemeran film.
producer Organisasi atau Orang Sangat Direkomendasikan Mengapa? Produser film.
image ImageObject Wajib untuk Google TV - Gambar yang terkait dengan Film. Untuk 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 untuk publik dan diupload oleh studio produksi atau sumber resmi masing-masing.
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 peninjauan tersedia. Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan jika tidak Mengapa? - Peringkat konten secara keseluruhan. Jika rating konten diberikan dalam bentuk string teks, ada dua variasi yang diterima:
  • Lembaga rating ditambahkan ke rating dengan spasi kosong di antaranya. Misalnya, rating "PG-13" 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 tahu rating untuk Filmnya.
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 PopularitasSkorSpesifikasi Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar bagi pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed Anda, di antara semua entitas di katalog Anda. Secara default, skor popularitas entitas ditetapkan ke 0.
popularityScore.@type Teks Selalu disetel 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 lokal lebih diutamakan daripada popularitas global (EARTH)
category Teks Wajib jika berlaku - Isi properti ini jika entitas adalah varian Movie. Tetapkan category ke salah satu dari berikut:
  • Home Release: Versi yang dijual atau disewa untuk dilihat 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 diseleksi oleh MPAA atau agensi serupa.
  • Director Cut: Versi yang mewakili edit yang disetujui oleh sutradara.
  • Extended Cut: Versi yang lebih panjang dari rilis bioskop.
workExample Film Menentukan varian film. Sertakan properti ini di entitas Movie utama, bukan entitas Movie untuk versi varian.
workExample.@id URL Untuk varian Movie, properti ini menyediakan @id dari entitas Movie yang merupakan varian.
workExample.@type Teks Wajib - Selalu tetapkan 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 kategori berikut:
  • Home Release: Versi yang dijual atau disewa untuk dilihat 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 diseleksi oleh MPAA atau agensi serupa.
  • Director Cut: Versi yang mewakili edit yang disetujui oleh sutradara.
  • 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 diperluas

Versi potongan 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: