Properti markup konten peristiwa

Bagian ini memberikan detail properti markup konten untuk jenis entitas terkait Event.

Tabel spesifikasi SportsEvent

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Ganti xx dengan kode bahasa entity dalam format format BCP 47, misalnya, "en".
@type Teks Wajib - Selalu ditetapkan ke SportsEvent.
@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 tersebut berubah). Link ini akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda.
Karena url entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian Pengenal untuk detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk menampilkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
description Teks Deskripsi acara ini. Panjang limist 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
sport URL Wajib Link ke halaman Wikipedia (versi bahasa Inggris lebih disukai) tentang olahraga tersebut.
startDate DateTime atau Date Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu. Harap diperhatikan bahwa ini adalah waktu mulai acara yang sebenarnya, bukan saat acara disiarkan di TV.
endDate DateTime atau Date Waktu berakhir acara dalam format ISO 8601 dengan zona waktu.
homeTeam SportsTeam Sangat Direkomendasikan Mengapa? Tim kandang acara.
homeTeam.name Teks Wajib Nama lengkap tim olahraga.
homeTeam.sport URL Wajib Link ke halaman Wikipedia (versi bahasa Inggris lebih disukai) tentang olahraga tersebut.
homeTeam.sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman web referensi yang dapat mengidentifikasi tim; misalnya, halaman Wikipedia tim.
homeTeam.athlete Person Anotasi untuk setiap atlet dalam tim.
homeTeam.athlete.name Teks Nama lengkap atlet.
homeTeam.parentOrganization.name SportsOrganization Wajib Nama liga olahraga yang diikuti tim. Misalnya, National Basketball Association atau Major League Baseball. Perhatikan bahwa bidang ini tidak boleh digunakan untuk konferensi tim.
homeTeam.parentOrganization.sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman web referensi yang dapat mengidentifikasi liga tim; misalnya, halaman Wikipedia liga.
awayTeam SportsTeam Sangat Direkomendasikan Mengapa? Tim penjelajah. Propertinya sama dengan SportsEvent.homeTeam.
competitor SportsTeam atau Person Sangat Direkomendasikan Mengapa? Jika tim kandang atau tandang tidak berlaku (misalnya, pertandingan tinju, Olimpiade), tetapkan peserta sebagai pesaing. Jika SportsTeam, propertinya sama dengan SportsEvent.homeTeam. Jika Person, propertinya sama dengan objek Person lainnya; misalnya, aktor di Movie.
location Tempat ATAU Kota Lokasi acara tersebut.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib diisi jika location @type is Place - Alamat lokasi. Ini tidak boleh digunakan jika lokasi @type adalah Kota
location.address.streetAddress Teks Alamat lokasi.
location.address.addressLocality Teks Kota lokasi.
location.address.addressRegion Teks Status lokasi.
location.address.postalCode Teks Kode pos lokasi.
location.address.addressCountry Teks Negara dalam format ISO 3166.
image ImageObject Wajib untuk Google TV - Gambar yang terkait dengan acara. Direkomendasikan untuk menggunakan poster atau gambar banner resmi untuk acara tersebut. Untuk detail selengkapnya tentang properti wajib dan opsional yang akan disertakan dengan image, lihat Properti gambar.
potentialAction WatchAction Wajib jika berlaku - Deep link yang memutar rekaman acara olahraga ini di Video on Demand. Untuk menentukan deep link untuk acara live, gunakan properti publishedOn atau potentialAction di BroadcastEvent.
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.

Contoh SportsEvent

Contoh 1

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Contoh 2

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

Tabel spesifikasi MusicEvent

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Ganti xx dengan kode bahasa entity dalam format format BCP 47, misalnya, "en".
@type Teks Wajib - Selalu ditetapkan ke MusicEvent.
@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
  • Dalam bentuk Unified Resource Identifier (URI)
