MediaService의 콘텐츠 마크업 속성 (필수)

이 섹션에서는 미디어 작업 통합의 구성을 캡처하는 MediaService 항목 유형의 콘텐츠 마크업 속성에 대해 자세히 설명합니다.

사양 표

속성 예상 유형 설명
@type 텍스트

필수: 항상 MediaService로 설정됩니다.

@context 텍스트

필수: 항상 ["http://schema.org", {"@language": "xx"}]로 설정됩니다.

@id URL

필수: 브랜드의 고유 식별자입니다(예: https://example.com).

식별자는 다음 요구사항을 준수해야 합니다.

  • 카탈로그에서 전역적으로 고유합니다.
  • 정적입니다. ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다.
  • 통합 리소스 식별자 (URI) 형식입니다.
  • 도메인 소유권이 있어야 합니다.
name 텍스트

필수: 제공업체 이름입니다.

언어에 언어별 이름이 있는 경우 배열에 나열하세요. 이에 관한 예는 MediaService 예를 참고하세요.

brandIcon ImageObject

모든 시청 작업 및 수신 대기 작업에 필수 - 브랜드 아이콘의 이미지 파일로, 크기별로 반복됩니다. 시청/듣기 작업 결과에서 Google은 콘텐츠의 딥 링크를 브랜드 아이콘에 연결합니다.

브랜드 아이콘 이미지 파일은 다음 요구사항을 준수해야 합니다.

  • PNG 파일입니다.
  • 배경은 투명합니다.
  • 모양은 원형입니다.
  • 이미지가 앤티앨리어싱 처리되고 왜곡되거나 모자이크되지 않았는지 확인하세요.

다음 측정기준마다 하나씩 5개의 이미지를 제공해야 하므로 이 속성을 반복해야 합니다.

  • 16x16픽셀(파일 크기가 1KB 이하)
  • 20x20픽셀, 파일 크기가 1KB 이하
  • 40x40픽셀, 파일 크기가 1KB 이하
  • 44x44픽셀(파일 크기가 1KB 이하)
  • 112x112픽셀(파일 크기가 3KB 이하)

GoogleTV 통합 추가 요구사항 - 브랜드 아이콘 이미지는 편성 가이드 상단, 시청 작업 버튼, Google TV 설정에 표시됩니다. 다음 요구사항을 충족하는 아이콘 3개를 제공하세요.

  • PNG 파일 형식의 정사각형 아이콘 1개 (해상도 512x512px, 가로세로 비율 1:1)
  • PNG 파일 형식의 흰색 워드마크 아이콘 1개. (사용 가능한 가장 높은 해상도, 가로세로 비율 선호도 없음)
  • PNG 파일 형식의 컬러 워드마크 1개 (사용 가능한 가장 높은 해상도, 가로세로 비율 선호도 없음)

이미지가 앤티앨리어싱 처리되고 왜곡되거나 모자이크되지 않았는지 확인하세요.

brandIcon.contentURL URL

필수 - 이미지의 URL입니다.

brandIcon.height Number

필수 - 이미지의 높이입니다(픽셀).

brandIcon.width Number

필수: 이미지의 너비(픽셀)입니다.

brandIcon.additionalProperty PropertyValue

필수 - 이미지 유형을 설명하고 의도한 용도를 정의하는 데 사용되는 추가 속성입니다.

brandIcon.additionalProperty.@type 텍스트

필수: PropertyValue로 설정합니다.

brandIcon.additionalProperty.name 텍스트

필수: contentAttributes로 설정합니다.

brandIcon.additionalProperty.value 텍스트

필수: 백그라운드 적합성입니다.

유효하려면 다음 값 중 하나 이상으로 설정합니다.

  • forDarkBackground: 어두운 배경에 사용하기에 적합한 이미지(일반적으로 투명한 아이콘)입니다.
  • forLightBackground: 밝은 배경에서 사용하기에 적합한 이미지(일반적으로 투명한 아이콘)입니다.
application SotfwareApplication

iOS, Android, Cast 또는 AndroidTV 애플리케이션이 제공되는 경우 필수 - 다음과 같은 브랜드의 애플리케이션 목록입니다.

  • iOS
  • Android
  • 출연진
  • AndroidTV
application.@type 텍스트

필수: 항상 SoftwareApplication로 설정됩니다.

application.operatingSystem 텍스트

필수: 다음 중 하나로 설정합니다.

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

해당하는 경우 필수 - Android, AndroidTV, iOS 플랫폼의 경우 App Store 및 Play 스토어의 애플리케이션 링크로 지정해야 합니다.

다른 모든 플랫폼에서는 필수 속성이 아닙니다.

application.installUrl URL

필요한 경우 필수 - 제공업체가 AndroidTV 앱을 통해 미디어 재생을 제공하는 경우 AndroidTV APK 파일 링크로 지정해야 합니다.

제공업체가 AndroidTV 재생을 제공하지 않는 경우 필수 속성이 아닙니다.

application.identifier

텍스트

필요한 경우 필수 - 다음 값 중 하나에 해당하는 플랫폼의 경우 적절하게 설정합니다. 그렇지 않으면 이 속성이 필요하지 않습니다.

  • iOS: App Store 앱 식별자입니다. 예를 들면 다음과 같습니다. 967093455
  • Android: Play 스토어 Android 패키지 이름입니다. 예를 들면 com.abc.media.android입니다.
  • Cast: Cast 앱 ID입니다. 예를 들면 다음과 같습니다. ACDA4FDE
  • AndroidTV: Play 스토어 AndroidTV 패키지 이름입니다. 예를 들면 com.abc.media.atv.android입니다.
parentOrganization Organization

필수: 서비스의 상위 제공업체입니다.

parentOrganization.@type 텍스트

필수: 항상 Organization로 설정됩니다.

parentOrganization.name 텍스트

필수: 조직 이름입니다.

subscriptions MediaSubscription

선택사항 - 시계 제공자가 지원하는 사용 가능한 MediaSubscriptions 목록입니다.

baseSubscriptionTier MediaSubscription

필요한 경우 필수 - 시계 제공업체 및 제공업체에 기본 구독 패키지가 있는 경우 모든 구독자에게 제공되는 콘텐츠의 경우 이를 구독 인스턴스로 설정해야 합니다. 그렇지 않으면 이 속성이 필요하지 않습니다.

userRequestsFulfilledBy 텍스트

선택사항 - 사용자 요청을 처리하는 다음 당사자 중 하나로 설정합니다.

  • Google: Google에서 모든 요청을 처리합니다. 기본적으로 Google은 요청된 콘텐츠의 딥 링크를 반환합니다.
  • Provider: 모든 요청은 콘텐츠 제공업체, 즉 클라우드 제공업체에서 처리합니다. 기본적으로 제공자는 요청된 콘텐츠의 딥 링크를 반환하거나 기기에서 직접 재생을 시작합니다.

기본적으로 이 속성은 Google로 설정됩니다.

mediaOffered 텍스트

필수 - 다음 중 하나로 설정합니다. 이는 카탈로그에 있는 카탈로그의 콘텐츠 유형에 해당합니다.

  • ["VoD"] - 제공업체가 피드에 VOD (콘텐츠)를 포함합니다. VoD 콘텐츠에는 영화TV 프로그램이 포함됩니다.
  • ["LiveTV"] - 제공업체가 피드에 채널BroadcastEvent 콘텐츠를 포함하는 실시간 TV만 포함합니다.
  • ["VoD", "LiveTV"] - 제공업체가 피드에 VoD 및 실시간 TV 콘텐츠를 모두 포함합니다.
  • ["Music"] - 제공업체가 피드에 음악 항목만 포함합니다. 여기에는 앨범, 아티스트, 노래재생목록 콘텐츠가 포함됩니다.
  • ["Radio"] - 제공업체가 피드에 라디오 항목만 포함합니다.
  • ["Music", "Radio"] - 제공업체가 피드에 음악 및 라디오 항목을 포함합니다. 여기에는 앨범, 아티스트, 노래, 재생목록, 라디오 채널이 포함됩니다.

MediaService 예시

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}