실시간 TV 채널의 콘텐츠 마크업 속성

이 섹션에서는 BroadcastService, CableOrSatelliteService, TelevisionChannel, Organization 항목 유형의 콘텐츠 마크업 속성에 관한 세부정보를 제공합니다. 이러한 유형 간의 관계를 더 잘 이해하려면 라이브 TV 채널 개념을 검토하세요.

BroadcastService 사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수 - 항상 BroadcastService로 설정합니다.
@id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전반에서 고유함
  • 정적: ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 해당하는 경우 필요 - 인터넷에서 채널을 시청할 수 있는 경우 방송 서비스의 표준 URL입니다. 케이블/위성/무선으로 제공되는 서비스의 경우 선택사항입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시킵니다.
url는 다음 요구사항을 충족해야 합니다.
  • url은 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크의 경우 타겟 객체의 urlTemplate 속성을 참고하세요.
name 텍스트 필수 - 네트워크의 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 여러 리전 및 언어 예시를 참고하세요.
  • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
broadcastDisplayName 텍스트 필수 - 사용자가 일반적으로 프로그램 가이드 등에서 볼 수 있는 방송 네트워크의 표시 이름입니다. 값은 이름 값과 동일할 수 있습니다.
callSign 텍스트 방송 서비스의 정부 공식 호출 부호입니다.
inLanguage Text 또는 Language 적극 권장됨 이유 채널의 기본 방송 언어입니다. IETF BCP 47 표준의 언어 코드 중 하나를 사용하세요.
category 텍스트 적극 권장됨 이유 상품의 카테고리입니다. 대문자 또는 슬래시를 사용하여 카테고리 계층 구조를 비공식적으로 나타낼 수 있습니다(예: 스포츠, 스포츠 > 축구, 뉴스, 영화, 음악, 다큐멘터리).`
contentRating Text 또는 Rating 성인 전용 TV 방송 서비스에 필요 - 채널에서 방송되는 콘텐츠에 대한 가장 제한적인 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 등급 기관을 등급 앞에 넣고 그 사이에 공백을 넣어야 합니다. 예를 들어 미국의 'TVPG' 기관에서 부여한 'TV-Y' 등급은 'TVPG TV-Y'로 표시됩니다. 기관 목록을 참고하세요.
contentRating.author 조직 contentRatingRating를 사용하는 경우 필요 - 신용 평가 기관의 이름입니다.
contentRating.ratingValue 텍스트 contentRatingRating를 사용하는 경우 필요 - 평점 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 고지 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력
description 텍스트 방송 서비스에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다. 배열을 사용하여 여러 언어로 또는 다양한 길이로 설명을 제공합니다.
slogan 텍스트 방송 서비스의 슬로건입니다.
areaServed 국가, , 도시 또는 GeoShape 해당하는 경우 필수 - 채널 전환이 TV 서비스 제공업체에서 처리하는 경우 필요 - 사용자가 방송 서비스를 받을 수 있는 지역입니다. ISO 3166-1 국가 코드를 사용하여 국가를 지정합니다.
  • 배열을 사용하여 여러 영역을 나타냅니다.
  • 국가, , 도시GeoShape와 혼합하지 마세요.
  • logo ImageObject GoogleTV와 통합하는 경우 필수입니다. 그렇지 않은 경우 적극 권장이유 이 방송 서비스를 나타내는 이미지입니다.
    • Google TV 통합에는 어두운 배경에 사용할 수 있는 로고가 하나 필요합니다. 배경은 투명해야 하며 색상 또는 흰색 로고가 있어야 합니다. 로고는 어두운 배경에 명확하게 표시되어야 합니다.
    • 로고 이미지는 1:1, 4:3 또는 16:9 가로세로 비율 (선호도 순으로)을 준수해야 하며 해상도는 80x80픽셀 이상이어야 합니다.
    • 맞춤 속성 이름 contentAttributesforDarkBackground 값을 additionalProperty 속성의 일부로 사용하여 로고를 사용해야 하는 배경 유형을 나타냅니다.
    • 가로세로 비율을 유지하기 위해 추가하는 경우 길이 또는 너비 (둘 다 아님)의 패딩은 허용됩니다.
    • 기타 요구사항 및 사양은 이미지 섹션을 참고하세요.
    아래 예를 참고하세요.
    potentialAction WatchAction 해당하는 경우 필요 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
    videoFormat 텍스트 이 방송 서비스에서 지원되는 최고 품질 정의입니다. 예를 들면
    • 표준 화질의 경우 'SD'
    • 고화질의 경우 'HD'
    • 2K 해상도의 경우 '2K'
    • 4K 해상도의 경우 '4K'
    • 8K 해상도의 경우 '8K'
    broadcastTimezone 텍스트 이 방송 서비스의 시간대입니다(IANA 형식). 예: America/Los_Angeles 여러 시간대에 배열을 사용합니다.
    broadcastAffiliateOf 조직 필수 - 이 방송 서비스의 프로그램을 제공하는 TV 방송 네트워크 또는 이 방송 서비스가 속한 조직입니다.
    broadcastAffiliateOf.@id 텍스트 필수 - TV 네트워크의 @id로 설정합니다.
    broadcastAffiliateOf.@type 텍스트 필수 - 항상 Organization로 설정합니다.
    identifier PropertyValue 적극 권장됨 이유 - 이 항목을 식별하는 외부 또는 기타 ID(예: _PARTNER_ID_) 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
    popularityScore PopularityScoreSpecification 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
    popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
    popularityScore.value 숫자 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다.
    popularityScore.eligibleRegion 국가 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
    Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다.

    BroadcastService 예

    {
        "@context": [
            "http://schema.org",
            {
                "@language": "en"
            }
        ],
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example-tv",
        "name": "EXAMPLE-TV",
        "broadcastDisplayName": "ABCD",
        "url": "http://example.com/stations/example-tv",
        "callSign": "EXA-TV",
        "videoFormat": "SD",
        "inLanguage": "en",
        "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"
            }
        ],
        "popularityScore": {
            "@type": "PopularityScoreSpecification",
            "value": 178,
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        },
        "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",
                    "authenticator": {
                        "@type": "Organization",
                        "name": "TVE"
                    }
                },
                "eligibleRegion": [
                    {
                        "@type": "Country",
                        "name": "US"
                    }
                ]
            }
        },
        "logo": [
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Light",
                "contentUrl": "http://example.com/images/example-logo-light.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forLightBackground"
                        ]
                    }
                ]
            },
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Dark",
                "contentUrl": "http://example.com/images/example-logo-dark.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forDarkBackground"
                        ]
                    }
                ]
            }
        ]
    }
    

    CableOrSatelliteService 사양 표

    속성 예상 유형 설명
    @context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
    로 설정
    • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
    @type 텍스트 필수 - 항상 CableOrSatelliteService로 설정합니다.
    @id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
    @id는 다음 요구사항을 충족해야 합니다.
    • 카탈로그 전반에서 고유함
    • 정적
    • 통합 리소스 식별자 (URI) 형식
    항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
    name 텍스트 필수 - TV 서비스의 이름입니다.
    • 배열을 사용하여 여러 언어로 이름을 나열합니다. 여러 리전 및 언어 예시를 참고하세요.
    • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
    areaServed 국가, , 도시 또는 GeoShape 필수 - 사용자가 방송 서비스를 받을 수 있는 지역입니다.
    provider 조직 필수 - 서비스의 상위 제공업체입니다(해당하는 경우). 예를 들어 ExampleTV는 지역 서비스인 ExampleTV San FranciscoExampleTV San Diego의 제공업체입니다.
    provider.@id 텍스트 필수 - TV 운영자의 ID입니다.
    provider.@type 텍스트 필수 - 항상 Organization로 설정합니다.
    identifier PropertyValue 적극 권장됨 이유 - 이 항목을 식별하는 외부 또는 기타 ID(예: 이 방송 서비스의 Gracenote TMS ID) 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.

    CableOrSatelliteService 예시

    케이블 또는 위성 서비스의 예:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
      "name":"ExampleTV San Francisco",
      "provider": {
        "@type": "Organization",
        "@id": "http://example.com/providers/exampletv"
      },
      "areaServed":[
        {
          "@type":"GeoShape",
          "@id": "http://example.com/area1"
        }
      ],
      "identifier": {
        "@type": "PropertyValue",
        "propertyID": "TMS_ID",
        "value": "12345"
      }
    }
    
    {
      "@type": "GeoShape",
      "@id": "http://example.com/area1",
      "addressCountry": "US",
      "postalCode": [
        "94118",
        "94119"
      ]
    }
    

    가상 다중 채널 동영상 프로그램 배급자 (vMVPD)의 예:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/providers/my-online-example-tv",
      "name":"My Online Example TV",
      "provider": {
        "@type": "Organization",
        "@id": "http://my-online-tv.com"
      },
      "areaServed":[
        {
          "@type":"Country",
          "name": "US",
        },
        {
          "@type":"Country",
          "name": "CA",
        }
      ]
    }
    

    TelevisionChannel 사양 표

    속성 예상 유형 설명
    @context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
    로 설정
    • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
    @type 텍스트 필수 - 항상 TelevisionChannel로 설정합니다.
    @id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
    @id는 다음 요구사항을 충족해야 합니다.
    • 카탈로그 전반에서 고유함
    • 정적
    • 통합 리소스 식별자 (URI) 형식
    항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
    broadcastChannelId 텍스트 필수 - 이 BroadcastService를 케이블, 위성 또는 인터넷 TV 서비스로 식별할 수 있는 고유 식별자입니다.
    • 미국에서는 일반적으로 케이블 또는 위성 TV 번호입니다.
    • 인터넷 TV 서비스 (예: vMVPD)의 경우 채널 이름을 입력합니다.
    channelOrder 숫자 Google TV의 경우 필수, 그 외의 경우 선택사항 - 이 속성을 사용하여 Google TV 통합을 위한 전자 프로그램 가이드에 채널을 표시할 순서를 지정합니다.

    channelOrder는 피드의 채널에서 고유해야 하며, 가능하면 1부터 시작해야 합니다. channelOrder는 음수 또는 0 값을 가질 수 없습니다.
    broadcastServiceTier 텍스트 다음 값을 사용합니다.
    • 구독이 필요하지 않은 채널의 경우 Free입니다.
    • 기본 구독에 포함된 채널의 경우 Standard
    • 기본 구독 외에 추가 요금을 지불해야 하는 채널의 경우 Premium입니다.
    배열을 사용하여 여러 값을 제공합니다.
    inBroadcastLineup CableOrSatelliteService 필수 - 시청자에게 이 채널을 제공하는 CableOrSatelliteService@id입니다.
    providesBroadcastService BroadcastService 필수 - 이 채널에서 제공하는 프로그램을 제공하는 BroadcastService@id입니다.

    TelevisionChannel 예시

    케이블 또는 위성 TV 채널의 예:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/exampleTV/example-tv-7",
      "broadcastChannelId":"7",
      "channelOrder": 1,
      "broadcastServiceTier":["Premium", "Standard"],
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/exampleTV-san-francisco"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/example-tv"
      }
    }
    

    온라인 TV 채널의 예:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
      "broadcastChannelId":"sport-channel",
      "channelOrder": 3,
      "broadcastServiceTier":"Premium",
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/my-online-example-tv"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/sport-channel"
      }
    }
    

    조직 사양 표

    속성 예상 유형 설명
    @context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
    로 설정
    • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
    @type 텍스트 필수 - 항상 Organization로 설정합니다.
    @id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
    @id는 다음 요구사항을 충족해야 합니다.
    • 카탈로그 전반에서 고유함
    • 정적
    • 통합 리소스 식별자 (URI) 형식
    항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url@id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
    name 텍스트 필수 - TV 방송 네트워크, TV 콘텐츠 제공업체 또는 TV 운영자의 이름입니다.
    • 배열을 사용하여 여러 언어로 이름을 나열합니다. 여러 리전 및 언어 예시를 참고하세요.
    • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
    description 텍스트 조직에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다. 배열을 사용하여 여러 언어로 또는 다양한 길이로 설명을 제공합니다.
    sameAs URL 적극 권장됨 이유 TV 방송 네트워크를 식별할 수 있는 Wikipedia 페이지의 URL입니다. 이 속성은 url 속성과 구분되어야 합니다. 단일 채널/네트워크 항목에 대해 설명하는 위키백과 페이지로만 채웁니다. 위키피디아 페이지에서는 '채널'이라는 용어를 사용할 수 있습니다.
    potentialAction WatchAction 해당하는 경우 필요 - 조직을 참조하는 채널 (BroadcastService)이 여러 개인 경우 필요합니다. 작업의 세부정보를 제공하는 작업 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
    url URL 조직의 URL입니다. Google은 이 URL을 사용하여 이 조직을 Google 데이터베이스의 조직과 정확하게 조정합니다.
    identifier PropertyValue 적극 권장됨 이유 - 이 조직의 TMS ID와 같이 이 항목을 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
    popularityScore PopularityScoreSpecification 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
    popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
    popularityScore.value 숫자 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다.
    popularityScore.eligibleRegion 국가 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
    Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다.

    조직 예시

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"Organization",
      "@id":"http://example.com/networks/abcd-network",
      "name":"ABCD",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "TMS_ID",
          "value": "12345"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "_PARTNER_ID_",
          "value": "exampletv-12345"
        }
      ],
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://example.com/networkstream",
          "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": "2050-10-21T10:35:29Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://example.com/subscription",
            "name": "ABCD",
            "sameAs": "http://example.com/subscription",
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ]
        }
      },
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          }
        ]
      }
    }
    

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