Karena url entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian Pengenal untuk detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk menampilkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
description Teks Deskripsi peristiwa. Panjang limist 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
attendee Organisasi atau Individu Orang atau organisasi yang menghadiri acara tersebut.
startDate Date Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu.
endDate Date Waktu berakhir acara dalam format ISO 8601 dengan zona waktu.
composer Organisasi atau Individu Orang atau organisasi yang menulis komposisi, atau komposer dari karya yang dibawakan pada suatu acara.
performer Organisasi atau Individu Wajib - Artis di acara tersebut—misalnya, presenter, musisi, grup musik, atau aktor.
subEvent Peristiwa Peristiwa yang merupakan bagian dari peristiwa ini. Misalnya, acara konferensi menyertakan banyak presentasi, yang masing-masing merupakan sub-Acara konferensi.
superEvent Peristiwa Peristiwa yang mencakup peristiwa ini. Misalnya, koleksi pertunjukan musik individual mungkin memiliki festival musik sebagai superEvent-nya.
location Tempat ATAU Kota Wajib - Lokasi acara.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib diisi jika location @type is Place - Alamat lokasi. Ini tidak boleh digunakan jika lokasi @type adalah Kota.
location.address.streetAddress Teks Alamat lokasi.
location.address.addressLocality Teks Kota lokasi.
location.address.addressRegion Teks Status lokasi.
location.address.postalCode Teks Kode pos lokasi.
location.address.addressCountry Teks Negara dalam format ISO 3166.
workPerformed CreativeWork Karya yang dibawakan di suatu acara, misalnya drama yang dibawakan di TheaterEvent.

Contoh MusicEvent

MusicEvent

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

Tabel spesifikasi peristiwa

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Ganti xx dengan kode bahasa entity dalam format format BCP 47, misalnya, "en".
@type Teks Wajib - Selalu ditetapkan ke Event.
@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
  • Dalam bentuk Unified Resource Identifier (URI)
Karena url entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian Pengenal untuk detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk menampilkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokal (pasangan bahasa-negara).
description Teks Deskripsi peristiwa. Panjang limist 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
attendee Organisasi atau Individu Orang atau organisasi yang menghadiri acara tersebut.
startDate Date Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu.
endDate Date Waktu berakhir acara dalam format ISO 8601 dengan zona waktu.
subEvent Peristiwa Peristiwa yang merupakan bagian dari peristiwa ini. Misalnya, acara konferensi menyertakan banyak presentasi, yang masing-masing merupakan sub-Acara konferensi.
superEvent Peristiwa Peristiwa yang mencakup peristiwa ini. Misalnya, koleksi pertunjukan musik individual mungkin memiliki festival musik sebagai superEvent-nya.
releasedEvent PublicationEvent, FeaturedEvent, atau ExclusiveEvent Sangat Direkomendasikan Mengapa? - PublicationEvent digunakan untuk menentukan rilis konten asli (global atau lokal) oleh penerbit, seperti tanggal rilis bioskop asli.

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 contoh.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan 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 secara 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, hal ini menunjukkan tanggal rilis awal entitas ini, seperti tanggal film pertama kali dirilis di bioskop.

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

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

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

Jika konten bersifat eksklusif atau unggulan untuk selamanya, setel endDate ke 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organisasi atau Individu Opsional - Organisasi atau orang yang memublikasikan entitas ini.
location Tempat ATAU Kota Wajib - Lokasi acara. Perhatikan bahwa Anda dapat memberikan Place di level City.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib diisi jika location @type is Place - Alamat lokasi. Ini tidak boleh digunakan jika lokasi @type adalah Kota
location.address.streetAddress Teks Alamat lokasi.
location.address.addressLocality Teks Kota lokasi.
location.address.addressRegion Teks Status lokasi.
location.address.postalCode Teks Kode pos lokasi.
location.address.addressCountry Teks Negara dalam format ISO 3166.
workPerformed CreativeWork Karya yang dibawakan di suatu acara, misalnya drama yang dibawakan di TheaterEvent.

Contoh peristiwa

Event

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}