Properti markup konten peristiwa

Bagian ini memberikan detail properti markup konten untuk jenis entity 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 entitas 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 berubah). URL ini akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda.
Karena url entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa ini.
  • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi peristiwa ini. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa dan panjang.
sport URL Wajib Link ke halaman Wikipedia (lebih disukai versi bahasa Inggris) tentang olahraga tersebut.
startDate DateTime atau Date Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu. Perhatikan bahwa ini adalah waktu mulai acara yang sebenarnya, bukan waktu acara ditayangkan 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 (lebih disukai versi bahasa Inggris) tentang olahraga tersebut.
homeTeam.sameAs URL Sangat Direkomendasikan Mengapa? URL ke halaman web referensi yang dapat mengidentifikasi tim; misalnya, halaman Wikipedia tim.
homeTeam.athlete Orang Anotasi untuk setiap atlet dalam tim.
homeTeam.athlete.name Teks Nama lengkap atlet.
homeTeam.parentOrganization.name SportsOrganization Wajib Nama liga olahraga tempat tim tersebut tergabung. Misalnya, National Basketball Association atau Major League Baseball. Perhatikan bahwa kolom 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 tandang dari acara tersebut. Propertinya sama dengan SportsEvent.homeTeam.
competitor SportsTeam atau Person Sangat Direkomendasikan Mengapa? Jika tim tuan rumah atau tim tamu tidak berlaku (misalnya, pertandingan tinju, Olimpiade), tentukan 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 jika @type lokasi adalah Place - Alamat lokasi. Ini tidak boleh digunakan jika @type lokasi 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. Sebaiknya gunakan poster atau gambar banner resmi untuk acara. Untuk mengetahui 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 menunjukkan 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 entitas 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 entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa ini.
  • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi peristiwa. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa dan panjang.
attendee Organization atau Person Orang atau organisasi yang menghadiri acara.
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 Organization atau Person Orang atau organisasi yang menulis komposisi, atau yang merupakan komposer karya yang ditampilkan di beberapa acara.
performer Organization atau Person Wajib - Penampil di acara—misalnya, presenter, musisi, grup musik, atau aktor.
subEvent Acara Peristiwa yang merupakan bagian dari peristiwa ini. Misalnya, peristiwa konferensi mencakup banyak presentasi, yang masing-masing merupakan subPeristiwa konferensi.
superEvent Acara Acara yang menjadi bagian dari peristiwa ini. Misalnya, koleksi pertunjukan musik individual mungkin masing-masing memiliki festival musik sebagai superEvent-nya.
location Tempat ATAU Kota Wajib - Lokasi peristiwa.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib jika @type lokasi adalah Place - Alamat lokasi. Ini tidak boleh digunakan jika @type lokasi 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 ditampilkan dalam beberapa peristiwa, misalnya drama yang ditampilkan 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 entitas 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 entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa ini.
  • Gunakan array untuk mencantumkan nama dalam bahasa yang berbeda. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi peristiwa. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa dan panjang.
attendee Organization atau Person Orang atau organisasi yang menghadiri acara.
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 Acara Peristiwa yang merupakan bagian dari peristiwa ini. Misalnya, peristiwa konferensi mencakup banyak presentasi, yang masing-masing merupakan subPeristiwa konferensi.
superEvent Acara Acara yang menjadi bagian dari peristiwa ini. Misalnya, koleksi pertunjukan musik individual mungkin masing-masing 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 penayang, seperti tanggal rilis bioskop asli film.

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

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

Lihat bagian contoh untuk mengetahui detail dan contoh.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan properti ini ke salah satu dari hal berikut:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Negara Wajib - Wilayah yang terkait dengan peristiwa ini.

Untuk PublicationEvent, ini adalah wilayah tempat konten dipublikasikan.

Untuk FeaturedEvent dan ExclusiveEvent, ini adalah wilayah tempat konten ditampilkan atau eksklusif.

Gunakan kode ISO 3166 untuk negara. Untuk menunjukkan di mana saja di dunia, tetapkan ke EARTH.
releasedEvent.startDate Date atau DateTime Direkomendasikan - Wajib untuk ExclusiveEvent - Tanggal mulai publikasi entity.

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

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

Untuk ExclusiveEvent, ini menunjukkan tanggal berakhirnya hak atas konten.

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

Jika konten bersifat eksklusif atau ditampilkan secara permanen, tetapkan endDate ke 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organization atau Person Opsional - Organisasi atau orang yang memublikasikan entitas ini.
location Tempat ATAU Kota Wajib - Lokasi peristiwa. Perhatikan bahwa Anda dapat memberikan Place di tingkat City.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib jika @type lokasi adalah Place - Alamat lokasi. Ini tidak boleh digunakan jika @type lokasi 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 ditampilkan dalam beberapa peristiwa, misalnya drama yang ditampilkan di TheaterEvent.

Contoh peristiwa

Acara 

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