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

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

BroadcastEvent 사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • xx를 BCP 47 형식의 항목 언어 코드(예: 'en')로 바꿉니다.
@type 텍스트 필수 - 항상 BroadcastEvent로 설정됩니다.
@id URL 필수 - URI 형식의 방송 슬롯 식별자입니다(예: https://example.com/live/channel1/20191012T2100).
@id은 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전체에서 전역적으로 고유하며 workPerformed.@id 또는 broadcastOfEvent.@id와 구별됨(예: 채널/서비스 및 방송 시작 시간을 URI에 통합)
  • 정적: ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • URI(Unified Resource Identifier) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
중요: BroadcastEvent 또는 SportsEvent에 url 속성을 포함하지 마세요. 기본 콘텐츠 항목(Movie, TVSeries 또는 TVEpisode)에만 표준 url를 제공합니다. 자세한 내용은 식별자 섹션을 참고하세요.
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
  • contentToBeAnnounced을 true으로 설정
  • offAir을 true으로 설정
workPerformed.@type 텍스트 Movie, TVSeries 또는 TVEpisode로 설정합니다.
workPerformed.@id URL 콘텐츠 항목의 @id입니다.
broadcastOfEvent SportsEvent 해당하는 경우 필수 - 콘텐츠가 라이브 이벤트인 경우 이 속성을 사용합니다.
  • 스포츠 이벤트의 경우 이 속성은 SportsEvent 항목을 참조해야 합니다.

BroadcastEvent 항목에는 다음 중 하나 이상을 포함하는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced을 true으로 설정
  • offAir을 true으로 설정
broadcastOfEvent.@type 텍스트 SportsEvent로 설정합니다.
broadcastOfEvent.@id URL 이벤트 항목의 @id입니다. 이벤트 항목이 피드에 있어야 하며 BroadcastEvent와 다른 @id가 있어야 합니다.
location 텍스트 또는 국가 BroadcastEvent가 SportsEvent인 경우, 즉 broadcastOfEvent 속성이 있는 경우 필수 - 기본 SportsEvent를 방송할 수 있는 국가입니다. 여러 국가에서 SportsEvent를 중계할 수 있는 경우 이 필드는 국가 목록일 수 있습니다.
videoFormat 텍스트 이 방송 서비스에서 지원되는 최고 품질 정의입니다(예:
    ).
  • 'SD': 표준 화질
  • 'HD'는 고화질을 의미합니다.
  • 2K 해상도의 경우 '2K'
  • 4K 해상도의 경우 '4K'
  • 8K 해상도의 경우 '8K'
contentToBeAnnounced Boolean 해당하는 경우 필수 - 피드 생성 시 콘텐츠를 알 수 없는 경우 이 속성을 사용합니다.

제공업체에 방송될 콘텐츠에 관한 최신 정보가 없는 경우 true로 설정하고, false 그렇지 않은 경우로 설정합니다.
BroadcastEvent 항목에는 다음 중 하나 이상을 포함하는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced을 true으로 설정
  • offAir을 true으로 설정
offAir Boolean 해당하는 경우 필수 - BroadcastService 채널의 시간대에 예정된 콘텐츠 방송이 없는 경우 true로 설정합니다.
  • name와 description를 모두 "Off Air"로 설정합니다.
  • 각 offAir BroadcastEvent는 4시간 이하여야 합니다(24시간 연속 블록을 전송하지 않음). 채널이 4시간 이상 방송되지 않는 경우, 채널이 피드 기간의 시작 또는 끝에 공백 없이 완전한 24x7 편성 범위를 유지하도록 각각 최대 4시간의 연속적이고 겹치지 않는 여러 BroadcastEvent 항목을 내보냅니다.
BroadcastEvent 항목에는 다음 중 하나 이상을 포함하는 것이 좋습니다.
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced을 true으로 설정
  • offAir을 true으로 설정
isLiveBroadcast Boolean 이 방송이 라이브 방송(예: 라이브 스포츠 경기 또는 라이브 일일 뉴스)인 경우 불리언 true(따옴표 없음)로 설정하고, 라이브가 아닌 프로그램 및 다시보기의 경우 false로 설정합니다.
potentialAction WatchAction 해당하는 경우 필수 - broadcastOfEvent가 SportsEvent를 참조하는 경우(모든 스포츠 딥 링크를 SportsEvent.potentialAction에 배치) 또는 publishedOn가 BroadcastService 채널을 참조하는 경우(채널 딥 링크를 BroadcastService.potentialAction에 배치) BroadcastEvent에 potentialAction를 제공하지 마세요. SportsEvent를 참조하지 않는 채널 없는 라이브 스트림(예: contentToBeAnnounced 및 offAir가 생략되거나 false인 독립형 라이브 부가 콘텐츠)에만 BroadcastEvent.potentialAction를 제공하세요.
identifier PropertyValue 방송 콘텐츠를 식별하는 외부 ID입니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
  • 참고: BroadcastEvent 항목 유형은 TMS_ID 또는 TMS_ROOT_ID의 propertyID 값만 허용합니다.
  • 이 속성은 완전히 형성된 최상위 Movie, TVSeries, TVEpisode 또는 SportsEvent 항목이 workPerformed 또는 broadcastOfEvent 속성을 사용하여 참조되지 않는 경우에만 제공해야 합니다.
  • 속성 값은 workPerformed 또는 broadcastOfEvent 속성을 사용하여 참조하는 것이 이상적인 Movie, TVSeries, TVEpisode 또는 SportsEvent 항목의 TMS_ID 또는 TMS_ROOT_ID를 반영해야 합니다.
  • TMS_ID는 TMS_ROOT_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 = 폭력.

예

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

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

2019년 10월 12일 오후 9시에서 오후 9시 30분 사이에 텔레비전 네트워크 Example TV(BroadcastService)에서 방송될 콘텐츠를 피드 생성 시점에 알 수 없는 경우 contentToBeAnnounced 속성을 사용하는 예:

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) 채널은 오후 12시부터 오후 8시까지 방송되지 않으며(4시간짜리 연속 Off Air 블록 2개로 모델링됨) 오후 8시부터 오전 12시까지 My favorite show라는 프로그램을 하나 방송합니다.

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

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