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

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

BroadcastEvent 사양 표

속성	예상 유형	설명
@context	텍스트	필수 - 항상 ["http://schema.org", {"@language": "xx"}] 로 설정 xx를 BCP 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 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입니다. 이벤트 항목이 피드에 있어야 하며 @id이(가) BroadcastEvent과(와) 다릅니다.
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	해당하는 경우 필수 - 시간대에 계획된 콘텐츠 방송이 없는 경우 이 속성을 사용합니다. BroadcastEvent 항목에는 다음 중 하나 이상을 포함하는 것이 좋습니다. workPerformed broadcastOfEvent contentToBeAnnounced을 true으로 설정 offAir을 true으로 설정
isLiveBroadcast	Boolean	실시간 이벤트(예: 스포츠 이벤트 또는 콘서트)인 경우 true로 설정합니다.
potentialAction	WatchAction	해당하는 경우 필수 - 콘텐츠가 실시간 스트리밍 이벤트가 아닌 채널 이벤트로 방송되는 경우 (contentToBeAnnounced를 false로 설정하거나 offAir를 false로 설정) 이 속성을 사용하여 이벤트의 딥 링크를 제공합니다.
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_ROOT_ID 값보다 TMS_ID가 선호됩니다.
contentRating	Text 또는 Rating	성인용 콘텐츠에 필수이며, 그렇지 않은 경우 적극 권장됩니다. 이유 - 방송 콘텐츠의 전반적인 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 지정된 경우 다음 두 가지 변형이 허용됩니다. 등급 부여 기관이 평점 앞에 공백을 추가합니다. 예를 들어 미국 기관 'MPAA'의 'PG-13' 등급은 'MPAA PG-13'으로 설명되어야 합니다. 대행사 목록을 참조하세요. 영화의 등급을 모른다는 것을 나타내기 위한 '등급 없음' 값(대소문자를 구분하지 않음)
contentRating.author	Text 또는 Organization	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분 사이에 텔레비전 네트워크 예시 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
}

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시에 외방이고 오후 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"
  },

}

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

관련 페이지

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

• 콘텐츠 항목 유형 명시
• 콘텐츠의 ID, URL, 이름 수집
• 콘텐츠의 메타데이터 수집