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 이하

Google TV 통합을 위한 추가 요구사항 - 브랜드 아이콘의 이미지는 프로그램 가이드 상단, 보기 작업 버튼, Google TV 설정에 표시됩니다. 다음 요구사항을 충족하는 아이콘 3개를 제공합니다.

  • PNG 파일 형식의 정사각형 아이콘 1개 (해상도 512x512픽셀, 가로세로 비율 1:1)
  • PNG 파일 형식의 흰색 워드마크 아이콘 1개 (사용 가능한 가장 높은 해상도, 가로세로 비율에 대한 환경설정 없음)
  • PNG 파일 형식의 컬러 워드마크 아이콘 1개 (사용 가능한 가장 높은 해상도, 가로세로 비율에 대한 환경설정 없음)

이미지가 안티앨리어싱 처리되어 있고 왜곡되거나 모자이크 현상이 없어야 합니다.

brandIcon.contentURL URL

필수 - 이미지의 URL입니다.
brandIcon.height 숫자

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

필수 - 이미지 너비(픽셀)입니다.
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입니다.
  • 전송: 전송 앱 ID입니다. 예를 들면 다음과 같습니다. ACDA4FDE
  • AndroidTV: Play 스토어 AndroidTV 패키지 이름입니다. 예를 들면 com.abc.media.atv.android입니다.
parentOrganization 조직

필수 - 서비스의 상위 제공업체입니다.
parentOrganization.@type 텍스트

필수 - 항상 Organization로 설정합니다.
parentOrganization.name 텍스트

필수 - 조직 이름입니다.
subscriptions MediaSubscription

선택사항 - 시계 제공업체에서 지원하는 사용 가능한 MediaSubscriptions 목록입니다.
baseSubscriptionTier MediaSubscription

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

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

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

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

필수 - 피드에 포함된 카탈로그의 콘텐츠 유형에 해당하는 다음 중 하나로 설정합니다.

  • ["VoD"] - 제공업체가 피드에 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"
      }
    }
  ]
}