실시간 TV 이벤트의 콘텐츠 마크업 속성

이 섹션에서는 BroadcastEvent 항목 유형의 콘텐츠 마크업 속성에 대해 자세히 설명합니다. 이러한 유형 간의 관계를 더 잘 이해하려면 LiveTV 이벤트 개념을 검토하세요.

BroadcastEvent 사양 테이블

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • xxBCP 47 형식 형식의 항목 언어 코드로 바꿉니다(예: 'en').
@type 텍스트 필수: 항상 BroadcastEvent로 설정됩니다.
@id URL 필수: URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).
@id은 다음 요건을 충족해야 합니다.
  • 카탈로그에서 전역적으로 고유함
  • 정적 ID: 프로그램의 URL 속성이 변경되더라도 ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직의 소유여야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id으로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
name 텍스트 필수: 프로그램 또는 이벤트의 제목입니다.
description 텍스트 프로그램 또는 이벤트에 대한 설명입니다. 300자(영문 기준) 배열을 사용하여 설명을 여러 언어 및 길이로 포함할 수 있습니다.
startDate 날짜 필수: 이벤트가 시작된 ISO 8601 형식의 시간대입니다.
endDate 날짜 이벤트가 종료되는 ISO 8601 형식의 시간대입니다.
publishedOn BroadcastService 해당하는 경우 필수 - 이 프로그램이나 이벤트를 방송하는 BroadcastService 항목을 지정합니다.

콘텐츠가 TV 채널에서 방송되는 경우 이 속성은 필수입니다. 콘텐츠가 TV 채널과 연결되어 있지 않으면 이 속성을 제공하지 마세요.
publishedOn.@type 텍스트 BroadcastService로 설정합니다.
publishedOn.@id URL 이 프로그램 또는 이벤트를 브로드캐스트하는 BroadcastService 항목의 @id입니다.
workPerformed CreativeWork 해당하는 경우 필수 - 콘텐츠가 Movie, TVSeries, TVEpisode 항목 유형 중 하나인 경우 이 속성을 사용합니다.
BroadcastEvent 항목에 다음 중 하나 이상을 포함하는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue으로 설정
  • offAirtrue으로 설정
workPerformed.@type 텍스트 Movie, TVSeries 또는 TVEpisode로 설정합니다.
workPerformed.@id URL 콘텐츠 항목의 @id입니다.
broadcastOfEvent SportsEvent 해당하는 경우 필수 - 콘텐츠가 실시간 이벤트인 경우 이 속성을 사용합니다.
  • 스포츠 이벤트의 경우 이 속성은 SportsEvent 항목을 참조해야 합니다.

BroadcastEvent 항목에는 다음 중 하나 이상이 포함되는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue으로 설정
  • offAirtrue으로 설정
broadcastOfEvent.@type 텍스트 SportsEvent로 설정합니다.
broadcastOfEvent.@id URL 이벤트 항목의 @id입니다. 이벤트 항목이 피드에 있어야 하며 @id과(와) BroadcastEvent의 이벤트 항목이 달라야 합니다.
videoFormat 텍스트 이 방송 서비스에서 지원되는 최고 화질 정의(예:
    )
  • 'SD'는 표준 화질을 나타냅니다.
  • 고화질: 'HD'
  • '2K'는 2K 해상도입니다.
  • '4K'(4K 해상도)
  • '8K'는 8K 해상도입니다.
contentToBeAnnounced Boolean 해당하는 경우 필수 - 피드를 만들 때 콘텐츠를 알 수 없는 경우 이 속성을 사용합니다.

제공할 콘텐츠에 관한 최신 정보가 없는 경우 true로 설정하고 그렇지 않으면 false를 설정합니다.
BroadcastEvent 항목에 다음 중 하나 이상을 포함하는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue으로 설정
  • offAirtrue으로 설정
offAir Boolean 해당하는 경우 필수 - 시간대에 맞는 콘텐츠 방송이 없는 경우 이 속성을 사용합니다.
BroadcastEvent 항목에는 다음 중 하나 이상이 포함되는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue으로 설정
  • offAirtrue으로 설정
isLiveBroadcast Boolean 실시간 이벤트(예: 스포츠 이벤트 또는 콘서트)인 경우 true로 설정합니다.
potentialAction WatchAction 해당하는 경우 필수 - 콘텐츠가 실시간 스트림을 덜 제공하는 실시간 이벤트 (contentToBeAnnouncedfalse 또는 offAirfalse로 설정된 경우)로 방송되는 경우 이 속성을 사용하여 이벤트의 딥 링크를 제공합니다.
identifier PropertyValue 방송 콘텐츠를 식별하는 외부 ID입니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
  • 참고: BroadcastEvent 항목 유형은 TMS_ID 또는 TMS_ROOT_IDpropertyID 값만 허용합니다.
  • 이 속성은 완전히 구성된 최상위 Movie, TVSeries, TVEpisode 또는 SportsEvent 항목이 workPerformed 또는 broadcastOfEvent 속성을 사용하여 참조되지 않는 경우에만 제공해야 합니다.
  • 속성 값은 이상적으로 workPerformed 또는 broadcastOfEvent 속성을 사용하여 참조하는 Movie, TVSeries, TVEpisode 또는 SportsEvent 항목의 TMS_ID 또는 TMS_ROOT_ID를 반영해야 합니다.
  • TMS_ROOT_ID 값보다 TMS_ID가 선호됩니다.
contentRating 텍스트 또는 평점 성인용 콘텐츠에는 필수 항목이며 그 외의 경우에는 적극 권장됩니다. 이유가 무엇인가요? - 방송 콘텐츠의 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 지정된 경우 두 가지 변형이 허용됩니다.
  • 평가 기관이 평가 앞에 추가되어 있고 그 사이에 공백이 있습니다. 예를 들어 미국에 있는 대행사 'MPAA'의 'PG-13' 등급은 'MPAA PG-13'으로 표시해야 합니다. 대행사 목록을 확인하세요.
  • 'RATING NOT KNOWN' (대소문자를 구분하지 않음) 값은 영화의 평점을 알 수 없음을 나타냅니다.
contentRating.author 텍스트 또는 조직 contentRating에서 Rating를 사용하는 경우 필수 - 평가 기관의 이름입니다.
contentRating.ratingValue 텍스트 contentRating에서 Rating를 사용하는 경우 필수 - 평점의 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 권고 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력

예시

2019년 10월 12일 오후 9시부터 오후 9시 30분 사이에 TV 네트워크 Example TV(BroadcastService)에서 TV 에피소드가 방송됩니다.

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

브로드캐스트 서비스

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

2019년 10월 12일 오후 9시에서 9시 30분 사이에 텔레비전 네트워크 TV 예(BroadcastService)에서 방송할 콘텐츠가 contentToBeAnnounced로 설정된 경우의 피드를 만드는 시점을 알 수 없는 경우의 예는 다음과 같습니다.

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
}

브로드캐스트 서비스

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

텔레비전 네트워크 예시 TV(BroadcastService) 채널이 오후 12시부터 오후 8시까지 방송 중이며 오후 8시부터 오후 12시까지 My favorite show라는 방송 1개를 방송합니다.

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

}

브로드캐스트 서비스

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

이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.