Properti markup konten acara TV live

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

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 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 jika properti URL acara berubah). String 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 entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Judul acara atau acara.
description Teks Deskripsi acara atau acara. Terbatas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam berbagai bahasa dan panjang.
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.
publishedOn BroadcastService Wajib jika berlaku - Tentukan entitas BroadcastService yang menyiarkan acara atau acara ini.

Jika konten disiarkan di saluran TV, properti ini bersifat wajib. Jika konten tidak terkait dengan saluran TV mana pun, jangan berikan properti ini.
publishedOn.@type Teks Tetapkan ke BroadcastService.
publishedOn.@id URL @id dari entity BroadcastService yang menyiarkan acara atau acara ini.
workPerformed CreativeWork Wajib jika berlaku - Gunakan properti ini jika konten merupakan salah satu dari jenis entitas berikut: Movie, TVSeries, dan TVEpisode.
Sebaiknya entitas 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 entity konten.
broadcastOfEvent SportsEvent Wajib jika berlaku - Gunakan properti ini jika konten adalah acara live:
  • Untuk acara olahraga, properti ini harus merujuk ke entity SportsEvent.

Sebaiknya entitas BroadcastEvent menyertakan minimal 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. Entitas peristiwa harus ada dalam feed dan memiliki @id yang berbeda dari BroadcastEvent.
location Teks atau Negara Wajib jika BroadcastEvent ditujukan untuk SportsEvent, yaitu memiliki properti broadcastOfEvent - Negara tempat SportsEvent dasar dapat disiarkan. Kolom ini dapat berupa daftar negara jika beberapa negara dapat menyiarkan SportsEvent.
videoFormat Teks Definisi dengan kualitas tertinggi yang didukung di layanan siaran ini; misalnya,
  • "SD" untuk definisi standar.
  • "HD" untuk definisi tinggi.
  • "2 rb" untuk resolusi 2K.
  • "4K" untuk resolusi 4K.
  • "8 RB" 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 konten yang akan disiarkan, false jika tidak.
Sebaiknya 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.
Sebaiknya entitas BroadcastEvent menyertakan minimal salah satu dari:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced disetel ke true
  • offAir disetel ke true
isLiveBroadcast Boolean Tetapkan ke true jika acara ini live; misalnya, acara olahraga atau konser.
potentialAction WatchAction Wajib jika berlaku - Jika konten disiarkan sebagai acara live streaming di bawah channel (dengan contentToBeAnnounced ditetapkan ke false atau offAir ditetapkan ke false) , gunakan properti ini untuk menyediakan 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 untuk TMS_ID atau TMS_ROOT_ID.
  • Properti ini hanya boleh diberikan untuk kasus saat entity Movie, TVSeries, TVEpisode, atau SportsEvent level teratas yang terbentuk sepenuhnya tidak direferensikan menggunakan properti workPerformed atau broadcastOfEvent.
  • Nilai properti harus mencerminkan TMS_ID atau TMS_ROOT_ID dari entity Movie, TVSeries, TVEpisode, atau SportsEvent yang idealnya akan 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 jika tidak Mengapa? - Rating konten secara keseluruhan pada konten siaran. Jika rating konten diberikan dalam bentuk string teks, dua variasi dapat diterima:
  • Lembaga rating menambahkan spasi kosong di antaranya sebelum rating ditambahkan. Misalnya, "PG-13" rating dari agensi "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 rating.
contentRating.ratingValue Teks Wajib jika contentRating menggunakan Rating - Nilai rating.
contentRating.advisoryCode Teks Kode saran untuk konten. Nilai yang diterima termasuk 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 Contoh TV (BroadcastService) antara pukul 21.00 hingga 21.30 tanggal 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 jika konten akan menyiarkan di jaringan televisi Contoh 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 Contoh TV(BroadcastService) Saluran tidak disiarkan antara pukul 12.00 dan 20.00 dan menyiarkan 1 acara bernama My favorite show antara pukul 8.00 pm dan 12.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 topik yang terkait dengan properti ini: