Properti markup konten acara TV live

Bagian ini memberikan detail properti markup konten untuk jenis entity BroadcastEvent. Untuk lebih memahami hubungan antara jenis-jenis ini, tinjau konsep Acara LiveTV.

Tabel spesifikasi BroadcastEvent

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 BroadcastEvent.
@id URL Wajib - ID slot siaran dalam format URI; misalnya, https://example.com/live/channel1/20191012T2100.
@id harus memenuhi persyaratan berikut:
  • Unik secara global di seluruh katalog Anda dan berbeda dari workPerformed.@id atau broadcastOfEvent.@id (misalnya, menggabungkan channel/layanan dan waktu mulai siaran ke dalam URI)
  • 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 BroadcastEvent atau SportsEvent. Berikan url kanonis hanya pada entitas konten yang mendasarinya (Movie, TVSeries, atau TVEpisode). Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Judul acara atau peristiwa.
description Teks Deskripsi acara atau peristiwa. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa bahasa (satu per bahasa).
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.
publishedOn BroadcastService Wajib jika ada - Tentukan entitas BroadcastService yang menyiarkan acara atau peristiwa ini.

Jika konten disiarkan di saluran TV, properti ini wajib ada. Jika konten tidak terkait dengan channel TV apa pun, jangan berikan properti ini.
publishedOn.@type Teks Tetapkan ke BroadcastService.
publishedOn.@id URL @id dari entity BroadcastService yang menyiarkan acara atau peristiwa ini.
workPerformed CreativeWork Wajib jika ada - Gunakan properti ini jika kontennya adalah salah satu jenis entity berikut: Movie, TVSeries, dan TVEpisode.
Sangat direkomendasikan agar entity BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
workPerformed.@type Teks Tetapkan ke Movie, TVSeries, atau TVEpisode.
workPerformed.@id URL @id entitas konten.
broadcastOfEvent SportsEvent Wajib jika ada - Gunakan properti ini jika kontennya adalah acara live:
  • Untuk acara olahraga, properti ini harus merujuk ke entitas SportsEvent.

Sangat disarankan agar entitas BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
broadcastOfEvent.@type Teks Tetapkan ke SportsEvent.
broadcastOfEvent.@id URL @id entity peristiwa. Entity acara harus ada di feed dan memiliki @id yang berbeda dari BroadcastEvent.
location Teks atau Negara Wajib diisi jika BroadcastEvent ditujukan untuk SportsEvent, yaitu memiliki properti broadcastOfEvent - Negara tempat SportsEvent yang mendasarinya dapat disiarkan. Kolom ini dapat berupa daftar negara jika beberapa negara dapat menyiarkan SportsEvent.
videoFormat Teks Definisi kualitas tertinggi yang didukung di layanan siaran ini; misalnya,
  • "SD" untuk definisi standar.
  • "HD" untuk definisi tinggi.
  • "2K" untuk resolusi 2K.
  • "4K" untuk resolusi 4K.
  • "8K" untuk resolusi 8K.
contentToBeAnnounced Boolean Wajib jika berlaku - Gunakan properti ini jika konten tidak diketahui pada saat pembuatan feed.

Tetapkan ke true jika penyedia tidak memiliki informasi terbaru tentang apa yang akan disiarkan, false jika sebaliknya.
Sangat direkomendasikan agar entitas BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
offAir Boolean Wajib jika ada - Tetapkan ke true jika tidak ada siaran konten yang direncanakan untuk slot waktu di channel BroadcastService.
  • Tetapkan name dan description ke "Off Air".
  • Setiap offAir BroadcastEvent harus berdurasi 4 jam atau kurang (jangan memancarkan blok berkelanjutan 24 jam). Jika channel tidak mengudara selama lebih dari 4 jam, tampilkan beberapa entitas BroadcastEvent yang berdekatan dan tidak tumpang-tindih, masing-masing berdurasi maksimal 4 jam, sehingga channel mempertahankan cakupan jadwal 24x7 yang lengkap tanpa celah di awal atau akhir periode feed.
Sangat disarankan agar entitas BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
isLiveBroadcast Boolean Tetapkan ke boolean true (tanpa tanda petik) jika penayangan ini adalah siaran live (misalnya, pertandingan olahraga live atau berita harian live), atau false untuk program non-live dan tayangan ulang.
potentialAction WatchAction Wajib jika ada - Jangan pernah memberikan potentialAction di BroadcastEvent jika broadcastOfEvent merujuk ke SportsEvent (tempatkan semua deep link olahraga di SportsEvent.potentialAction) atau jika publishedOn merujuk ke saluran BroadcastService (tempatkan deep link saluran di BroadcastService.potentialAction). Hanya berikan BroadcastEvent.potentialAction untuk live stream tanpa saluran yang tidak merujuk ke SportsEvent (seperti konten tambahan live stream mandiri dengan contentToBeAnnounced dan offAir dihilangkan atau false).
identifier PropertyValue ID eksternal yang mengidentifikasi konten siaran. Lihat bagian Properti ID untuk mengetahui detailnya.
  • Catatan: Jenis entity BroadcastEvent hanya menerima nilai propertyID dari TMS_ID atau TMS_ROOT_ID.
  • Properti ini hanya boleh diberikan untuk kasus saat entity Movie, TVSeries, TVEpisode, atau SportsEvent tingkat teratas yang terbentuk sepenuhnya tidak direferensikan menggunakan properti workPerformed atau broadcastOfEvent.
  • Nilai properti harus mencerminkan TMS_ID atau TMS_ROOT_ID dari entitas Movie, TVSeries, TVEpisode, atau SportsEvent yang idealnya Anda referensikan menggunakan properti workPerformed atau broadcastOfEvent.
  • TMS_ID lebih disarankan daripada nilai TMS_ROOT_ID.
contentRating Teks atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan untuk konten lainnya Mengapa? - Rating konten keseluruhan dari konten siaran. Jika rating konten diberikan dalam bentuk string teks, dua variasi akan diterima:
  • Lembaga rating ditambahkan di awal rating dengan spasi di antaranya. Misalnya, rating "PG-13" dari lembaga "MPAA" di Amerika Serikat harus dijelaskan sebagai "MPAA PG-13". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak mengetahui rating Film tersebut.
contentRating.author Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga rating.
contentRating.ratingValue Teks Wajib jika contentRating menggunakan Rating - Nilai rating.
contentRating.advisoryCode Teks Kode bimbingan untuk konten. Nilai yang diterima mencakup D, FV, L, S, dan V. D = Dialog, FV = Kekerasan Fantasi , L = Bahasa, S = Konten Seksual, V = Kekerasan.

Contoh

Episode TV disiarkan di jaringan televisi Example TV (BroadcastService) antara pukul 21.00 dan 21.30 pada 12 Oktober 2019:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Contoh yang menunjukkan penggunaan properti contentToBeAnnounced saat konten yang akan disiarkan di jaringan televisi Example TV (BroadcastService) antara pukul 21.00 dan 21.30 pada 12 Oktober 2019 tidak diketahui pada saat pembuatan feed:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Saluran jaringan televisi Example TV (BroadcastService) tidak mengudara antara pukul 12.00 dan 20.00 (dimodelkan sebagai dua blok Off Air 4 jam yang berdekatan) dan menyiarkan satu acara bernama My favorite show antara pukul 20.00 dan 00.00:

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16:00-08:00",
  "endDate": "2019-10-12T20:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Lihat halaman berikut untuk topik yang terkait dengan properti ini: