이 페이지는 Cloud Translation API를 통해 번역되었습니다.

실시간 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`입니다. 이벤트 항목은 피드에 있어야 하며 `BroadcastEvent`의 `@id`와 다른 `@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	해당하는 경우 필수 - 시간대에 계획된 콘텐츠 방송이 없는 경우 이 속성을 사용합니다. `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`	Text 또는 Rating	성인용 콘텐츠의 경우 필수사항이며, 그렇지 않은 경우 권장사항입니다. 이유 - 방송 콘텐츠의 전반적인 콘텐츠 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다. 평가 기관에서 평점에 공백을 넣고 접두어를 추가했습니다. 예를 들어 미국의 '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분 사이에 TV 방송 네트워크 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라는 프로그램 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"
        }
      ]
    }
  }
}

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

BroadcastEvent 사양 표

예

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

관련 페이지