실시간 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는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (TV 프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다. 통합 리소스 식별자 (URI) 형식임 @id 값에 사용되는 도메인은 조직에서 소유해야 합니다. 항목의 url이 식별자로서 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
name	텍스트	필수 - TV 프로그램 또는 이벤트의 제목
description	텍스트	TV 프로그램 또는 이벤트에 대한 설명 300자 제한 배열을 사용하여 여러 언어와 길이로 설명을 포함합니다.
startDate	날짜	필수 - 시간대가 포함된 ISO 8601 형식의 이벤트 시작 시간
endDate	날짜	시간대가 포함된 ISO 8601 형식의 이벤트 종료 시간
publishedOn	BroadcastService	해당하는 경우 필수 - 이 TV 프로그램 또는 이벤트를 브로드캐스트하는 BroadcastService 항목을 지정합니다. 콘텐츠가 TV 채널에서 브로드캐스트되는 경우 이 속성은 필수입니다. 콘텐츠가 TV 채널과 연결되어 있지 않으면 이 속성을 제공하지 마세요.
publishedOn.@type	텍스트	BroadcastService로 설정합니다.
publishedOn.@id	URL	이 TV 프로그램 또는 이벤트를 브로드캐스트하는 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와 다른 @id를 가져야 합니다.
location	텍스트 또는 국가	BroadcastEvent가 SportsEvent용인 경우(즉, broadcastOfEvent 속성이 있는 경우) 필수 - 기본 SportsEvent를 브로드캐스트할 수 있는 국가입니다. 여러 국가에서 SportsEvent를 브로드캐스트할 수 있는 경우 이 필드는 국가 목록일 수 있습니다.
videoFormat	텍스트	이 브로드캐스트 서비스에서 지원되는 최고 품질 정의입니다(예: 표준 화질의 경우 'SD' 고화질의 경우 'HD' 2K 해상도의 경우 '2K' 4K 해상도의 경우 '4K' 8K 해상도의 경우 '8K'
contentToBeAnnounced	Boolean	해당하는 경우 필수 - 피드를 만들 때 콘텐츠를 알 수 없는 경우 이 속성을 사용합니다. 제공업체에 브로드캐스트될 콘텐츠에 관한 최신 정보가 없는 경우 true로 설정하고, 그렇지 않은 경우 false로 설정합니다. `BroadcastEvent` 항목에는 다음 중 하나 이상을 포함하는 것이 좋습니다. 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_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": "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라는 TV 프로그램 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, 이름 수집
• 콘텐츠의 메타데이터 수집