觀看動作常見屬性

本節詳細說明「觀看動作」的常見屬性。

動作標記屬性

屬性 預期類型 說明
@type 文字 必要 - 一律設為 WatchAction。
target EntryPoint 必要 - 指定的目標物件 提供的對應項目 深度 連結至多個 Google 平台。
target.@type 文字 必要 - 一律設為 EntryPoint。
target.urlTemplate 網址 必要 - A 深度 這個連結會將使用者帶往應用程式或平台，並開始進行 播放內容。
target.inLanguage 文字 選填 - 系列叢書的原始語言 BCP 47 格式。
target.actionPlatform 文字 必要 - 對應的平台 urlTemplate。媒體動作支援下列項目：
  • http://schema.org/DesktopWebPlatform：搜尋平台 電腦版網路瀏覽器上
  • http://schema.org/MobileWebPlatform：搜尋平台 行動網路瀏覽器。
  • http://schema.org/AndroidPlatform：Google 搜尋與 Play 指南 這個平台。
  • http://schema.org/AndroidTVPlatform：Android TV 平台上的應用程式
  • http://schema.org/IOSPlatform：iOS 上的搜尋平台 應用程式。
  • http://schema.googleapis.com/GoogleVideoCast：投放和 Chromecast 裝置上的主畫面平台。
  • http://schema.googleapis.com/GoogleAudioCast：投放和 Chromecast 裝置的主畫面平台 (僅限「聆聽動作」)。
詳情請參閱 平台 類型一節，瞭解相關規定。
target.additionalProperty PropertyValue 必要 (如適用) - 屬性/值組合的清單 代表深層連結的其他屬性這可能包括 包括：
  • contentLanguage：廣播語言 (配音)，使用的語言 BCP 47 格式。如果內容為其他語言配音， 必須提供屬性。使用陣列包含多個語言代碼。
  • subtitleLanguage：字幕的語言或語言 字幕 BCP 47 格式。使用陣列包含多個語言代碼。
  • cameraAngle：內容的相機角度；的 例如「Eye-Level」和「High-Angle」如果該內容位於 不同的鏡頭角度，這個屬性就必須有屬性。使用陣列 支援多個鏡頭角度。
  • videoFormat：用來儲存數位資料的檔案格式 影片日期；例如「SD 標準畫質」標準畫質和 HD 高畫質的 有效影片格式包括 SD 標準畫質、HD 高畫質、2K、4K 和 8K。 使用陣列支援多種影片格式。
詳情請參閱 additionalProperty 範例。
actionAccessibilityRequirement ActionAccessSpecification 必要 - 動作 存取規格物件，用於說明可以存取 而這些內容請參閱動作 存取規格屬性。

請參閱下列網頁，瞭解與這些房源相關的主題：

動作存取權規格屬性

屬性 預期類型 說明
actionAccessibilityRequirement.@type 文字 必要 - 一律設為 ActionAccessSpecification。
actionAccessibilityRequirement.category 文字

必要 - 內容的存取要求。如要 資訊，請參閱 付費牆類型：

如果實體代表一組內容，則您必須設定 category已採用以下限制最低的存取權需求： 內容舉例來說，如果 TVSeries 含有 已將「TVEpisode」內容設為nologinrequired 一些設為 subscription 的函式，將這個屬性設為 訊息張貼時間：TVSeries，分享對象：nologinrequired。
actionAccessibilityRequirement.availabilityStarts 日期

必要 - 可執行動作的日期， ISO 8601 格式 (含時區)。

  • 日期可設為未來的日期。

必須在以下位置的動態饋給中提供對應實體： 在 availabilityStarts 推出日期之前至少 7 天。這樣能強化 Google 平台顯示內容的機率

actionAccessibilityRequirement.availabilityEnds 日期 必要 - 無法再使用該動作的日期。 ISO 8601 格式 (含時區)。
  • 必須等於或大於 72 小時 availabilityStarts。
  • 發布發布內容後，如果內容一律可供存取，請進行設定 日期必須設為目前日期的 20 年後。

如要更新 availabilityEnds 日期，則必須更新該日期。 至少在 availabilityEnds 日期的 7 天前出現在動態饋給中。這個 這會增加內容停止在 Google 顯示的機會 並顯示 availabilityEnds 日期。

actionAccessibilityRequirement.eligibleRegion 國家/地區 城市， State (州/省) GeoShape，或 文字 必填 - 提供內容的區域。使用 如果內容可在全球提供，則為特殊字串 EARTH。
actionAccessibilityRequirement.ineligibleRegion 國家/地區 城市， 州/省，或 GeoShape 必填 (如適用) - 內容所在的區域 受到限制。如果內容是 「eligibleRegion」中的所有地區皆可使用。
actionAccessibilityRequirement.requiresSubscription MediaSubscription

必要 (如適用) - 詳細的 使用者才能存取內容所需的訂閱項目。詳情請見 媒體訂閱屬性：

  • 如果 category 為 subscription 或 externalSubscription。
actionAccessibilityRequirement.expectsAcceptanceOf 優惠 如果內容需要購買商品，則為必要屬性： 提供與內容相關的優惠提供產品的價格資訊 下列情況：
  • 一次性消費內容 (rental 或 purchase)
  • 需要額外購買商品的訂閱型內容 訂閱人數 (subscription 或 externalsubscription)
如果價格為 0.00，請完全移除 Offer 物件，並將 ActionAccessSpecification 物件的 category 設為 free。詳情請見 優惠屬性。

媒體訂閱屬性

如果 actionAccessibilityRequirement.category 為必要項目，則為必要欄位 subscription 或 externalSubscription。

屬性 預期類型 說明
requiresSubscription.@type 文字 必要 - 一律設為 MediaSubscription
requiresSubscription.@id 網址 必填：訂閱項目的專屬 ID。如果內容 可透過不同的訂閱項目存取，每項訂閱項目都必須具備 不重複的 ID
requiresSubscription.name 文字 必填 - 訂閱項目名稱。請留意以下事項：
  • 如果內容可透過不同訂閱方案存取， 名稱必須與使用者驗證系統中的名稱相符。適用對象 例如使用者能否根據訂閱項目 稱為 Package 1，但驗證系統會使用名稱 PKG1a，請使用 PKG1。
  • 如果是 TVE 供應商，這是指註冊的驗證器名稱 您的 TVE 驗證器。這是專門用來識別 服務名稱。
requiresSubscription.sameAs 網址 說明訂閱項目的頁面。
requiresSubscription.identifier 文字 如果 category 為 subscription 且為必要，則為必要 commonTier為「false」 - 這項訂閱項目的專屬字串，代表存取媒體目錄中某組內容的權限。
  • Google 建議您對 ID 採用下列語法：
    網域名稱 + 冒號 (:) + 內容存取層級，範例：example.com:basic example.com:premium, example.com:體育
  • 這項資源將與你的 授權 ID 如果您要提供授權 API
requiresSubscription.authenticator 機構組織 如果 category 為 externalsubscription - 提供 外部供應商驗證器的詳細資料
requiresSubscription.authenticator.@type 文字 如果 category 為 externalsubscription - 一律設為 Organization。
requiresSubscription.authenticator.name 文字 如果 category 為 externalsubscription - 驗證的名稱 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務如果是 TVE 供應商，請設為「TVE」。
requiresSubscription.commonTier 布林值 必要 (如適用) - 如果類別設為 訂閱項目中的所有進階功能！如要進一步瞭解 CommonTier，請參閱 一般 級別需求條件說明文件。

授權 API 需求條件

授權 API 是 如果 actionAccessibilityRequirement.category 為 subscription 或 externalSubscription，您的訂閱方案包含多項 套件或級別，或提供附加支援。如果您 訂閱方案屬於單一級別，可讓使用者存取目錄中的所有內容。

  • A 公司針對訂閱的使用者提供單一訂閱方案 可存取所有可用內容：授權 ID / API「不得」 必選
  • B 公司擁有基本訂閱方案，可供存取部分內容， 提供付費內容的付費訂閱方案： 必須提供授權 ID / API
  • C 公司擁有基本訂閱方案，可供存取部分內容， 添加可提供第三方內容存取權的套件： 必須提供授權 ID / API

請參閱下列網頁，瞭解與這些房源相關的主題：

優惠屬性

屬性 預期類型 說明
expectsAcceptanceOf.@type 文字 必要 - 一律設為 Offer。
expectsAcceptanceOf.price Number 必填 - 內容的購買價格。價格必須為非零的正值。如果是價格為 0.00 的實體，請將類別指定為「免費」。
expectsAcceptanceOf.priceCurrency 文字 必填 - 價格的幣別，以 3 個字母表示 ISO 4217 格式。
expectsAcceptanceOf.seller 機構組織 提供內容購買服務的機構。
expectsAcceptanceOf.seller.@type 文字 一律設為 Organization。
expectsAcceptanceOf.seller.name 文字 賣家的名稱。
expectsAcceptanceOf.seller.sameAs 文字 識別賣方的網頁網址；舉例來說 賣方首頁

優惠相關頁面

請參閱下列網頁，瞭解這些房源的相關主題：

ID

媒體動作動態饋給接受多種 ID，有助於識別 以混淆的方式解釋實體這些 ID 有助於加快 這個程序會將您的動態饋給內容與 Google 或 Microsoft SQL Server 資料庫雖然您可以使用 不同實體類型的 identifier 資源，EIDR 有專屬的 EIDR 代表資源這兩種工具都會在下文中說明。

ID 屬性

屬性 預期類型 說明
identifier 文字 強烈建議 - 識別特定實體的 ID，通常是外部 ID。你可以使用多個 ID。

這項資源適用於所有「觀看動作」實體類型。

