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

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

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이 포함되어야 합니다.
재생의 딥 링크target 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 네트워크의 이름입니다.
  • 배열을 사용하여 다양한 언어로 된 이름을 나열합니다. 여러 지역 및 언어 예를 참고하세요.
  • 언어당 하나의 이름만 지원됩니다 (언어-국가 쌍).
broadcastDisplayName 텍스트 필수: 사용자가 프로그램 가이드 등에서 일반적으로 볼 수 있는 네트워크의 표시 이름입니다. 이 값은 이름 값과 동일할 수 있습니다.
callSign 텍스트 방송 서비스의 공식 정부 발급 호출 부호입니다.
inLanguage 텍스트 또는 언어 강력 추천 이유 채널의 기본 방송 언어입니다. IETF BCP 47 표준에 명시된 언어 코드 중 하나를 사용하세요.
category 텍스트 강력 추천 이유 항목의 카테고리입니다. 큰 부호나 슬래시는 카테고리 계층 구조를 비공식적으로 나타내기 위해 사용할 수 있습니다. 예: 스포츠, 스포츠 > 축구, 뉴스, 영화, 음악, 다큐멘터리.`
contentRating Text 또는 Rating 성인 전용 TV 방송 서비스의 필수 속성입니다. 채널에서 방송되는 콘텐츠에 적용되는 가장 엄격한 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 등급 앞에 공백을 추가해야 합니다. 예: 'TV-Y' 대행사 'TVPG' 등급 'TVPG TV-Y'라고 설명되어 있습니다. 대행사 목록을 참고하세요.
contentRating.author Organization contentRating님이 Rating을(를) 사용하는 경우 필수: 등급 부여 기관의 이름입니다.
contentRating.ratingValue 텍스트 contentRating에서 Rating을 사용하는 경우 필수: 평점의 값입니다.
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:1, 4:3 또는 16:9 (선호하는 순서)를 따라야 하며 해상도가 80x80px 이상이어야 합니다.
    • additionalProperty 속성의 일부로 맞춤 속성 이름 contentAttributesforDarkBackground 값을 사용하여 로고를 사용해야 하는 배경 유형을 나타냅니다.
    • 가로세로 비율을 유지하기 위해 패딩을 추가한 경우 길이나 너비 중 한쪽의 패딩이 허용됩니다.
    • 기타 요구사항 및 사양은 이미지 섹션을 참고하세요.
    아래 예시를 참고하세요.
    potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 Action 마크업 객체입니다. 자세한 내용은 작업 마크업 속성을 참고하세요.
    videoFormat 텍스트 본 방송 서비스에서 지원하는 최고 품질의 화질이어야 합니다. 예:
    • 'SD' 를 참조하세요.
    • 'HD' 고화질로도 볼 수 있죠.
    • '2,000' 2K 해상도
    • '4K' 4K 해상도로 시청할 수 있습니다.
    • '8,000' 8K 해상도의 경우
    broadcastTimezone 텍스트 방송 서비스의 시간대입니다(IANA 형식). 예: America/Los_Angeles 여러 시간대에 배열을 사용합니다.
    broadcastAffiliateOf Organization 필수 - 이 방송 서비스 또는 이 방송 서비스가 속한 조직에 프로그램을 제공하는 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"
                        ]
                    }
                ]
            }
        ]
    }
    

    CableOrMonthlyService 사양 표

    속성 예상 유형 설명
    @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 Organization 필수: 서비스의 상위 제공업체입니다(해당하는 경우). 예를 들어 ExampleTV는 지역 서비스인 ExampleTV San FranciscoExampleTV San Diego를 제공합니다.
    provider.@id 텍스트 필수 - TV 운영자의 ID입니다.
    provider.@type 텍스트 필수: 항상 Organization로 설정합니다.
    identifier PropertyValue 강력 추천 이유 - 이 항목을 식별하는 외부 또는 기타 ID입니다(예: 이 방송 서비스의 Gracenote TMS ID). 여러 식별자를 사용할 수 있습니다. 자세한 내용은 식별자 속성 섹션을 참조하세요.

    CableOr 전용 서비스 예

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

    {
      "@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 숫자 GoogleTV의 경우 필수, 그렇지 않은 경우에는 선택사항 - 이 속성을 사용하여 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)이 있는 경우 필수입니다. 작업의 세부정보를 제공하는 Action 마크업 객체 자세한 내용은 작업 마크업 속성을 참고하세요.
    url URL 조직의 URL입니다. Google은 이 URL을 사용하여 이 조직을 Google 데이터베이스에 있는 조직과 정확하게 조정합니다.
    identifier PropertyValue 강력 추천 이유 - 이 법인을 식별하는 외부 또는 기타 ID(예: 조직의 TMS 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"
          }
        ]
      }
    }
    

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