本節提供「觀看動作」的常見屬性詳細資料。
動作標記屬性
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
文字 | 必要 - 一律設為 WatchAction 。 |
target |
進入點 | 必要:目標物件,提供深層連結與各種 Google 平台的對應。 |
target.@type |
文字 | 必要 - 一律設為 EntryPoint 。 |
target.urlTemplate |
網址 | 必要 - 深層連結會將使用者帶往您的應用程式或平台,並開始播放內容。 |
target.inLanguage |
文字 | 選填 - 系列叢書的原始語言 (採用 BCP 47 格式)。 |
target.actionPlatform |
文字 | 必要 - 對應至 urlTemplate 的平台。媒體動作支援下列功能:
|
target.additionalProperty |
PropertyValue | 如適用 - 代表深層連結的其他屬性值組合。包括:
|
actionAccessibilityRequirement |
ActionAccessSpec | 必要 - 動作存取權規格物件,用於描述內容的存取權要求。請參閱「動作存取規格屬性」。 |
動作標記相關頁面
請參閱下列網頁,瞭解與這些屬性相關的主題:
動作存取規格屬性
屬性 | 預期類型 | 說明 |
---|---|---|
actionAccessibilityRequirement.@type |
文字 | 必要 - 一律設為 ActionAccessSpecification 。 |
actionAccessibilityRequirement.category |
文字 | 必要 - 內容的存取權要求,詳情請參閱付費牆類型一文。 如果實體代表一組內容,您必須將
|
actionAccessibilityRequirement.availabilityStarts |
日期 | 必要 - 動作適用的日期,以 ISO 8601 格式 (包含時區) 為準。
您必須在實體的開始日期至少 7 天前,在動態饋給中提供對應的實體。這有助於提高內容在 Google 平台上顯示的機率。 |
actionAccessibilityRequirement.availabilityEnds |
日期 | 必要 - 動作已不存在的日期,採 ISO 8601 格式 (包含時區)。
請務必在供應情形結束日期的至少 7 天前,在動態饋給中更新可用性。這可以提高這些內容在 dateEnds 日期顯示於 Google 平台上的機率。 |
actionAccessibilityRequirement.eligibleRegion |
Country、City、State、GeoShape 或 Text | 必填 - 可使用內容的區域。如果內容適用於全球,請使用特殊字串 EARTH 。 |
actionAccessibilityRequirement.ineligibleRegion |
Country、City、State 或 GeoShape | 必填 (如果適用) - 內容受限的區域。如果該內容在 eligibleRegion 的任何位置均有提供,則不需提供這項屬性。 |
actionAccessibilityRequirement.requiresSubscription |
媒體訂閱 | 必要 (必要) - 使用者需存取訂閱詳情,才能存取內容。請參閱「媒體訂閱屬性」。
|
actionAccessibilityRequirement.expectsAcceptanceOf |
優惠 | 如果內容需要購買,此為必填屬性 - 與內容相關的優惠詳細資料。在下列情況下提供價格資訊:
Offer 物件,並將 category 物件從 ActionAccessSpecification 物件設為 free 。請參閱「優惠屬性」一節。
|
媒體訂閱屬性
如果 actionAccessibilityRequirement.category
為 subscription
或 externalSubscription
,則為必要欄位。
屬性 | 預期類型 | 說明 |
---|---|---|
requiresSubscription.@type |
文字 | 必要 - 一律設為 MediaSubscription |
requiresSubscription.@id |
網址 | 必要 - 訂閱項目的專屬 ID。如果內容是透過不同訂閱項目存取,各訂閱項目必須有一個專屬 ID。 |
requiresSubscription.name |
文字 | 必要 - 訂閱項目名稱。請注意以下事項:
|
requiresSubscription.sameAs |
網址 | 說明訂閱項目的網頁。 |
requiresSubscription.identifier |
文字 | 如果 category 是 subscription 且 commonTier 是 false ,則為必要欄位 - 這個訂閱項目的專屬字串代表媒體目錄中的一組內容存取權。
|
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 類型:
|
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"
}
]
}