Properti markup konten acara TV live

Bagian ini memberikan detail properti markup konten untuk jenis entity BroadcastEvent. Untuk lebih memahami hubungan antara jenis ini, tinjau konsep Peristiwa 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 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 - Judul acara TV atau acara.
description Teks Deskripsi acara atau acara. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
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 berlaku - Tentukan entitas BroadcastService yang menyiarkan acara atau acara ini.

Jika konten disiarkan di saluran TV, properti ini wajib diisi. Jika konten tidak dikaitkan dengan channel TV apa pun, jangan berikan properti ini.
publishedOn.@type Teks Tetapkan ke BroadcastService.
publishedOn.@id URL @id entitas BroadcastService yang menyiarkan acara TV atau acara ini.
workPerformed CreativeWork Wajib jika berlaku - Gunakan properti ini jika konten adalah salah satu jenis entity berikut: Movie, TVSeries, dan TVEpisode.
Sangat disarankan 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 berlaku - 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 entitas acara. Entitas acara harus ada di feed dan memiliki @id yang berbeda dari BroadcastEvent.
location Text atau Country Wajib jika BroadcastEvent ditujukan untuk SportsEvent, yaitu memiliki properti broadcastOfEvent - Negara tempat SportsEvent pokok 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 tidak.
Sangat disarankan agar entitas BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
offAir Boolean Wajib jika berlaku - Gunakan properti ini jika tidak ada siaran konten yang direncanakan untuk slot waktu.
Sangat disarankan agar entitas BroadcastEvent menyertakan setidaknya salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
isLiveBroadcast Boolean Tetapkan ke true jika ini adalah acara live; misalnya, acara olahraga atau konser.
potentialAction WatchAction Wajib jika berlaku - Jika konten disiarkan sebagai acara live streaming tanpa channel (dengan contentToBeAnnounced ditetapkan ke false atau offAir ditetapkan ke false) , gunakan properti ini untuk memberikan deep link acara.
identifier PropertyValue ID eksternal yang mengidentifikasi konten siaran. Lihat bagian Properti ID untuk mengetahui detailnya.
  • Catatan: Jenis entity BroadcastEvent hanya menerima nilai propertyID berupa TMS_ID atau TMS_ROOT_ID.
  • Properti ini hanya boleh diberikan untuk kasus saat entitas 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 disukai daripada nilai TMS_ROOT_ID.
contentRating Text atau Rating Wajib untuk konten dewasa, sangat direkomendasikan untuk konten lainnya Mengapa? - Rating konten keseluruhan dari konten siaran. Jika rating konten diberikan dalam bentuk string teks, dua variasi diterima:
  • Lembaga pemeringkat ditambahkan ke rating dengan spasi di antaranya. Misalnya, rating "PG-13" dari lembaga "MPAA" di Amerika Serikat harus dideskripsikan sebagai "MPAA PG-13". Lihat daftar agensi.
  • Nilai "RATING NOT KNOWN" (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak mengetahui rating Film.
contentRating.author Organisasi Wajib jika contentRating menggunakan Rating - Nama lembaga pemberi rating.
contentRating.ratingValue Teks Wajib diisi jika contentRating menggunakan Rating - Nilai rating.
contentRating.advisoryCode Teks Kode saran 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": "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"
        }
      ]
    }
  }
}

Jaringan televisi Example TV(BroadcastService) tidak mengudara antara pukul 12.00 hingga 20.00 dan menyiarkan 1 acara bernama My favorite show antara pukul 20.00 hingga 00.00:

BroadcastEvent 

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "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 mengetahui topik yang terkait dengan properti ini: