Properti markup konten acara TV live

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

Tabel spesifikasi BroadcastEvent

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.org", {"@language": "xx"}]
  • Ganti xx dengan kode bahasa entity 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 properti URL acara tersebut berubah). Link 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 Pengenal untuk detail selengkapnya.
name Teks Wajib - Judul acara atau acara.
description Teks Deskripsi acara atau acara. Panjang limist 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 entitas 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.
Sangat disarankan agar 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 entitas konten.
broadcastOfEvent SportsEvent Wajib jika berlaku - Gunakan properti ini jika konten merupakan 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 peristiwa. Entitas peristiwa 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 SportsEvent dapat disiarkan di beberapa negara.
videoFormat Teks Definisi kualitas tertinggi yang didukung pada 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 ketika 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 terencana untuk slot waktu tersebut.
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 ditayangkan sebagai channel tanpa acara live streaming (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 baik TMS_ID maupun TMS_ROOT_ID.
  • Properti ini hanya boleh diberikan untuk kasus saat entitas tingkat atas Movie, TVSeries, TVEpisode, atau SportsEvent yang sudah dibentuk 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 Anda rujuk 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 keseluruhan konten siaran. Jika rating konten diberikan dalam bentuk string teks, ada dua variasi yang diterima:
  • Lembaga rating ditambahkan ke rating dengan spasi kosong di antaranya. Misalnya, rating "PG-13" dari agensi "ARPPU" 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 tahu rating untuk Film tersebut.
contentRating.author Text atau Organization Wajib diisi 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 mencakup D, FV, L, S, dan V. D = Dialog, FV = Kekerasan Fantasi , L = Bahasa, S = Konten Seksual, V = Kekerasan.

Contoh

Episode TV ditayangkan di jaringan televisi Contoh 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 jika konten yang akan disiarkan 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 hingga 20.00 dan menyiarkan 1 acara bernama My favorite show antara pukul 20.00 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"
        }
      ]
    }
  }
}

Buka halaman berikut untuk mencari topik yang terkait dengan properti ini: