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

觀看動作'常見屬性

本節提供「觀看動作」的常見屬性詳細資料。

動作標記屬性

屬性	預期類型	說明
`@type`	文字	必要 - 一律設為 `WatchAction`。
`target`	進入點	必要：目標物件，提供深層連結與各種 Google 平台的對應。
`target.@type`	文字	必要 - 一律設為 `EntryPoint`。
`target.urlTemplate`	網址	必要 - 深層連結會將使用者帶往您的應用程式或平台，並開始播放內容。
`target.inLanguage`	文字	選填 - 系列叢書的原始語言 (採用 BCP 47 格式)。
`target.actionPlatform`	文字	必要 - 對應至 `urlTemplate` 的平台。媒體動作支援下列功能： `http://schema.org/DesktopWebPlatform`：電腦版網路瀏覽器中的搜尋平台。 `http://schema.org/MobileWebPlatform`：行動版網站網路瀏覽器中的搜尋平台。 `http://schema.org/AndroidPlatform`：Android 應用程式中的搜尋和 PlayGuide 平台。 `http://schema.org/AndroidTVPlatform`：Android TV 應用程式中的 Android TV 平台。 `http://schema.org/IOSPlatform`：iOS 應用程式中的搜尋平台。 `http://schema.googleapis.com/GoogleVideoCast`：Chromecast 裝置上的投放和家用平台。 `http://schema.googleapis.com/GoogleAudioCast`：Chromecast 裝置上的投放和家用平台 (僅限收聽動作)。如需相關規定，請參閱平台類型一節。
`target.additionalProperty`	PropertyValue	如適用 - 代表深層連結的其他屬性值組合。包括： `contentLanguage`：廣播語言 (dub)，採 BCP 47 格式。如果內容是用不同語言配音，則必須加入這個屬性。使用陣列搭配多種語言。 `subtitleLanguage`：字幕語言，採 BCP 47 格式。使用陣列搭配多種語言。 `cameraAngle`：內容的相機角度，例如「Eye-Level」和「High-Angle」。如果內容有不同的攝影角度，就必須提供這個屬性。使用多個相機角度的陣列。 `videoFormat`：用於儲存數位影片日期的檔案格式；例如「標準」的「標準」和「高畫質」是高畫質。有效的影片格式包括 SD、HD、2K、4K 和 8K。使用多種影片格式的陣列。請參閱 additionalProperty 範例。
`actionAccessibilityRequirement`	ActionAccessSpec	必要 - 動作存取權規格物件，用於描述內容的存取權要求。請參閱「動作存取規格屬性」。

動作標記相關頁面

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

動作存取規格屬性

屬性	預期類型	說明
`actionAccessibilityRequirement.@type`	文字	必要 - 一律設為 `ActionAccessSpecification`。
`actionAccessibilityRequirement.category`	文字	必要 - 內容的存取權要求，詳情請參閱付費牆類型一文。如果實體代表一組內容，您必須將 `category` 設為內容內容的存取限制最少。舉例來說，如果 `TVSeries` 將部分 `TVEpisode` 內容設為 `nologinrequired`，有些則設為 `subscription`，請將這個 `TVSeries` 設為 `nologinrequired`。
`actionAccessibilityRequirement.availabilityStarts`	日期	必要 - 動作適用的日期，以 ISO 8601 格式 (包含時區) 為準。這個日期可以設在未來。您必須在實體的開始日期至少 7 天前，在動態饋給中提供對應的實體。這有助於提高內容在 Google 平台上顯示的機率。
`actionAccessibilityRequirement.availabilityEnds`	日期	必要 - 動作已不存在的日期，採 ISO 8601 格式 (包含時區)。必須等於或大於 `availabilityStarts`後 72 小時。如果內容在發布後一律可供使用，請將此日期設為從目前日期算起的 20 年。請務必在供應情形結束日期的至少 7 天前，在動態饋給中更新可用性。這可以提高這些內容在 dateEnds 日期顯示於 Google 平台上的機率。
`actionAccessibilityRequirement.eligibleRegion`	Country、City、State、GeoShape 或 Text	必填 - 可使用內容的區域。如果內容適用於全球，請使用特殊字串 `EARTH`。
`actionAccessibilityRequirement.ineligibleRegion`	Country、City、State 或 GeoShape	必填 (如果適用) - 內容受限的區域。如果該內容在 `eligibleRegion` 的任何位置均有提供，則不需提供這項屬性。
`actionAccessibilityRequirement.requiresSubscription`	媒體訂閱	必要 (必要) - 使用者需存取訂閱詳情，才能存取內容。請參閱「媒體訂閱屬性」。如果 `category` 是 `subscription` 或 `externalSubscription`，請提供這個屬性。
`actionAccessibilityRequirement.expectsAcceptanceOf`	優惠	如果內容需要購買，此為必填屬性 - 與內容相關的優惠詳細資料。在下列情況下提供價格資訊：一次性購買內容 (`rental` 或 `purchase`) 需要額外購買訂閱者的訂閱型內容 (`subscription` 或 `externalsubscription`) 如果價格為 0.00，請完全移除 `Offer` 物件，並將 `category` 物件從 `ActionAccessSpecification` 物件設為 `free`。請參閱「優惠屬性」一節。

媒體訂閱屬性

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

屬性	預期類型	說明
`requiresSubscription.@type`	文字	必要 - 一律設為 `MediaSubscription`
`requiresSubscription.@id`	網址	必要 - 訂閱項目的專屬 ID。如果內容是透過不同訂閱項目存取，各訂閱項目必須有一個專屬 ID。
`requiresSubscription.name`	文字	必要 - 訂閱項目名稱。請注意以下事項：如果內容是透過不同訂閱項目存取，這個名稱必須與使用者驗證系統中的名稱相符。舉例來說，如果使用者可根據名為「Package 1」的訂閱項目存取內容，但驗證系統使用「PKG1a」的名稱，請使用「PKG1」。對於 TVE 供應商，這是向 TVE 驗證器註冊的驗證器名稱。這個字串是透過 TVE Authenticator 唯一識別服務名稱。
`requiresSubscription.sameAs`	網址	說明訂閱項目的網頁。
`requiresSubscription.identifier`	文字	如果 `category` 是 `subscription` 且 `commonTier` 是 `false`，則為必要欄位 - 這個訂閱項目的專屬字串代表媒體目錄中的一組內容存取權。 Google 建議使用下列 ID 的語法：網域名稱 + 冒號 (:) + 內容存取層級，範例：example.com:basic、example.com:premium、example.com:sports 如果提供授權 API，這個屬性與授權 ID 相同
`requiresSubscription.authenticator`	機構組織	如果 `category` 為 `externalsubscription`，則為必要欄位 - 此容器提供外部提供者驗證器的詳細資料。
`requiresSubscription.authenticator.@type`	文字	如果 `category` 為 `externalsubscription`，則為必要欄位 - 一律設為 `Organization`。
`requiresSubscription.authenticator.name`	文字	如果 `category` 為 `externalsubscription`，則為必要欄位 - 驗證服務的名稱。將 TVE 供應商設為 TVE
`requiresSubscription.commonTier`	布林	必填 (如果適用) - 如果類別設為訂閱，則為必填屬性。如要進一步瞭解 commonTier，請參閱常見級別規定說明文件。

授權 API 規定

如果 actionAccessibilityRequirement.category 是 subscription 或 externalSubscription，且您的訂閱產品包含多個套件或級別，或是有外掛程式支援，您就必須使用授權 API。如果您的訂閱是分層層級並授予目錄中所有內容的存取權，則請勿加入這項設定。

A 公司只有一項訂閱方案，可讓訂閱的使用者存取所有可用的內容：不必使用授權 ID/API
公司 B 的基本訂閱提供部分內容的存取權，付費訂閱則可用來存取付費內容：如要提供授權 ID/API，
C 公司的基本訂閱項目提供部分內容的存取權，並新增讓使用者存取第三方內容的套件：需要授權 ID / API

媒體訂閱相關頁面

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

優惠屬性

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

優惠相關頁面

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

ID

媒體動作動態饋給接受各式各樣的 ID，可協助識別實體。這些 ID 可協助您加快將動態饋給中的內容與 Google 資料庫中的內容進行比對的流程。雖然大部分的 ID 都可以透過各實體類型的 identifier 屬性新增至動態饋給，但 EIDR 有專屬的代表屬性。以下將探討上述兩種做法。

ID 屬性

屬性	預期類型	說明
`identifier`	文字	強烈建議使用 - 通常是一組可明確識別特定實體的 ID。可使用多個 ID。此屬性適用於所有智慧手錶動作實體類型。下表列出 `identifier` 屬性已接受的 ID 和子資源。請參閱「手錶動作」動態饋給範例的 ID/EIDR 範例。

屬性	預期類型	說明
`@type`	文字	必要 - 一律設為 `PropertyValue`。
`propertyID`	文字	必要 - 我們支援下列 ID 類型： `TMS_ROOT_ID`：Gracenote (TMS) 根 ID (例如 15829)。這不適用於不適用於只能使用 TMS_ID 的機構和 BroadcastService 實體。 `TMS_ID`：Gracenote (TMS) 變體 ID (例如 MV000398520000)。 `WIKIDATA_ID`：WikiData ID (例如 Q134773)。 `IMDB_ID`：IMDB ID (例如 tt0109830)。 `OPTA_ID`：OPTA 運動 ID。 `STATS_ID`：STATS 執行 ID。 `VIP_TIMES_ID`：日本人才的日本 VIPTime (Nihon Tarento Meikan) ID。 `DMA_ID`：美國地區指定行銷區域代碼，用於 GeoShape 物件。 `_PARTNER_ID_`：這個屬性必須包含「_PARTNER_ID_」字串，這個值必須是服務供應商在內部或外部使用的專屬 ID，以識別實體 (例如 12345 或 a5c604e2-e9e5-4ff3-b728-245799dc37f1)。
`value`	文字	必要 - 指定 ID 系統的值。

EIDR 屬性

EIDR (The Entertainment Identifier Registry) 是一組全球性的獨特 ID 系統，適用於多種媒體內容，包括動態影像和電視節目。識別系統會將 ID 解析為中繼資料與頂層標題、編輯等內容相關的中繼資料。下表列出與 EIDR 相關的屬性和用法。

屬性	預期類型	說明
`titleEIDR`	文字	強烈建議使用 - EIDR (娛樂 ID 註冊資料庫) ID 代表的是電影或電視節目中，最普遍/最廣泛的內容，這項屬性適用於 TVSeries、TVSeason、TVEpisode 和 Movie 實體規格頁面。舉例來說，動態電影的 titleEIDR 名稱為「Ghostbusters」；「10.5240/7EC7-228A-510A-053E-CBB8-J」如下。請參閱「Identifier/EIDR 範例」範例
`editEIDR`	文字	強烈建議 - EIDR (娛樂 ID 登錄) ID 代表電影或電視作品的特定編輯/版本，這項屬性適用於 TVEpisode 和 Movie 實體規格頁面。舉例來說，動態影片名稱為「Ghostbusters」，標題為「10.5240/7EC7-228A-510A-053E-CBB8-J」，例如「10.5240-13-E-232-463-667-347-14-E17-343-C13-11-」和

內容分級機構

請根據BroadcastService.contentRating、Movie.contentRating 和 TVSeries.contentRating 使用下表中的值。請務必在評分值前面加上評分代理商。例如：

在美國，分級為「R」的電影的 Movie.contentRating 值應為「MPAA R」。
在美國地區，電視劇中名為「TV-MA」的 TVSeries.contentRating 值應設為「TVPG TV-MA」。

國家/地區	電視分級機構	電影分級機構
阿爾巴尼亞 (AL)	無法提供資訊	無法提供資訊
安哥拉 (AO)	無法提供資訊	客戶長
安地卡及巴布達 (AG)	無法提供資訊	MPAA
阿根廷 (AR)	印尼	印尼
亞美尼亞 (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	挑戰
維德角 (CV)	無法提供資訊	客戶長
智利 (CL)	無法提供資訊	MPAA
哥倫比亞 (CO)	無法提供資訊	MPAA
哥斯大黎加 (CR)	無法提供資訊	MPAA
克羅埃西亞 (HR)	無法提供資訊	無法提供資訊
賽普勒斯 (CY)	無法提供資訊	GRFILM
捷克 (CZ)	無法提供資訊	CZFILM
丹麥 (DK)	無法提供資訊	我的客戶中心
厄瓜多 (EC)	無法提供資訊	MPAA
埃及 (EG)	無法提供資訊	MPAA
薩爾瓦多 (SV)	無法提供資訊	MPAA
愛沙尼亞 (EE)	無法提供資訊	EEFI
斐濟 (FJ)	無法提供資訊	無法提供資訊
芬蘭 (FI)	無法提供資訊	中
法國 (FR)	自訂搜尋廣告	自訂搜尋廣告
加蓬 (GA)	無法提供資訊	CNC：
德國 (DE)	FSK	FSK
希臘 (GR)	西班牙里拉	GRFILM
瓜地馬拉 (GT)	無法提供資訊	MPAA
海地 (HT)	無法提供資訊	無法提供資訊
宏都拉斯 (HN)	無法提供資訊	MPAA
香港 (HK)	加拿大	FCO
匈牙利 (HU)	無法提供資訊	MPAA
冰島 (IS)	無法提供資訊	韓國
印度 (IN)	CBFC	CBFC
印尼 (ID)	主要成效指標	LSF
愛爾蘭 (IE)	無法提供資訊	IFCO
義大利 (IT)	AGCOM	AGCOM
象牙海岸 (CI)	無法提供資訊	CNC：
牙買加 (JM)	無法提供資訊	MPAA
日本 (JP)	不適用	愛爾蘭
約旦 (JO)	無法提供資訊	MPAA
哈薩克 (KZ)	無法提供資訊	MRKF
韓國 (KR)	KMRB	KMRB
科威特 (KW)	無法提供資訊	MPAA
吉爾吉斯 (KG)	無法提供資訊	MKRF/RUSSIA
寮國 (LA)	無法提供資訊	無法提供資訊
拉脫維亞 (LV)	無法提供資訊	NKCLV
黎巴嫩 (LB)	無法提供資訊	MPAA
立陶宛 (LT)	無法提供資訊	無法提供資訊
盧森堡 (LU)	無法提供資訊	韓國
馬其頓 (MK)	無法提供資訊	MPAA
馬來西亞 (馬來西亞)	無法提供資訊	FCBM
馬利 (ML)	無法提供資訊	CNC：
馬爾他 (MT)	無法提供資訊	MCCAA
模里西斯 (MU)	無法提供資訊	BBFC
墨西哥 (MX)	RTC	RTC
摩爾多瓦 (MD)	無法提供資訊	無法提供資訊
納米比亞 (NA)	無法提供資訊	無法提供資訊
尼泊爾 (NP)	無法提供資訊	MPAA
荷蘭 (NL)	韓國	韓國
紐西蘭 (NZ)	英國商業銀行 (BSA)	OFLC
尼加拉瓜 (NI)	無法提供資訊	MPAA
尼日 (NE)	無法提供資訊	CNC：
挪威 (NO)	無法提供資訊	中繼
阿曼 (OM)	無法提供資訊	MPAA
巴拿馬 (PA)	無法提供資訊	MPAA
巴布亞紐幾內亞 (PG)	無法提供資訊	MPAA
巴拉圭 (PY)	無法提供資訊	MPAA
秘魯 (PE)	無法提供資訊	MPAA
菲律賓 (PH)	MTRCB	MTRCB
波蘭 (PL)	無法提供資訊	MPAA
葡萄牙 (PT)	無法提供資訊	客戶長
卡達 (QA)	無法提供資訊	MPAA
俄羅斯 (RU)	MKRF/RUSSIA	MKRF/RUSSIA
盧安達 (RW)	無法提供資訊	CNC：
沙烏地阿拉伯 (SA)	無法提供資訊	MPAA
塞內加爾 (SN)	無法提供資訊	MPAA
新加坡 (SG)	無法提供資訊	MDA
斯洛伐克 (SK)	無法提供資訊	MPAA
斯洛維尼亞 (SI)	無法提供資訊	MPAA
南非 (ZA)	FPB	FPB
西班牙 (ES)	設定	ICAA
斯里蘭卡 (LK)	無法提供資訊	無法提供資訊
瑞典 (SE)	無法提供資訊	簡訊
瑞士 (CH)	FSK	FSK
臺灣	無法提供資訊	行銷目標
塔吉克 (TJ)	無法提供資訊	MKRF/RUSSIA
坦尚尼亞 (TZ)	無法提供資訊	MPAA
泰國 (TH)	無法提供資訊	BFVC
多哥 (TG)	無法提供資訊	CNC：
千里達及托巴哥 (TT)	無法提供資訊	無法提供資訊
土耳其 (TR)	RTRTK	ECBMCT
土庫曼 (TM)	無法提供資訊	MKRF/RUSSIA
烏幹達 (UG)	無法提供資訊	MPAA
烏克蘭 (阿拉伯聯合大公國)	無法提供資訊	無法提供資訊
阿拉伯聯合大公國 (AE)	無法提供資訊	MPAA
英國 (GB)	BBFC	BBFC
美國 (US)	電視_PG	MPAA
烏拉圭 (UY)	無法提供資訊	MPAA
烏茲別克 (UZ)	無法提供資訊	MKRF/RUSSIA
委內瑞拉 (VE)	無法提供資訊	雷維爾森堡
越南 (VN)	無法提供資訊	MCST
尚比亞 (ZM)	無法提供資訊	MPAA
辛巴威 (ZW)	無法提供資訊	MPAA

GeoShape 屬性

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

郵遞區號清單 (例如美國、加拿大或其他郵遞區號)
加拿大轉寄排序區域清單
指定行銷區域 (DMA) ID - 美國境內區域的 ID，用以接收相同的電視頻道和節目。

屬性	預期類型	說明
`@id`	網址	必要 - 地理區域 ID，以 URI 格式表示。
`@type`	文字	必要 - 一律設為 `GeoShape`。
`addressCountry`	文字	必要 - 兩個字母的 ISO 3166-1 alpha-2 國家/地區代碼。
`postalCode`	文字	選用 - 一或多個郵遞區號和/或 FSA (前置排序區域) 代碼清單。
`identifier`	PropertyValue	選用 - 指定行銷區域 (DMA) ID 是美國其中一個區域的 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"
  ]
}

包含 DMA ID 的 GeoShape 物件範例：

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