本頁面由 Cloud Translation API 翻譯而成。

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

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

重點：MediaService 實體應包含在 dataFeedElement 陣列中。請參閱下方的示例。

重點：每個 Media Actions 動態饋給提交內容，必須針對動態饋給涵蓋的每個深層連結供應商，包含且僅包含一個 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"
      }
    }
  ]
}

MediaService 的內容標記屬性 (必要) 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

規格表

MediaService 範例

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