실시간 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 속성이 변경되더라도 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (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입니다. 이벤트 항목은 피드에 있어야 하며 BroadcastEvent의 항목과 다른 @id를 가집니다.
location Text 또는 Country BroadcastEvent가 SportsEvent용인 경우(예: broadcastOfEvent 속성이 있는 경우) 필수 - 기본 SportsEvent가 방송될 수 있는 국가입니다. 여러 국가에서 SportsEvent를 방송할 수 있는 경우 이 필드는 국가 목록이 될 수 있습니다.
videoFormat 텍스트 본 방송 서비스에서 지원하는 최고 품질의 화질이어야 합니다. 예:
  • 'SD' 를 참조하세요.
  • 'HD' 고화질로도 볼 수 있죠.
  • '2,000' 2K 해상도
  • '4K' 4K 해상도로 시청할 수 있습니다.
  • '8,000' 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 Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 다른 경우에는 적극 권장됩니다. 이유 - 방송 콘텐츠의 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다.
  • 등급 부여 기관이 등급 앞에 공백을 두었습니다. 예를 들어 'PG-13'입니다. 대행사 'MPAA' 등급 'MPAA PG-13'으로 설명되어야 합니다. 대행사 목록을 참고하세요.
  • '등급 알 수 없음' 값 (대소문자를 구분하지 않음)를 사용하여 영화의 등급을 모를 수 있습니다.
contentRating.author Organization contentRating님이 Rating을(를) 사용하는 경우 필수: 등급 부여 기관의 이름입니다.
contentRating.ratingValue 텍스트 contentRating에서 Rating을 사용하는 경우 필수: 평점의 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 자문 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력

TV 에피소드가 TV 방송사인 Example TV에서 방송됩니다. 2019년 10월 12일 오후 9시~오후 9시 30분 사이(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"
        }
      ]
    }
  }
}

콘텐츠가 재생될 때 contentToBeAnnounced 속성의 사용을 보여주는 예 텔레비전 방송 네트워크 예시 TV 2019년 10월 12일 오후 9시에서 오후 9시 30분 사이의 (BroadcastService)는 알 수 없습니다. 다음과 같이 설정합니다.

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

텔레비전 방송사 예시 TV(BroadcastService) 채널이 방송 중입니다. 오후 12시부터 오후 8시까지, 8시 사이에 My favorite show라는 프로그램 1개 방송 오후 12시와 오후 12시:

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

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