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 (dan berbeda dari @id dari BroadcastEvent mana pun yang merujuk ke SportsEvent ini)
  • Statis; ID harus stabil dan tidak berubah seiring waktu. 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.
Penting: Jangan sertakan properti url di SportsEvent atau BroadcastEvent. Berikan link pemutaran menggunakan SportsEvent.potentialAction. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa 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 peristiwa ini. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa (satu per bahasa).
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 disiarkan di TV.
endDate DateTime atau Date Direkomendasikan - Waktu berakhir acara yang dijadwalkan dalam format ISO 8601 dengan zona waktu. Berikan waktu berakhir yang dijadwalkan jika diketahui; jika waktu berakhir tidak diketahui, hapus properti ini, bukan memberikan perkiraan placeholder.
homeTeam SportsTeam Sangat Direkomendasikan Mengapa? Tim tuan rumah dalam pertandingan.
homeTeam.name Teks Wajib 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 setiap atlet dalam tim.
homeTeam.athlete.name Teks Nama lengkap atlet.
homeTeam.parentOrganization SportsOrganization Wajib - Liga olahraga atau organisasi pengatur tempat tim bernaung. Sertakan parentOrganization di homeTeam dan awayTeam jika kedua tim disediakan.
homeTeam.parentOrganization.name Teks Wajib - Nama liga olahraga tempat tim tersebut bergabung. 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? - Link ke halaman Wikipedia (lebih disukai versi bahasa Inggris) yang mengidentifikasi liga tim (misalnya, https://en.wikipedia.org/wiki/National_Basketball_Association). Jangan gunakan URL placeholder example.com.
awayTeam SportsTeam Sangat Direkomendasikan Mengapa? - Tim tamu dalam pertandingan. Properti dan persyaratannya (termasuk parentOrganization) sama dengan SportsEvent.homeTeam.
competitor SportsTeam atau Person Sangat Direkomendasikan Mengapa? Jika tim kandang atau tandang tidak berlaku (misalnya, pertandingan tinju, Olimpiade), tentukan peserta sebagai kompetitor. 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 City
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 menjadi poster atau gambar banner resmi acara. Untuk mengetahui detail selengkapnya tentang properti wajib dan opsional yang harus disertakan dengan image, lihat Properti gambar.
potentialAction WatchAction Wajib jika ada - Deep link untuk memutar acara olahraga, yang digunakan untuk livestream tanpa channel dan pemutaran ulang Video on demand. Semua deep link acara olahraga harus berada di SportsEvent.potentialAction; jangan pernah menempatkan potentialAction di BroadcastEvent yang merujuk ke SportsEvent (untuk siaran channel TV linear tanpa deep link acara langsung, berikan deep link channel di BroadcastService.potentialAction). Berikan array objek WatchAction saat menawarkan beberapa streaming (seperti feed regional, kandang atau tandang, atau siaran multibahasa) atau jendela pemutaran ulang live dan Video on Demand yang terpisah.
potentialAction.actionAccessibilityRequirement ActionAccessSpecification Wajib jika potentialAction diberikan - Menentukan hak dan periode ketersediaan yang dapat diklik (availabilityStarts dan availabilityEnds) untuk setiap WatchAction:
  • Periode pre-roll (availabilityStarts): Untuk siaran olahraga live, tetapkan availabilityStarts setidaknya 14 hari sebelum SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) agar kartu acara mendatang dapat muncul lebih awal (entitas acara itu sendiri dapat dikirimkan lebih dekat ke hari pertandingan, asalkan stempel waktu availabilityStarts setidaknya 14 hari sebelum startDate).
  • Buffer perpanjangan waktu (availabilityEnds): Tetapkan availabilityEnds setelah SportsEvent.endDate dengan buffer minimal 2 hingga 3 jam (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours, atau hingga akhir periode pemutaran ulang Video on demand) untuk mencegah deep link berakhir selama perpanjangan waktu live atau liputan pascapertandingan.
Lihat Properti markup tindakan untuk mengetahui detail selengkapnya.
identifier PropertyValue Sangat Direkomendasikan Mengapa? - ID eksternal atau ID lain yang mengidentifikasi entitas ini secara jelas. 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

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",
  "endDate": "2019-07-12T23:30-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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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 gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa 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 peristiwa. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa dan panjang.
attendee Organisasi atau Orang 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 Organisasi atau Orang Orang atau organisasi yang menulis komposisi, atau yang merupakan komposer karya yang ditampilkan di beberapa acara.
performer Organisasi atau Orang Wajib - Penampil di acara—misalnya, presenter, musisi, grup musik, atau aktor.
subEvent Acara Acara yang merupakan bagian dari acara ini. Misalnya, acara konferensi mencakup banyak presentasi, yang masing-masing merupakan subEvent dari konferensi tersebut.
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 - Lokasi acara.
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 City.
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 acara, misalnya drama 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 gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Nama peristiwa 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 peristiwa. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa dan panjang.
attendee Organisasi atau Orang 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, acara konferensi mencakup banyak presentasi, yang masing-masing merupakan subEvent dari konferensi tersebut.
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 penerbit, seperti tanggal rilis asli film di bioskop.

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 mencakup di mana dan kapan.

Lihat bagian contoh untuk mengetahui detail dan contohnya.
releasedEvent.@type Teks Wajib - Pastikan untuk selalu menetapkan properti ini ke salah satu dari 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 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 menunjukkan tanggal mulai saat entitas bersifat eksklusif atau diunggulkan.
releasedEvent.endDate Date atau DateTime Direkomendasikan - Wajib untuk ExclusiveEvent - Atribut ini hanya berlaku untuk jenis ExclusiveEvent dan FeaturedEvent.

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

Untuk FeaturedEvent, atribut 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 Organisasi atau Orang Opsional - Organisasi atau orang yang memublikasikan entitas ini.
location Tempat ATAU Kota Wajib - 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. Ini tidak boleh digunakan jika @type lokasi adalah City
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 acara, misalnya drama 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"
  }
}