Canlı TV etkinliklerinin içerik işaretleme özellikleri

Bu bölümde, BroadcastEvent varlık türü için içerik işaretleme özelliklerinin ayrıntıları verilmektedir. Bu türler arasındaki ilişkiyi daha iyi anlamak için LiveTV etkinlikleri kavramlarını inceleyin.

BroadcastEvent spesifikasyon tablosu

Mülk Beklenen Tür Açıklama
@context Metin Zorunlu: Her zaman ["http://schema.org", {"@language": "xx"}]
olarak ayarlanır
@type Metin Zorunlu: Her zaman BroadcastEvent olarak ayarlanır.
@id URL Zorunlu: Yayın aralığının URI biçimindeki tanımlayıcısıdır. Örneğin, https://example.com/live/channel1/20191012T2100.
@id aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuzda benzersiz olmalı ve workPerformed.@id veya broadcastOfEvent.@id değerinden farklı olmalıdır (örneğin, kanal/hizmet ve yayın başlangıç zamanını URI'ye dahil edin).
  • Statik: Kimlik sabit olmalı ve zaman içinde değişmemelidir. Bu dize, opak bir dize olarak değerlendirilir ve çalışan bir bağlantı olması gerekmez.
  • Birleşik Kaynak Tanımlayıcı (URI) biçiminde
  • @id değeri için kullanılan alan, kuruluşunuza ait olmalıdır.
Önemli: BroadcastEvent veya SportsEvent için url özelliği eklemeyin. Standart url değerini yalnızca temel içerik varlığında (Movie, TVSeries veya TVEpisode) sağlayın. Daha fazla bilgi için Tanımlayıcı bölümüne bakın.
name Metin Zorunlu: Programın veya etkinliğin başlığı.
description Metin Programın veya etkinliğin açıklaması. 300 karakter sınırlaması vardır. Birden fazla dilde açıklama eklemek için bir dizi kullanın (her dil için bir tane).
startDate Tarih Zorunlu: Etkinliğin saat dilimiyle birlikte ISO 8601 biçimindeki başlangıç zamanı.
endDate Tarih Etkinliğin saat dilimiyle birlikte ISO 8601 biçimindeki bitiş zamanı.
publishedOn BroadcastService Geçerliyse zorunlu: Bu programı veya etkinliği yayınlayan BroadcastService varlığını belirtin.

İçerik bir TV kanalında yayınlanıyorsa bu özellik zorunludur. İçerik herhangi bir TV kanalıyla ilişkili değilse bu özelliği sağlamayın.
publishedOn.@type Metin BroadcastService olarak ayarlayın.
publishedOn.@id URL Bu programı veya etkinliği yayınlayan BroadcastService varlığının @id.
workPerformed CreativeWork Geçerli olduğu durumlarda zorunlu: İçerik şu varlık türlerinden biriyse bu özelliği kullanın: Movie, TVSeries ve TVEpisode.
BroadcastEvent varlığının aşağıdakilerden en az birini içermesi önemle tavsiye edilir:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced adresi true olarak ayarlandı
  • offAir adresi true olarak ayarlandı
workPerformed.@type Metin Movie, TVSeries veya TVEpisode olarak ayarlayın.
workPerformed.@id URL İçerik öğesinin @id.
broadcastOfEvent SportsEvent Geçerli olduğu durumlarda zorunlu: İçerik canlı etkinlikse bu özelliği kullanın:
  • Spor etkinlikleri için bu özelliğin bir SportsEvent varlığına referans vermesi gerekir.

BroadcastEvent öğesinin aşağıdakilerden en az birini içermesi önemle tavsiye edilir:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced adresi true olarak ayarlandı
  • offAir adresi true olarak ayarlandı
broadcastOfEvent.@type Metin SportsEvent olarak ayarlayın.
broadcastOfEvent.@id URL Etkinlik varlığının @id. Etkinlik öğesi feed'de bulunmalı ve BroadcastEvent değerinden farklı bir @id değerine sahip olmalıdır.
location Metin veya Ülke BroadcastEvent bir SportsEvent içinse (yani broadcastOfEvent özelliğine sahipse) zorunludur: Temel SportsEvent'in yayınlanabileceği ülke. SportsEvent birden fazla ülkede yayınlanabiliyorsa bu alan bir ülke listesi olabilir.
videoFormat Metin Bu yayın hizmetinde desteklenen en yüksek kalite tanımı; örneğin,
  • Standart çözünürlük için "SD".
  • Yüksek çözünürlük için "HD".
  • 2K çözünürlük için "2K".
  • 4K çözünürlük için "4K"
  • 8K çözünürlük için "8K".
contentToBeAnnounced Boole Geçerli olduğu durumlarda zorunlu: Feed oluşturulurken içerik bilinmiyorsa bu özelliği kullanın.

Sağlayıcı, yayınlanacak içerikle ilgili güncel bilgilere sahip değilse true, aksi takdirde false olarak ayarlayın.
BroadcastEvent öğesinin aşağıdakilerden en az birini içermesi önemle tavsiye edilir:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced adresi true olarak ayarlandı
  • offAir adresi true olarak ayarlandı
offAir Boole Geçerli olduğu durumlarda zorunlu: BroadcastService kanalında zaman aralığı için planlanmış içerik yayını olmadığında true olarak ayarlanır.
  • Hem name hem de description değerini "Off Air" olarak ayarlayın.
  • Her offAir BroadcastEvent, 4 saat veya daha kısa olmalıdır (24 saatlik kesintisiz bloklar yayınlamayın). Bir kanal 4 saatten uzun süre yayın yapmadığında, kanalın feed penceresinin başında veya sonunda boşluk olmadan 7/24 tam yayın akışı kapsamını koruması için her biri en fazla 4 saat olan birden fazla bitişik, çakışmayan BroadcastEvent öğesi yayınlayın.
BroadcastEvent varlığının aşağıdakilerden en az birini içermesi önemle tavsiye edilir:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced adresi true olarak ayarlandı
  • offAir adresi true olarak ayarlandı
isLiveBroadcast Boole Bu yayın canlı bir yayınsa (ör. canlı spor maçı veya canlı günlük haberler) boole true (tırnak işareti olmadan) değerine, canlı olmayan programlar ve tekrarlar için false değerine ayarlayın.
potentialAction WatchAction Geçerli durumlarda zorunlu: broadcastOfEvent bir SportsEvent öğesine referans verdiğinde (tüm Sports derin bağlantılarını SportsEvent.potentialAction öğesine yerleştirin) veya publishedOn bir BroadcastService kanalına referans verdiğinde (kanal derin bağlantılarını BroadcastService.potentialAction öğesine yerleştirin) BroadcastEvent üzerinde hiçbir zaman potentialAction sağlamayın. Yalnızca bir SportsEvent öğesine referans vermeyen kanalsız canlı yayınlar için BroadcastEvent.potentialAction sağlayın (ör. contentToBeAnnounced ve offAir atlanmış veya false olan bağımsız canlı yardımcı içerikler).
identifier PropertyValue Yayın içeriğini tanımlayan harici kimlik. Ayrıntılar için Tanımlayıcı özellikleri bölümüne bakın.
  • Not: BroadcastEvent öğe türü, yalnızca TMS_ID veya TMS_ROOT_ID değerlerinden birini içeren propertyID değerlerini kabul eder.
  • Bu özellik yalnızca tam olarak oluşturulmuş üst düzey bir Movie, TVSeries, TVEpisode veya SportsEvent varlığına workPerformed ya da broadcastOfEvent özelliği kullanılarak referans verilmediği durumlarda sağlanmalıdır.
  • Özelliğin değeri, ideal olarak workPerformed veya broadcastOfEvent özelliğini kullanarak referans verdiğiniz Movie, TVSeries, TVEpisode ya da SportsEvent varlığının TMS_ID veya TMS_ROOT_ID değerini yansıtmalıdır.
  • TMS_ID, TMS_ROOT_ID değerine tercih edilir.
contentRating Metin veya Puan Yetişkinlere uygun içerikler için zorunludur, diğer içerikler için de kullanılması önemle tavsiye edilir. Neden? - Yayınlanan içeriğin genel içerik derecelendirmesi. İçerik derecelendirmesi metin dizesi biçiminde verilirse iki varyasyon kabul edilir:
  • Derecelendirme kuruluşunun adı, derecelendirmenin başına eklenir ve aralarında bir boşluk bulunur. Örneğin, ABD'deki "MPAA" kurumundan alınan "PG-13" derecelendirmesi "MPAA PG-13" olarak tanımlanmalıdır. Ajansların listesini inceleyin.
  • Filmin derecelendirmesini bilmediğinizi belirtmek için "RATING NOT KNOWN" (büyük/küçük harfe duyarlı değildir) değeri.
contentRating.author Kuruluş contentRating, Rating kullanıyorsa zorunludur: Derecelendirme kuruluşunun adı.
contentRating.ratingValue Metin contentRating, Rating kullanıyorsa zorunludur: Derecelendirmenin değeri.
contentRating.advisoryCode Metin İçeriğin tavsiye kodu. Kabul edilen değerler arasında D, FV, L, S ve V bulunur. D = Diyalog, FV = Fantastik Şiddet, L = Dil, S = Cinsel İçerik, V = Şiddet.

Örnekler

Bir TV bölümü, 12 Ekim 2019'da 21:00 ile 21:30 arasında Örnek TV televizyon ağında (BroadcastService) yayınlanır:

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"
        }
      ]
    }
  }
}

12 Ekim 2019'da 21:00 ile 21:30 arasında Örnek TV televizyon ağında (BroadcastService) yayınlanacak içerik, feed oluşturulurken bilinmediğinde contentToBeAnnounced özelliğinin kullanımını gösteren örnek:

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"
        }
      ]
    }
  }
}

Example TV (BroadcastService) televizyon ağı kanalı 12:00-20:00 saatleri arasında yayında değildir (bitişik iki adet 4 saatlik Off Air blok olarak modellenmiştir) ve 20:00-00:00 saatleri arasında My favorite show adlı bir program yayınlar:

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"
        }
      ]
    }
  }
}

Bu özelliklerle ilgili konular için aşağıdaki sayfalara göz atın: