Properti markup konten acara TV

Bagian ini memberikan detail properti markup konten untuk jenis entity TVSeries, TVEpisode, dan TVSeason.

Menyediakan TVSeason sebagai entity lengkap bersifat opsional. Lihat bagian Relasi TVSeries, TVSeries, dan TVEpisode untuk mengetahui detailnya.

Tabel spesifikasi

TVSeries

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 disetel ke @language 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 TVSeries.
@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
  • 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 acara.
  • 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 TVSeries yang dikenal sebagai "Game of Thrones" adalah "10.5240/C1B5-3BA1-8991-A571-8472-W".
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.
  • TVSeries 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 acara; misalnya, halaman Wikipedia acara tersebut. Ini harus berbeda dari properti url.
inLanguage Teks Bahasa asli seri 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 teater 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 acara. Sintesis plot lebih disukai untuk ringkasan faktual. Batas karakter 300.
actor Person atau PerformingGroup atau PerformanceRole Sangat Direkomendasikan Mengapa? Array anggota pemeran dalam serial. Lihat panduan pemodelan di sini.
director Person Sangat Direkomendasikan Mengapa? Sutradara acara.
producer Organisasi atau Orang Sangat Direkomendasikan Mengapa? Produser acara.
image ImageObject Wajib untuk Google TV - Gambar yang terkait dengan TVSeries. 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.
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)
review Ulasan Meninjau rating untuk Serial TV
review.reviewRating Rating Wajib jika review disediakan Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan - Rating 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 "TV-MA" dari agensi "TVPG" di Amerika Serikat harus dideskripsikan sebagai "TVPG TV-MA". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak tahu rating konten tersebut.
contentRating.author Teks atau Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating. Lihat halaman Agensi Rating Konten untuk daftar agensi rating yang diterima
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.

TVEpisode

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 disetel ke @language 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 TVEpisode.
@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
  • 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 episode.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Representasi beberapa 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 episode pertama season pertama TVSeries yang dikenal sebagai "Game of Thrones" adalah "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Teks Sangat Direkomendasikan Mengapa? - ID EIDR (Entertainment Identifier Registry) yang mewakili pengeditan / edisi tertentu untuk karya film atau televisi.

Misalnya, episode pertama season pertama TVSeries dikenal sebagai "Game of Thrones", dengan judul EIDR adalah "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", memiliki satu edit, misalnya "10.5240/FB97-C847-2969-DEC

Properti titleEIDR diperlukan saat editEIDR diberikan.
inLanguage Teks Bahasa asli seri dalam format BCP 47.
episodeNumber Integer Wajib - Angka yang menunjukkan posisi episode ini dalam urutan episode dalam satu musim. episodeNumber harus dimulai ulang untuk setiap season; artinya, episode pertama setiap season harus 1.
partOfSeason Musim Season Wajib - Season TV tempat episode ini berada.

Meskipun TVEpisode tidak memiliki TVSeason yang sesuai, Anda tetap harus menyediakan properti partOfSeason.@id dan partOfSeason.seasonNumber. Solusinya adalah:
  • Ambil contoh partofSeries.@id (misalnya, http://www.example.com/my_favorite_tv_show) dan lampirkan kolom kueri placeholder (misalnya, ?musim1) untuk membuat partOfSeason.@id unik (misalnya, http://www.example.com/my_favorite_tv_show?musim1).
  • Tetapkan partOfSeason.seasonNumber ke 1.
partOfSeason.@type Teks Wajib - Selalu tetapkan ke TVSeason.
partOfSeason.@id URL Wajib - @id dari TVSeason yang mencakup episode ini.
partOfSeason.seasonNumber Integer Wajib - Angka yang menunjukkan posisi season ini dalam urutan season dalam Serial TV.
partOfSeries Serial TV Wajib - Serial TV tempat episode ini berada.
partOfSeries.@type Teks Wajib - Selalu tetapkan ke TVSeries.
partOfSeries.@id URL Wajib - @id dari TVSeries yang mencakup episode ini.
partOfSeries.name Teks Wajib - Nama Serial TV.
partOfSeries.sameAs Teks URL ke halaman web referensi yang dapat mengidentifikasi acara; misalnya, halaman Wikipedia acara tersebut. Ini harus berbeda dari properti url.
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.
  • TVEpisode dapat tersedia di VoD dan LiveTV.
Gunakan array untuk menentukan deep link yang berbeda di beberapa region. Lihat contoh Beberapa wilayah dan bahasa.
sameAs Sangat Direkomendasikan Mengapa? URL URL ke halaman web referensi yang dapat mengidentifikasi episode; untuk halaman ujian, halaman Wikipedia episode. Ini harus berbeda dari properti url.
duration Durasi Runtime episode dalam format ISO 8601. Harap gunakan format: "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent, atau ExclusiveEvent Sangat Direkomendasikan Mengapa? - PublicationEvent digunakan untuk menentukan rilis asli (global atau lokal) konten oleh penerbit, seperti tanggal rilis teater 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 episode. Sintesis plot lebih disukai untuk ringkasan faktual. Batas karakter 300.
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.
actor Person atau PerformingGroup atau PerformanceRole Sangat Direkomendasikan Mengapa? Array pemeran episode. Lihat panduan pemodelan di sini.
director Person Sangat Direkomendasikan Mengapa? Sutradara episode.
producer Organisasi atau Orang Sangat Direkomendasikan Mengapa? Produser musim ini.
image ImageObject Sangat Direkomendasikan Mengapa? untuk Google TV - Berbagai gambar yang berkaitan dengan TVEpisode. 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.
review Ulasan Meninjau rating untuk episode TV
review.reviewRating Rating Wajib jika review disediakan Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan - Rating 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 "TV-MA" dari agensi "TVPG" di Amerika Serikat harus dideskripsikan sebagai "TVPG TV-MA". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak tahu rating konten tersebut.
contentRating.author Teks atau Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating. Lihat halaman Agensi Rating Konten untuk daftar agensi rating yang diterima
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.
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.
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)

TVSeason

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 disetel ke @language 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 TVSeason.
@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
  • 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 season TV ini.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Representasi beberapa 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 season pertama TVSeries yang dikenal sebagai "Game of Thrones" adalah "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Integer Wajib - Angka yang menunjukkan posisi season ini dalam urutan season dalam Serial TV.
partOfSeries Serial TV Wajib - Serial TV tempat season ini berada.
partOfSeries.@type Teks Wajib - Selalu tetapkan ke TVSeries.
partOfSeries.@id URL Wajib - @id dari TVSeries yang merupakan bagian dari musim ini.
partOfSeries.name Teks Wajib - Nama Serial TV.
partOfSeries.sameAs Teks URL ke halaman web referensi yang dapat mengidentifikasi acara; misalnya, halaman Wikipedia acara tersebut. Ini harus berbeda dari properti url.
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.
  • TVSeason 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 season; misalnya, halaman Wikipedia season. Ini harus berbeda dari properti url.
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 musim. Sintesis plot lebih disukai untuk ringkasan faktual. Batas karakter 300.
actor [Person atau PerformingGroup atau PerformanceRole Sangat Direkomendasikan Mengapa? Array anggota pemeran musim ini. Lihat panduan pemodelan di sini.
director Person Sangat Direkomendasikan Mengapa? Deretan sutradara acara.
producer Organisasi atau Orang Sangat Direkomendasikan Mengapa? Produser musim ini.
image ImageObject Gambar yang terkait dengan TVSEASON. Untuk detail selengkapnya tentang properti wajib dan opsional yang akan disertakan dengan image, lihat Properti gambar.
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.
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.
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)
review Ulasan Meninjau rating untuk season TV
review.reviewRating Rating Wajib jika review disediakan Ini digunakan untuk menentukan rating yang diberikan dalam ulasan.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan - Rating 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 "TV-MA" dari agensi "TVPG" di Amerika Serikat harus dideskripsikan sebagai "TVPG TV-MA". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak tahu rating konten tersebut.
contentRating.author Teks atau Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating. Lihat halaman Agensi Rating Konten untuk daftar agensi rating yang diterima
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.

Spesifikasi pelaku

Properti actor dalam jenis entitas TVSeries, TVEpisode, dan TVSeason memungkinkan Anda menentukan detail selengkapnya tentang aktor, termasuk nama karakter dan peran yang dia mainkan di acara TV. Bagian berikut menunjukkan hal yang sama, disertai beberapa contoh yang menjelaskan penggunaan.

Properti Jenis yang Diharapkan Deskripsi
actor Person atau PerformingGroup atau PerformanceRole Sangat Direkomendasikan Mengapa? : Array anggota transmisi.
  • Gunakan jenis PerformanceRole saat peran dimainkan dan (secara opsional) nama karakter anggota pemeran diketahui. Pelaku Person atau PerformingGroup disematkan di dalam objek PerformanceRole dalam kasus ini.
  • Gunakan jenis Orang untuk menunjukkan aktor individual atau Grup Kerja untuk memberikan detail grup/grup pertunjukan saat peran yang dimainkan oleh anggota pemeran tidak diketahui.

Gunakan array untuk mewakili beberapa Orang, PerformingGroups, atau PerformanceRoles.

Menggunakan jenis Person atau PerformingGroup

Berikan properti berikut saat jenis Person atau PerformingGroup digunakan

Properti Jenis yang Diharapkan Deskripsi
@type Person atau PerformingGroup Wajib - Selalu tetapkan ke Person atau PerformingGroup
@id URL Sangat Direkomendasikan Mengapa? - Pelaku atau ID grup berperforma dalam format URI; misalnya, https://example.com/actor/abc. @id harus memenuhi persyaratan berikut:
  • Unik secara global di katalog Anda per grup aktor/performa
  • ID harus stabil dan tidak berubah seiring waktu. Token akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Organisasi Anda harus memiliki domain yang digunakan untuk nilai @id.

Perlu diperhatikan bahwa @id yang digunakan dalam properti aktor harus digunakan secara konsisten di seluruh feed. Misalnya, jika ada dua Film yang menampilkan aktor yang sama, nilai @id harus tetap sama di kedua objek aktor tersebut.

name Teks Wajib - Nama aktor/aktris/anggota pemeran/grup pertunjukan.
sameAs URL Sangat Direkomendasikan Mengapa? - URL ke halaman web referensi yang dapat mengidentifikasi pelaku atau grup pertunjukan; misalnya, halaman Wikipedia pelaku. Ini harus berbeda dari properti @id.

Menggunakan jenis PerformanceRole

Berikan properti berikut saat jenis PerformanceRole digunakan

Properti Jenis yang Diharapkan Deskripsi
@type PerformanceRole Wajib - Selalu tetapkan ke PerformanceRole
roleName Teks Sangat Direkomendasikan Mengapa? - Peran yang dimainkan, dilakukan, atau diisi oleh anggota pemeran. Lihat daftar nilai yang dapat diterima di sini.
characterName Teks Nama karakter yang dimainkan dalam beberapa peran atau peran. Jangan tetapkan kolom ini jika jenis aktornya adalah PerformingGroup.
actor Person atau PerformingGroup Wajib -
  • Anggota transmisi konten saat jenis data Orang digunakan.
  • Grup/grup performa konten saat jenis data PerformingGroup digunakan.
actor.@type Person atau PerformingGroup Wajib - Selalu tetapkan ke Person atau PerformingGroup
actor.@id URL Sangat Direkomendasikan Mengapa? - Pelaku atau ID grup berperforma dalam format URI; misalnya, https://example.com/actor/abc. @id harus memenuhi persyaratan berikut:
  • Unik secara global di katalog Anda per grup aktor/performa
  • ID harus stabil dan tidak berubah seiring waktu. Token akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Organisasi Anda harus memiliki domain yang digunakan untuk nilai @id.

Perlu diperhatikan bahwa @id yang digunakan dalam properti aktor harus digunakan secara konsisten di seluruh feed. Misalnya, jika ada dua Film yang menampilkan aktor yang sama, nilai @id harus tetap sama di kedua objek aktor tersebut.

actor.name Teks Wajib - Nama aktor/aktris/anggota pemeran/grup pertunjukan.
actor.sameAs URL Sangat Direkomendasikan Mengapa? - URL ke halaman web referensi yang dapat mengidentifikasi pelaku atau grup pertunjukan; misalnya, halaman Wikipedia pelaku. Ini harus berbeda dari properti actor.@id.

Nama peran yang dapat diterima

Nilai ini mengharuskan actor.@type menjadi Person.

Nilai roleName Deskripsi
“Cameo” Peran cameo, yang juga disebut penampilan cameo, adalah penampilan singkat dari orang terkenal dalam karya seni pertunjukan.
"Aktor Suara" Performa suara adalah suara yang digunakan aktor, tetapi aktor tidak muncul di layar. Hal ini paling sering ditemukan dalam animasi, tetapi juga terjadi ketika suara aktor disulihsuarakan di atas ucapan aktor lain.
"Tambahan" Double adalah orang yang menggantikan aktor lain sehingga wajah orang tersebut tidak ditampilkan.
"MotionCaptureActor" MotionCaptureActor merujuk pada orang yang merekam tindakan aktor manusia, dan menggunakan informasi tersebut untuk menganimasikan model karakter digital dalam animasi komputer 2D atau 3D.

Nilai ini umumnya diterima untuk jenis Person dan PerformingGroup.

Nilai roleName Deskripsi
"Pelaku" Aktor atau aktris adalah orang yang memerankan karakter dalam pertunjukan di media tradisional teater atau di media modern seperti film, radio, dan televisi.
"Tamu" "Bintang tamu adalah aktor yang memainkan peran fiksi dan muncul dalam satu atau beberapa episode. Dalam beberapa kasus, bintang tamu mungkin memainkan karakter berulang yang penting dan mungkin muncul berkali-kali dalam sebuah serial, meskipun bukan merupakan anggota pemeran utama. Tetapkan nilai ke "guestStar" saat pemeran memiliki pertunjukan tamu atau menjadi tamu di acara tersebut. Bintang tamu hanya boleh diberikan di tingkat episode, dan tidak boleh ditambahkan di tingkat TVSeries.
"Tamu" "Tamu di bincang-bincang. Perlu diperhatikan bahwa meskipun "GuestStar" memiliki peran fiktif, "Guest" adalah tampilan non-fiksi.
"Penyiar" Pemberi pengumuman adalah orang yang menyampaikan pertunjukan pembuka dan penutup untuk acara, memperkenalkan pembawa acara, kontestan, dan/atau tamu selebritas, menjelaskan hadiah yang tersedia, dan menghangatkan penonton sebelum mengetuk dan membuat mereka tetap terhibur selama istirahat.
"Komentator" Komentator memberikan komentar secara real-time tentang pertandingan atau acara, biasanya selama live streaming.
"Impresionis" Impresionis atau emulasi adalah artis yang tindakannya terdiri dari meniru suara, suara, dan tingkah laku selebritas dan karakter kartun.
"Host" Seseorang yang memperkenalkan, mempresentasikan, atau menyelenggarakan program televisi, yang sering berperan sebagai mediator program dan audiens. "Host" umumnya memiliki peran non-fiksi.
"Rekan Penyelenggara" Seseorang yang menyelenggarakan acara/program bersama dengan orang lain.
"Host Tamu" Pembawa acara tamu adalah host, biasanya acara bincang-bincang, yang menyelenggarakan program sebagai pengganti penyelenggara reguler jika tidak tersedia.
"Penyiar Berita" Seseorang yang menyajikan/memberi tahu publik tentang berita dan peristiwa yang terjadi dalam skala lokal, nasional, dan internasional melalui program berita TV.
"Koresponden" Reporter atau koresponden di balik layar biasanya adalah seorang jurnalis atau komentator untuk majalah, atau agen yang memberikan laporan kepada surat kabar, atau berita radio atau televisi, atau jenis perusahaan yang lain, dari lokasi yang jauh dan sering jauh.
"Tampilkan Juri" Juri adalah orang yang sering dianggap sebagai pakar di bidang acara dan diberi peran "hakim" untuk mengkritik kontestan yang mengikuti audisi dan mengikuti kompetisi serial TV.
"Panelis" Anggota panel diskusi atau penasihat dari panel radio atau televisi.
"Kontes" Kontestan dalam suatu kompetisi atau acara game adalah orang yang berpartisipasi di dalamnya.
"StoryNarator" Narator adalah orang yang menceritakan sesuatu, terutama karakter yang menceritakan peristiwa dari novel atau puisi naratif
"Artis Musik" "Artis Musik dapat berupa orang atau kelompok atau karakter fiksi yang biasanya tampil di depan penonton secara rutin atau telah merekam trek musik atau album musik. Komposer dan penulis lirik sebaiknya hanya memiliki jenis ini jika kredit dari beberapa karya musik menyiratkan bahwa keduanya juga berkontribusi sebagai pengisi suara utama. Jenis ini dapat digunakan untuk mengaitkan musisi permanen atau grup musisi, serta musisi atau Grup musisi tamu untuk ditampilkan.

Membedakan antara peran utama dan pendukung dari seorang aktor

Untuk membedakan aktor utama/reguler dan tamu/pendukung dalam acara TV, tambahkan pemeran utama hanya pada entitas TVSeries dan tambahkan hanya pemeran tamu atau pemeran dengan peran pendukung pada entitas TVEpisode. Pastikan transmisi utama/reguler tidak ditambahkan ke entity TVEpisode.

Contoh

Contoh TVSeries, TVEpisode, dan TVSeason

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Contoh properti Actor

Peran aktor tidak diketahui

Ketika peran aktor tidak diketahui, sebaiknya Anda hanya memberikan informasi aktor menggunakan jenis Orang atau PerformingGroup

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Peran aktor diketahui

Saat peran seorang aktor diketahui, rekomendasi kami adalah memberikan informasi aktor menggunakan jenis PerformanceRole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Peran yang diketahui untuk sebagian aktor

Jika metadata peran performa tidak diketahui, sebaiknya Anda memberikan informasi aktor menggunakan Orang atau PerformingGroup jenis. Untuk kasus lain yang infonya diketahui, gunakan jenis PerformanceRole . Jenis ini dapat ditambahkan dalam array yang sama secara bersamaan.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Lihat halaman berikut untuk topik yang terkait dengan properti ini: