이 페이지는 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`를 가집니다.
`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` `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	성인용 콘텐츠의 경우 필수사항이며 다른 경우에는 적극 권장됩니다. 이유 - 방송 콘텐츠의 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다. 등급 부여 기관이 등급 앞에 공백을 두었습니다. 예를 들어 '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"
        }
      ]
    }
  }
}

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

BroadcastEvent 사양 테이블

예

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

BroadcastEvent

BroadcastService

관련 페이지