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 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 Anda menggunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi acara ini. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
sport URL Wajib Link ke halaman Wikipedia (lebih disukai versi bahasa Inggris) 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 dalam acara.
homeTeam.name Teks Wajib diisi Nama lengkap tim olahraga.
homeTeam.sport URL Wajib Link ke halaman Wikipedia (lebih disukai versi bahasa Inggris) 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 atlet perorangan dalam tim.
homeTeam.athlete.name Teks Nama lengkap atlet.
homeTeam.parentOrganization.name SportsOrganization Wajib Nama liga olahraga tempat tim tersebut bermain. 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 dalam acara. Properti ini 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 dalam 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. Properti 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 Negara bagian 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 sebagai poster atau banner resmi untuk acara tersebut. Untuk mengetahui detail selengkapnya tentang properti wajib dan opsional yang 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 sebagai gantinya.
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 Olahraga Tim 

{
  "@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 Olahraga Individu 

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

SportsEvent dengan batasan GeoShape

{
  "@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"
    }
  ]
  "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/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

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 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 Anda menggunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi acara. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
attendee Organization atau Person Orang atau organisasi yang menghadiri acara.
startDate Tanggal Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu.
endDate Tanggal 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 suatu acara.
performer Organization atau Person Wajib - Penampil di acara—misalnya, presenter, musisi, grup musik, atau aktor.
subEvent Acara Acara yang merupakan bagian dari acara ini. Misalnya, peristiwa konferensi mencakup banyak presentasi, yang masing-masing merupakan subEvent dari konferensi.
superEvent Acara Acara yang merupakan bagian dari acara ini. Misalnya, kumpulan pertunjukan musik individu mungkin masing-masing memiliki festival musik sebagai superEvent-nya.
location Tempat ATAU Kota Wajib diisi - Lokasi acara.
location.name Teks Wajib - Nama lokasi.
location.address PostalAddress Wajib jika @type lokasi adalah Place - Alamat lokasi. Tidak boleh digunakan jika @type lokasi adalah Kota.
location.address.streetAddress Teks Alamat lokasi.
location.address.addressLocality Teks Kota lokasi.
location.address.addressRegion Teks Negara bagian lokasi.
location.address.postalCode Teks Kode pos lokasi.
location.address.addressCountry Teks Negara dalam format ISO 3166.
workPerformed CreativeWork Karya yang ditampilkan dalam suatu acara, misalnya pertunjukan yang ditampilkan dalam 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 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 Anda menggunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama acara ini.
  • Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Lihat contoh Beberapa wilayah dan bahasa.
  • Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
description Teks Deskripsi acara. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
attendee Organization atau Person Orang atau organisasi yang menghadiri acara.
startDate Tanggal Wajib - Waktu mulai acara dalam format ISO 8601 dengan zona waktu.
endDate Tanggal Waktu berakhir acara dalam format ISO 8601 dengan zona waktu.
subEvent Acara Acara yang merupakan bagian dari acara ini. Misalnya, peristiwa konferensi mencakup banyak presentasi, yang masing-masing merupakan subEvent dari konferensi.
superEvent Acara Acara yang merupakan bagian dari acara ini. Misalnya, kumpulan pertunjukan musik individu mungkin masing-masing memiliki festival musik sebagai superEvent-nya.
releasedEvent PublicationEvent, FeaturedEvent, atau ExclusiveEvent Sangat Direkomendasikan Mengapa? - PublicationEvent digunakan untuk menentukan rilis asli (global atau lokal) konten oleh penayang, seperti tanggal rilis teater asli sebuah film.

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

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

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

Untuk PublicationEvent, ini adalah wilayah tempat konten dipublikasikan.

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

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

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

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

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

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

Jika konten bersifat eksklusif atau ditampilkan secara terus-menerus, tetapkan endDate hingga 20 tahun dari tanggal saat ini.
releasedEvent.publishedBy Organization atau Person Opsional - Organisasi atau orang yang memublikasikan entitas ini.
location Tempat ATAU Kota Wajib diisi - Lokasi acara. 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. Tidak boleh digunakan jika @type lokasi adalah Kota
location.address.streetAddress Teks Alamat lokasi.
location.address.addressLocality Teks Kota lokasi.
location.address.addressRegion Teks Negara bagian lokasi.
location.address.postalCode Teks Kode pos lokasi.
location.address.addressCountry Teks Negara dalam format ISO 3166.
workPerformed CreativeWork Karya yang ditampilkan dalam suatu acara, misalnya pertunjukan yang ditampilkan dalam 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"
  }
}