下表列出 identifier 資源接受的 ID 和子屬性。請參閱「觀看動作」動態饋給範例一節中的 Identifier/EIDR 範例。
屬性 預期類型 說明
@type 文字 必要 - 一律設為 PropertyValue。
propertyID 文字 必要 - 我們支援下列 ID 類型：
  • TMS_ROOT_ID：Gracenote (TMS) 根 ID (例如 15829)。
    • ，直接在 Google Cloud 控制台實際操作。不適用於機構， 僅應使用 TMS_ID 的 BroadcastService 實體。
  • TMS_ID：Gracenote (TMS) 變化版本 ID (例如 MV000398520000)。
  • WIKIDATA_ID：WikiData ID (例如 Q134773)。
  • IMDB_ID：IMDB ID (例如 tt0109830)。
  • OPTA_ID：OPTA Sports ID。
  • STATS_ID：STATS 執行 ID。
  • VIP_TIMES_ID：日本人才用的日本 VIPTimes (Nihon Tarento Meikan) ID。
  • DMA_ID：美國指定行銷區碼，用於 GeoShape 物件。
  • _PARTNER_ID_：這個屬性必須包含字串 「_PARTNER_ID_」，該值必須是 辨識實體 (例如 12345 或 a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value 文字 必要 - 指定 ID 系統的值。

EIDR 屬性

EIDR (國際影視產業識別碼機構專用) 是全球獨有的識別碼系統，適用於各種媒體內容，包括電影和電視節目。識別系統會將 ID 解析為與頂層標題、編輯內容等項目相關聯的中繼資料記錄。下表列出與 EIDR 及其用途相關的部分屬性。

屬性 預期類型 說明
titleEIDR 文字 強烈建議：EIDR (國際影視產業識別碼機構) ID 代表電影或電視節目作品，以通用/抽象層級呈現。

這項資源適用於 TVSeries、TVSeason、TVEpisode 和 Movie 實體規格頁面。

例如，名為「Ghostbusters」電影的 titleEIDR。為「10.5240/7EC7-228A-510A-053E-CBB8-J」。

請參閱「觀看動作」動態消息範例部分的 Identifier/EIDR 範例。
editEIDR 文字 強烈建議：EIDR (國際影視產業識別碼機構) ID 代表電影或電視節目的特定剪輯/版本。

這項資源可在 TVEpisode 和 Movie 實體規格頁面中查看。

例如，名為「Ghostbusters」的動態相片其 titleEIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」具有幾次編輯，例如"10.5240/1F2A-E1C5-680A-14C6-E76B-I"和「10.5240/8A35-3BEE-6497-5D12-9E4F-3」。

在提供 editEIDR 的情況下，您必須提供 titleEIDR 屬性。

請參閱「觀看動作」動態消息範例部分的 Identifier/EIDR 範例。

內容分級機構

請使用這個資料表中的值 BroadcastService.contentRating、Movie.contentRating 和 TVSeries.contentRating。分級機構應在評分值前面加上。範例：

  • 一部評為「R」的電影在美國，Movie.contentRating 值應為「MPAA R」。
  • 分級為「TV-MA」的電視影集在美國，TVSeries.contentRating 值應設為「TVPG TV-MA」。

國家/地區 電視分級機構 電影分級機構
阿爾巴尼亞 (AL) 不適用 不適用
安哥拉 (AO) 不適用 CCE
安地卡及巴布達 (AG) 不適用 MPAA
阿根廷 (AR) INCAA INCAA
亞美尼亞 (AM) 不適用 MKRF/RUSSIA
阿魯巴 (AW) 不適用 不適用
澳洲 (AU) ACB 電視 ACB 電影
奧地利 (AT) FSK FSK
亞塞拜然 (AZ) 不適用 MKRF/RUSSIA
巴林 (BH) 不適用 MPAA
白俄羅斯 (BY) 不適用 MKRF/RUSSIA
比利時 (BE) 不適用 MPAA
貝里斯 (BZ) 不適用 不適用
貝南 (BJ) 不適用 CNC
玻利維亞 (BO) 不適用 MPAA
波士尼亞與赫塞哥維納 (BA) 不適用 MPAA
波札那 (BW) 不適用 MPAA
巴西 (BR) 分類 分類
布吉納法索 (BF) 不適用 CNC
柬埔寨 (KH) 不適用 不適用
加拿大 (CA) CA_TV CHVRS
維德角 (CV) 不適用 CCE
智利 (CL) 不適用 MPAA
哥倫比亞 (CO) 不適用 MPAA
哥斯大黎加 (CR) 不適用 MPAA
克羅埃西亞 (HR) 不適用 不適用
賽普勒斯 (CY) 不適用 GRFILM
捷克 (CZ) 不適用 CZFILM
丹麥 (DK) 不適用 MCCYP
厄瓜多 (EC) 不適用 MPAA
埃及 (EG) 不適用 MPAA
薩爾瓦多 (SV) 不適用 MPAA
愛沙尼亞 (EE) 不適用 EEFILM
斐濟 (FJ) 不適用 不適用
芬蘭 (FI) 不適用 MEKU
法國 (FR) CSA CSA
加彭 (GA) 不適用 CNC
德國 (DE) FSK FSK
希臘 (GR) ESR GRFILM
瓜地馬拉 (GT) 不適用 MPAA
海地 (HT) 不適用 不適用
宏都拉斯 (HN) 不適用 MPAA
香港 (HK) CA FCO
匈牙利 (HU) 不適用 MPAA
冰島 (IS) 不適用 KIJKWIJZER
印度 (IN) CBFC CBFC
印尼 (ID) 主要成效指標 LSF
愛爾蘭 (IE) 不適用 IFCO
義大利 (IT) AGCOM AGCOM
象牙海岸 (CI) 不適用 CNC
牙買加 (JM) 不適用 MPAA
日本 (JP) 不適用 EIRIN
約旦 (JO) 不適用 MPAA
哈薩克 (KZ) 不適用 MRKF
韓國 (KR) KMRB KMRB
科威特 (KW) 不適用 MPAA
吉爾吉斯 (KG) 不適用 MKRF/RUSSIA
寮國 (LA) 不適用 不適用
拉脫維亞 (LV) 不適用 NKCLV
黎巴嫩 (LB) 不適用 MPAA
立陶宛 (LT) 不適用 不適用
盧森堡 (LU) 不適用 KIJKWIJZER
馬其頓 (MK) 不適用 MPAA
馬來西亞 (MY) 不適用 FCBM
馬利 (ML) 不適用 CNC
馬爾他 (MT) 不適用 MCCAA
模里西斯 (MU) 不適用 BBFC
墨西哥 (MX) RTC RTC
摩爾多瓦 (MD) 不適用 不適用
納米比亞 (NA) 不適用 不適用
尼泊爾 (NP) 不適用 MPAA
荷蘭 (NL) KIJKWIJZER KIJKWIJZER
紐西蘭 (NZ) BSA OFLC
尼加拉瓜 (NI) 不適用 MPAA
尼日 (NE) 不適用 CNC
挪威 (NO) 不適用 MEDIETILSYNET
阿曼 (OM) 不適用 MPAA
巴拿馬 (PA) 不適用 MPAA
巴布亞紐幾內亞 (PG) 不適用 MPAA
巴拉圭 (PY) 不適用 MPAA
秘魯 (PE) 不適用 MPAA
菲律賓 (PH) MTRCB MTRCB
波蘭 (PL) 不適用 MPAA
葡萄牙 (PT) 不適用 CCE
卡達 (QA) 不適用 MPAA
俄羅斯 (RU) MKRF/RUSSIA MKRF/RUSSIA
盧安達 (RW) 不適用 CNC
沙烏地阿拉伯 (SA) 不適用 MPAA
塞內加爾 (SN) 不適用 MPAA
新加坡 (SG) 不適用 MDA
斯洛伐克 (SK) 不適用 MPAA
斯洛維尼亞 (SI) 不適用 MPAA
南非 (ZA) FPB FPB
西班牙 (ES) SETSI ICAA
斯里蘭卡 (LK) 不適用 不適用
瑞典 (SE) 不適用 簡訊 A
瑞士 (CH) FSK FSK
臺灣 (TW) 不適用 MOCTW
塔吉克 (TJ) 不適用 MKRF/RUSSIA
坦尚尼亞 (TZ) 不適用 MPAA
泰國 (TH) 不適用 BFVC
多哥 (TG) 不適用 CNC
千里達及托巴哥 (TT) 不適用 不適用
土耳其 (TR) RTÜK ECBMCT
土庫曼 (TM) 不適用 MKRF/RUSSIA
烏幹達 (UG) 不適用 MPAA
烏克蘭 (UA) 不適用 不適用
阿拉伯聯合大公國 (AE) 不適用 MPAA
英國 (GB) BBFC BBFC
美國 (US) TV_PG MPAA
烏拉圭 (UY) 不適用 MPAA
烏茲別克 (UZ) 不適用 MKRF/RUSSIA
委內瑞拉 (VE) 不適用 RESORTEVIOLENCIA
越南 (VN) 不適用 MCST
尚比亞 (ZM) 不適用 MPAA
辛巴威 (ZW) 不適用 MPAA

GeoShape 屬性

GeoShape 物件包含下列其中一種資料類型：

屬性 預期類型 說明
@id 網址 必要 - 地理區域的 URI 格式 (URI 格式)。
@type 文字 必要 - 一律設為 GeoShape。
addressCountry 文字 必要 - 由兩個字母組成的 ISO 3166-1 alpha-2 國家/地區代碼。
postalCode 文字 選填 - 列出一或多個郵遞區號和/或 FSA (快遞區) 代碼的清單。
identifier PropertyValue 選填 - A 指定行銷區域 (DMA) ID，這是 美國使用者收到 相同的電視頻道和節目
identifier.@type 文字 必要 - 一律設為 PropertyValue。
identifier.propertyID 文字 必要 - 一律設為 DMA_ID。
identifier.value 文字 必填 - 該區域的指定行銷區域代碼。

包含郵遞區號清單的 GeoShape 物件範例：

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

包含 FSA (正向排序區域) 和郵遞區號組合的 GeoShape 物件範例：

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

包含指定行銷區域 ID 的 GeoShape 物件範例：

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}