MediaService 的內容標記屬性 (必要)

本節提供 用於擷取媒體動作設定的 MediaService 實體類型 整合

規格表

屬性 預期類型 說明
@type 文字

必要 - 一律設為 MediaService

@context 文字

必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]

@id 網址

必填 - 品牌的專屬 ID。例如 https://example.com

ID 必須遵守下列規定:

  • 這個名稱在所有目錄中是獨一無二的。
  • 完全是靜態的。這個 ID 必須固定,且不會隨時間改變。
  • 格式為統一資源識別碼 (URI) 格式。
  • 網域擁有者必須為貴機構。
name 文字

必要 - 提供者的名稱。

如果品牌有適用於特定地區的名稱,請在陣列中列出。舉例來說 請參閱 MediaService 範例

brandIcon ImageObject

所有觀看動作和收聽動作的必填屬性 - 品牌的圖片檔 分別代表不同大小的圖示在「觀看/聆聽動作」結果中,Google 會將你的 透過內容加入品牌圖示的深層連結。

品牌圖示圖片檔必須符合下列規定:

  • 這是 PNG 檔案
  • 背景是透明的。
  • 它的形狀是圓的。
  • 請確認圖片經過消除鋸齒,不會變形/像素化

這個屬性必須重複,因為您必須提供五張圖片,每張各一張 維度如下:

  • 16x16 像素,檔案小於 1 KB
  • 20x20 像素,檔案小於 1 KB
  • 40x40 像素,檔案大小不超過 1 KB
  • 44x44 像素,檔案小於 1 KB
  • 112 x 112 像素,檔案大小不超過 3 KB

與 Google TV 整合的其他規定 - 這些品牌的圖片 圖示會顯示在節目規劃指南頂端、觀看動作按鈕 。提供三個符合下列規定的圖示:

  • 一個 PNG 檔案格式的正方形圖示。(解析度為 512x512 像素,顯示比例應為 1:1)
  • 一個 PNG 檔案格式的白色文字商標圖示。(提供最高解析度,未偏好顯示比例)
  • PNG 檔案格式的一個彩色文字商標圖示。(提供最高解析度,未偏好顯示比例)

請確認圖片使用消除鋸齒,不會變形/像素化。

brandIcon.contentURL 網址

必要 - 圖片的網址。

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 網址

如適用:如果是 Android、AndroidTV 和 iOS 平台,您必須 將其指定為應用程式在 App Store 和 Play 商店中的連結。

至於所有其他平台,這並不是必要資源。

application.installUrl 網址

如果適用,則為必要 - 如果供應商透過 AndroidTV 應用程式,須將此指定為 AndroidTV APK 檔案的連結。

如果供應商未提供 AndroidTV 播放功能,就不是必要屬性。

application.identifier

文字

必要 (如適用) - 適用於對應下列其中一個項目的平台 並據此設定不需要這項屬性:

  • iOS:App Store 應用程式 ID。例如 967093455
  • Android:Play 商店 Android 套件名稱。例如: com.abc.media.android
  • Cast:Cast 應用程式 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 內容包括 電影電視節目
  • ["LiveTV"] - 供應商僅包括電視直播節目,包括 管道BroadcastEvent 你的內容。
  • ["VoD", "LiveTV"] - 供應商在以下國家/地區同時包含 VoD 和電視直播內容: 資訊提供。
  • ["Music"] - 供應平台只包含動態饋給中的音樂實體。這個 包含 專輯、藝人、歌曲播放清單 內容。
  • ["Radio"] - 供應者只包含動態饋給中的 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"
      }
    }
  ]
}