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 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 gunakan url entity sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
name Teks Wajib - Judul acara TV atau acara.
description Teks Deskripsi acara TV atau acara. Batas 300 karakter. Gunakan array untuk menyertakan deskripsi dalam beberapa 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 peristiwa ini.

Jika konten disiarkan di channel TV, properti ini wajib diisi. Jika konten tidak dikaitkan dengan saluran TV apa pun, jangan berikan properti ini.
publishedOn.@type Teks Tetapkan ke BroadcastService.
publishedOn.@id URL @id dari entitas BroadcastService yang menyiarkan acara atau peristiwa ini.
workPerformed CreativeWork Wajib jika berlaku - Gunakan properti ini jika konten adalah salah satu jenis entity berikut: Movie, TVSeries, dan TVEpisode.
Sebaiknya 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.

Sebaiknya 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 dengan BroadcastEvent.
location Text atau Country Wajib 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 high-definition.
  • "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.
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 tersebut.
Sebaiknya 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 dari TMS_ID atau TMS_ROOT_ID.
  • Properti ini hanya boleh diberikan jika 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 akan Anda referensikan menggunakan properti workPerformed atau broadcastOfEvent.
  • TMS_ID lebih disukai daripada nilai TMS_ROOT_ID.
contentRating Text atau Rating Wajib untuk konten khusus dewasa, sangat direkomendasikan jika tidak Mengapa? - Rating konten keseluruhan dari konten siaran. Jika rating konten diberikan dalam bentuk string teks, dua variasi akan diterima:
  • Lembaga pemeringkat ditambahkan di awal rating dengan spasi kosong 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 untuk 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 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:

{
  "@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"
  }
}
{
  "@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:

{
  "@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
}
{
  "@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) Channel tidak mengudara antara pukul 12.00 dan 20.00 dan menyiarkan 1 acara bernama My favorite show antara pukul 20.00 dan 12.00:

{
   "@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"
  },

}
{
  "@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: