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

本節提供 MediaService 實體類型的內容標記屬性詳細資料,用於擷取媒體動作整合設定

規格表

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

必要 - 一律設為 MediaService

@context 文字

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

@id 網址

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

ID 必須符合下列規定:

  • 整個目錄中的不重複資料。
  • 靜態。這個 ID 應固定,不會隨著時間而改變。
  • 採用統一資源識別碼 (URI) 格式。
  • 該網域的網域必須由貴機構擁有。
name 文字

必要 - 供應商名稱。

如果您的品牌有任何語言代碼專屬的名稱,請在陣列中列出這些名稱。如需範例,請參閱 MediaService 範例

brandIcon ImageObject

所有「觀看動作」和「聆聽動作」的必要步驟 - 每種尺寸重複套用品牌圖示的圖片檔案。在「觀看/收聽動作」結果中,Google 會將您內容的深層連結與品牌圖示建立關聯。

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

  • 此為 PNG 檔案。
  • 背景是透明的。
  • 形狀的形狀是大自然。
  • 請確認圖片為反鋸齒且不會扭曲/像素化

這個屬性必須重複,因為您必須提供五個圖片,以下各種尺寸各有 1 張:

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

Google TV 整合的其他規定 - 這些品牌圖示會顯示在「節目指南」的「節目規劃指南」、「動作動作」按鈕,以及 Google TV 設定中。提供三個圖示,且須符合下列規定:

  • 1 個 PNG 檔案格式的正方形圖示。(解析度為 512x512 px,顯示比例 1: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、投放或 AndroidTV 應用程式,此為必填資訊 - 包含下列應用程式的品牌應用程式清單:

  • iOS
  • Android
  • Google Cast
  • AndroidTV
application.@type 文字

必要 - 一律設為 SoftwareApplication

application.operatingSystem 文字

必要 - 設為下列其中一個值:

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

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

其他平台並非必要屬性。

application.installUrl 網址

必要 (如果提供) - 如果供應器透過 AndroidTV 應用程式提供媒體播放,您必須將此指定為 AndroidTV APK 檔案的連結。

如果供應商未提供 Android TV 播放功能,這不是必要屬性。

application.identifier

Text

必要 (如適用) - 適用於與下列任一值對應的平台。這是選用屬性:

  • iOS:App Store 應用程式 ID例如 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 Media 訂閱

選用 - 手錶供應商支援的可用 MediaSubscriptions 清單。

baseSubscriptionTier Media 訂閱

必要 (如果適用):如果手錶供應商和供應商有基本訂閱套件,您必須將此項目設為訂閱執行個體,供所有訂閱者觀看。如果不是,則為必要屬性。

userRequestsFulfilledBy 文字

選填 - 設為下列其中一個會完成使用者要求的使用者:

  • Google Google 會處理所有要求。基本上,Google 會傳回要求內容的深層連結。
  • Provider所有的要求都是由內容供應器完成,也就是「雲端供應商」。基本上,供應器會回傳要求內容的深層連結,或直接在裝置上啟動播放作業。

根據預設,此屬性會設為 Google

mediaOffered 文字

必要 - 設為下列其中一個,對應您動態饋給中的目錄內容類型:

  • ["VoD"] - 供應商在動態饋給中只包含隨選影片 (VoD) 內容。VoD 內容包含電影電視節目
  • ["LiveTV"] - 供應商在動態饋給中只包含直播電視節目,其中包括 ChannelsBroadcastEvent 內容。
  • ["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"
      }
    }
  ]
}