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

本節將說明 MediaService 實體類型的內容標記屬性詳細資料，這些屬性可擷取媒體動作整合功能的設定

規格表

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

必要：一律設為 MediaService。
@context 文字

必要：一律設為 ["http://schema.org", {"@language": "xx"}]。
@id 網址

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

ID 必須符合下列規定：

  • 在你的目錄中，這項 ID 在全球皆為唯一。
  • 這項功能是靜態的，這個 ID 應固定，不會隨著時間而改變。
  • 統一資源識別碼 (URI) 格式。
  • 網域必須由貴機構所擁有。
name 文字

必填：供應商名稱。

如果您的品牌有任何特定語言代碼的名稱，請在陣列中列出這些名稱。如需這方面的範例，請參閱 MediaService 範例。
brandIcon ImageObject

所有 Watch 動作和 Listen 動作都必須提供：品牌圖示的圖片檔案，每個大小各一份。在「觀看/聆聽」動作結果中，Google 會將內容的深層連結與品牌圖示建立關聯。

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

  • 這是 PNG 檔案。
  • 背景為透明。
  • 其形狀自然是圓形。
  • 確保圖片經過反鋸齒處理，且不會扭曲/有像素化現象

您必須提供五張圖片，分別對應下列尺寸：

  • 16 x 16 像素，檔案大小不得超過 1 KB
  • 20 x 20 像素，檔案大小不得超過 1 KB
  • 40 x 40 像素，檔案大小不得超過 1 KB
  • 44 x 44 像素，檔案大小不得超過 1 KB
  • 112 x 112 像素，檔案大小不得超過 3 KB

Google TV 整合的其他規定：這些品牌圖示圖片會顯示在節目指南頂端、觀看動作按鈕和 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、投放或 Android TV 應用程式，則為必填 - 列出以下品牌應用程式：

  • iOS
  • Android
  • 投放
  • AndroidTV
application.@type 文字

必要：一律設為 SoftwareApplication。
application.operatingSystem 文字

必填：請設定為下列其中一項：

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl 網址

如適用，則為必要：如果是 Android、Android TV 和 iOS 平台，您必須將此連結指定為 App Store 和 Play 商店中的應用程式連結。

對於所有其他平台，這不是必要的屬性。
application.installUrl 網址

如適用，則為必要屬性：如果供應商透過 AndroidTV 應用程式提供媒體播放功能，您必須將此屬性指定為 AndroidTV APK 檔案的連結。

如果供應商不提供 AndroidTV 播放功能，則不必提供這項屬性。
application.identifier

Text

如適用，則為必要值：如果平台對應下列任一值，請據此進行設定。否則，不必使用這項屬性：

  • 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"
      }
    }
  ]
}