本節提供 Podcast 內容標記屬性的詳細資訊。
Podcast 系列規格
PodcastSeries
代表 Podcast 系列,
也稱之為 Podcast 節目
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@context |
必要 | 文字 | Schema.org 結構定義。一律設為
[http://schema.googleapis.com,{@language}:xx}] ,其中
xx 應該以語言代碼表示。這會設定預設語言
用於實體的文字值 |
@type |
必要 | 文字 | 一律設為 PodcastSeries 。 |
@id |
必要 | 文字 | URI 格式的 Podcast 系列全域專屬 ID。ID 必須是
且不會隨時間改變系統會將其視為不透明字串,且不會
則必須是有效連結用於 @id 值的網域必須
擁有者為機構所有
|
url |
必要 | 文字 | 你網站上推出 Podcast 系列的標準網址,或是
情境。名稱在全域範圍內不得重複。這個連結幫助準確
確認動態饋給內容與 Google 資料庫中的內容。適用對象
播放時,請使用說明文件 ListenAction 一節中詳述的 target.urlTemplate 。 |
name |
必要 | 文字 | Podcast 系列的名稱。每種語言只能輸入一個名稱。 使用陣列標記多種語言的說明。請參閱多個 地區和語言範例。 |
description |
必要 | 文字 | Podcast 系列簡介。 使用陣列標記多種語言的說明。請參閱 多區域和語言範例。 |
alternativeHeadline |
選用 | 文字 | Podcast 系列的字幕。 |
author |
必要 | repeated |
開發或推出節目的人物或團體。通常是指主機。如需示例和詳細資料,請參閱機構、人員 (作者/發布者)。 |
publisher |
選用 | repeated |
負責發布這個節目的原始團體或聯播網。經常 是指負責發布/製作多個 Podcast 的機構。 如需示例和詳細資料,請參閱機構、 人物 (作者/出版商)。我們強烈建議將這個欄位用於 。 |
actor |
選用 | repeated |
Podcast 執行者。如需示例和詳細資料,請參閱「執行者 (主機/訪客)」一節。 |
logo |
選用 | repeated |
系列叢書的標誌圖片。提供這項資訊完整說明
ImageObject 。提供可用的最高解析度。JPEG 或 PNG
建議採用。如需詳細資訊和範例,請參閱
ImageObject (logo) 區段。 |
image |
必要 | repeated |
系列叢書的圖片。提供完整說明
ImageObject 。提供可用的最高解析度。JPEG 或 PNG 為
詳情請參閱「ImageObject (logo)」一節。
範例。 |
isFamilyFriendly |
必要 | 布林值 | 指出內容是否闔家皆宜 (即是否適合闔家觀賞)
適合全家大小,包含兒童)。Google 產品
可能會使用 isFamilyFriendly 來決定要播放的內容。
值必須是 true 或 false 。 |
inLanguage |
必要 | 文字 | Podcast 內容的語言 (採用 ISO 639-1 格式)。這個值可用來滿足使用者 會要求特定語言的內容。 |
genre |
必要 | 文字 repeated |
Podcast 系列的類別或類型。例如,您可以追蹤 標準 Podcast 類別。 |
endDate |
選用 | 日期 | Podcast 系列集結的發布日期。僅限 系列叢書結束時,請加入這個欄位。 |
rssFeed |
必要 | 網址 | Podcast 系列的 RSS 動態消息網址。 |
potentialAction |
必要 | ListenAction |
要觸發的動作,讓使用者能聆聽內容。詳情 請參閱 ListenAction。 |
popularityScore
| 選用 | PopularityScoreSpecification |
熱門程度分數有助於決定放送優先順序
多個候選鍵。請參閱
PopularityScoreSpecification (popularityScore) 部分
詳細資料和範例 |
keywords |
選用 | 文字 repeated |
與 Podcast 系列相關聯的關鍵字清單。這些 關鍵字可用來擴大可觸發這個 Podcast 的使用者查詢 這是 Gemini 版 Google Workspace 系列課程之一例如邀請對象名稱、討論主題等。 |
sameAs |
選用 | 網址 | 第三方 (不在您的網域內) 參照的網頁 明確指出項目的身分。這個網頁是用於 有多個類似系列時,會發出混淆。舉例來說,維基百科 或 Podcast 系列的首頁我們強烈建議此欄位 以便釐清整個系列叢書 |
releasedEvent |
選用 | PublicationEvent 或更具體的子類型:FeaturedEvent 或 ExclusiveEvent |
標示 Podcast 系列發布或發布的事件。A 罩杯 出版品活動可能會註明 Podcast 的最初發布版本 較專業的類型可用來表示 發行期間如需詳細資訊和範例,請參閱 PublicationEvent、 FeaturedEvent, ExclusiveEvent (releasedEvent) 部分。請注意,因此, 作為獨家或精選系列,暗示節目的所有劇集。 獨家或精選內容 |
countryOfOrigin |
選用 | 國家/地區 | 製片公司主要辦公室所在的國家/地區,或是 個人的 Podcast 負責人 |
Podcast 集數規格
PodcastEpisode
是單集節目的 schema.org 表示法
在 PodcastSeries
內。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@context |
必要 | 文字 | Schema.org 結構定義。一律設為 [http://schema.googleapis.com,{@language:xx}]
xx 是語言代碼。這會設定預設字元
動態饋給文字值所用的語言。 |
@type |
必要 | 文字 | 一律設為 PodcastEpisode 。 |
@id |
必要 | 文字 | Podcast 單集節目的全域專屬 ID,使用 URI 格式。ID 必須是
且不會隨時間改變系統會將其視為不透明字串,且不會
則必須是有效連結貴機構必須擁有用於 @id 值的網域。 |
url |
必要 | 文字 | 網站上介紹或描述
Podcast 單集節目。這個值在全域範圍內不得重複。這個連結的用途是
動態饋給內容與 Google
或 Microsoft SQL Server 資料庫如需播放,請參閱target.urlTemplate
ListenAction 部分。 |
name
| 必要 | 文字 | Podcast 單集節目的名稱。 每種語言只能有一個名稱。使用陣列標記 提供多種語言版本的說明請參閱多區域和 語言範例。 |
description |
必要 | 文字 | Podcast 單集節目的說明。 |
alternativeHeadline |
必要 | 文字 | Podcast 單集節目的副標題。 |
author |
必要 | repeated |
開發或提供劇集的個人或團隊。這個值經常
指的是主機。如果作者與節目相同,你就可以重複使用
,即 PodcastSeries 實體提供資訊。如需示例和
詳情請參閱機構、個人 (作者/出版商)。 |
publisher |
必要 | repeated |
負責發布這個節目的原始團體或聯播網。經常 是指負責發布或製作 Podcast。請參閱機構、人員 (作者/出版商), 範例和詳細資料。強烈建議您使用這個欄位進行區別 建議你定義適用位置 |
actor |
必要 | repeated |
Podcast 執行者。如需示例和詳細資料,請參閱 執行者 (主機/訪客) 部分。 |
datePublished |
必要 | 日期時間 | Podcast 單集節目的發布日期。這個值的用途是 包括排序序列與釐清差異 |
episodeNumber |
必要 | 整數 | 集數。 |
partOfSeries |
必要 | PodcastSeries | 這集 Podcast 節目所在的 PodcastSeries 。請參閱
PodcastSeries(partOfSeries) 的描述與範例。 |
partOfSeason |
選用 | PodcastSeason | 如果是多季影集,這個屬性可提供季別資訊 季別名稱和季別名稱請參閱 PodcastSeason(partOfSeason) 取得詳細資訊和範例 |
timeRequired |
必要 | 時間長度 | 劇集的長度,採用 ISO 8601 時間格式。 |
image |
選用 | repeated |
系列叢書的圖片。這必須是完整的說明
ImageObject 。提供可用的最高解析度。JPEG 或 PNG
建議採用。請參閱 ImageObject (logo) 部分
詳細資料和範例 |
isFamilyFriendly |
必要 | 布林值 | 指出內容是否闔家皆宜 (也就是說,
內容適合所有家庭成員,包括兒童)。Google 敬上
產品可能會使用 isFamilyFriendly 決定要播放的內容。
值必須是 true 或 false 。 |
inLanguage |
必要 | 文字 | Podcast 單集節目的內容語言,採用 ISO 639-1 格式。使用這份草稿 值來執行要求特定語言內容的使用者查詢。如果 內容有多種語言版本,請只列出一種主要語言。 |
genre |
必要 | 文字 repeated |
Podcast 系列的類別或類型。例如追蹤標準 Podcast 類別。 |
associatedMedia |
選用 | AudioObject | Podcast 單集節目的音訊檔案。如需詳細資訊和範例,請參閱 AudioObject(associatedMedia)。 |
potentialAction |
必要 | ListenAction | 要觸發的動作,讓使用者能聆聽內容。詳情 請參閱「ListenAction」一節。 |
popularityScore |
選用 | PopularityScoreSpecification | 有多個熱門關鍵字時,用來決定放送優先順序的熱門程度分數 候選檔案。如需詳細資訊和範例,請參閱 popityScoreSpecification 區段。 |
keywords |
選用 | 文字 repeated |
與 Podcast 系列相關的關鍵字清單。這些關鍵字可能以
用於擴充可觸發這個 Podcast 單集節目的使用者查詢。適用對象
例如 news 、sports 或 history 。 |
identifier |
必要 | PropertyValue repeated |
如果是 請參閱 PropertyValue (identifier) 部分以瞭解 範例。 |
sameAs |
選用 | 網址 | 第三方 (不在您的網域內) 參照的網頁 明確指出項目的身分。Google 會將這個網頁用於 有多個類似系列時,會發出混淆。舉例來說,維基百科 或 Podcast 單集節目首頁請注意,系列叢書層級參考資料 亦不得在此提供頁面。我們強烈建議您 單集節目的混淆。 |
releasedEvent |
選用 | PublicationEvent 等更具體的子類型: FeaturedEvent 或 FeaturedEvent | 標記 Podcast 單集發布或發布的事件。A 罩杯 出版品活動可能會註記 Podcast 單集節目的 以及更具體的子類型,代表應用程式具有專屬性或精選性 發行期間如需詳細資訊和範例,請參閱 PublicationEvent、DiscoverEvent、ExclusiveEvent (releasedEvent) 部分。 請注意,將系列叢書標示為獨家或上方精選系列時, 。我們建議您將這類網址 並在最精細的層級顯示資源 |
countryOfOrigin |
選用 | 國家/地區 | 製片公司或個人的主要辦公室所在國家/地區 因為是不是要確保 Podcast |
Podcast 系列 (partOfSeries)
使用 partOfSeries
建立 PodcastEpisode
之間的關係
及其父項 PodcastSeries
。因為 PodcastSeries
的完整詳細資料
會在個別 PodcastSeries
實體中說明,您不需提供
完整的詳細資料請見partOfSeries
。您只需要提供下列資訊
資源:
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 PodcastSeries 。 |
@id |
必要 | 網址 | 系列叢書的全域專屬 ID,採 URI 格式。編號必須與
動態饋給中完整 PodcastSeries 實體的 ID。 |
name |
必要 | 文字 | Podcast 系列的名稱。
|
範例 1
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=1",
"name": "Radiolab"
},
Podcast 季別 (季度)
PodcastSeason
代表電影的季別資訊
PodcastEpisode
,最重要的是季別編號。您只需要
此屬性。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 PodcastSeason |
@id |
必要 | 網址 | 季別的全域專屬 ID,以 URI 格式表示。ID 必須是固定的 且不會隨時間改變系統會將其視為不透明字串,也沒有 應該是有效的連結 |
seasonNumber |
必要 | 整數 | Podcast 系列的季別編號。 |
name |
選用 | 文字 | Podcast 季別的名稱。 |
範例 1
"partOfSeason": {
"@type": "PodcastSeason",
"@id": "http://www.tjpodcast.org/seriesx/season?id=1",
"seasonNumber": 1,
"name": "Radiolab Season 1"
},
機構、個人 (作者或發布者)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Organization 或 Person 。 |
@id |
必要 | 網址 | 機構或個人的全域專屬 ID,格式為 URI 格式。ID 則必須保持穩定,且不會隨時間而改變。系統會將此類別視為不透明字串 不一定要是有效連結 |
name |
必要 | 文字 | 機構或個人的名稱。 |
sameAs |
選用 | 網址 | 第三方 (不在您的網域內) 參照的網頁 明確指出項目的身分。Google 會將這個網頁用於 有多個類似系列時,會發出混淆。舉例來說, 機構或機構官方網站的維基百科頁面。 |
範例 1
"author": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
範例 2
"author": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/jad_abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
"name": "Jad Abumrad"
},
執行者 (主機或訪客)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Organization 或 Person 。 |
@id |
必要 | 網址 | 機構或個人的全域專屬 ID,格式為 URI 格式。ID 則必須保持穩定,且不會隨時間而改變。系統會將此類別視為不透明字串 不一定要是有效連結 |
name |
必要 | 文字 | 機構或個人的名稱。 |
roleName |
必要 | 文字 | `Host` 或 `Guest`。 |
sameAs |
選用 | 網址 | 第三方 (不在您的網域內) 參照的網頁 明確指出項目的身分。Google 會將這個網頁用於 有多個類似系列時,會發出混淆。舉例來說, 機構或機構官方網站的維基百科頁面。 |
範例 1
"actor":[{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language":"en",
"@value": "Roman Mars"
},
"roleName": "Host"
"sameAs": "https://en.wikipedia.org/wiki/Roman",
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name":{
"@language":"en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
},
}]
ImageObject (標誌或圖片)
ImageObject
是用來提供內容的標誌或圖片。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 ImageObject 。 |
height |
選用 | 整數 | 圖片的高度 (以像素為單位)。 |
width |
選用 | 整數 | 圖片寬度 (以像素為單位)。 |
contentUrl |
必要 | 網址 | 可以放置圖片的網址。 |
regionsAllowed |
選用 | 國家/地區 repeated |
允許播放媒體內容的國家/地區:
|
國家/地區 (image.regionsAllowed)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Country. |
name |
必要 | 文字 |
ISO 3166-1 alpha-2 國家/地區代碼。例如 GB
US 。 |
範例 1
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
範例 2
"logo": [
{
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/67890.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/12345.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "PK"
}
]
},
],
PropertyValue (identifier)
如果內容有 GUID,則可提供
「identifier
」欄位,提高 Google 對帳
內容。請注意,PodcastEpisode
須有 GUID。
這必須與單集節目的 @id
欄位不同 (不是
) 而且必須在全球範圍內代表來源單集節目,
在一段時間內呈現不同來源的不重複體驗。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為「PropertyValue」。 |
propertyID |
必要 | 文字 | 一律設為 GUID 。 |
value |
必要 | 文字 | 系列內容或劇集的 GUID。 |
範例 1
"identifier": {
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},
HotityScoreSpecification (popularityScore)
popularityScore
可協助使用者找到最適當的建議
若是使用者查詢中的條件同時符合多個
動態饋給中的實體熱門程度分數最高的內容
,如果這個值為
廣告。所有不含這個欄位的內容都會預設為熱門程度分數 0
。
分數比較的是整份目錄的範圍內
確保所有動態饋給中的體重計一致。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 PopularityScoreSpecification 。 |
value |
必要 | 數字 | 要與目錄中其他實體比較的正數值 以便優先放送數字越大,表示熱門程度越高。 |
eligibleRegion |
選用 | 國家/地區或文字 repeated |
適用此熱門程度分數的一或多個地區清單。 如果熱門程度分數適用於全球,文字請使用 如需列出特定區域,請使用「Country」類型。 如果未填寫這個欄位, |
國家/地區 (popularityScore.eligibilityRegion)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Country 。 |
name |
必要 | 文字 |
ISO 3166-1 alpha-2 國家/地區代碼。例如 GB
US 。 |
範例 1
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
範例 2
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
範例 3
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 101,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
PublicationEvent、精選 Event、ExclusiveEvent (releasedEvent)
- PublicationEvent
- 使用這個物件來表示節目或節目的發布日期和地點
劇集或劇集的「發布日期」。
此外,
publishedBy
欄位代表發布或發行內容 是單集 Podcast 系列或單集節目的一個實體 - ExclusiveEvent
- 請使用這個物件來表示供應商具有專屬發布權 Podcast 版本專屬性可以是特定區域和時間範圍,而且必須 請納入「organization」欄位,指向 內容
- FeaturedEvent
- 使用這個物件來表示供應商主打 Podcast (例如「原創」)。
- 「原創」與「獨家」內容不同
- 「原創作品 (精選內容)」通常代表內容的專屬權利
導致字詞過載因此,預期的意義必須分開計算
上述兩個類別原始實體也可能含有
而獨一無二,在此情況下,
releasedEvent
可以接受同時包含兩者的陣列 相同實體的事件類型。
請注意,雖然獨佔性或精選性可能在
供應商的目錄,PublicationEvent
通常適用於啟用
區分實體及提供
例如係列影片或劇集的發行日期
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 PublicationEvent 的其中一個值,
ExclusiveEvent 或 FeaturedEvent 。 |
location |
必要 | 國家/地區 | 發布事件的區域。您還可以使用
表示專屬限制和發行限制
專屬實體。請使用 ISO 3166 代碼指定國家/地區。如需
設為 EARTH 已明確設定
location 到 EARTH (適用於特定語言)
這些限制不適用。 |
startDate |
建議 (for ExclusiveEvent) | 日期或日期時間 | 實體的開始日期出版品如果選擇
PublicationEvent ,表示應用程式的初始發布日期
這個實體情況下為 ExclusiveEvent 或
FeaturedEvent ,代表
實體的獨佔性或主打性。 |
endDate |
建議 (for ExclusiveEvent) | 日期或日期時間 | 實體的發布日期。如果選擇
PublicationEvent ,代表最終發布日期
。情況下為 ExclusiveEvent 或
FeaturedEvent ,代表
實體的獨佔性或主打性。 |
publishedBy |
必要 | 機構或個人 | Organization 或 Person 實體,
此實體將發布並套用至這個出版品活動。請使用
與
機構
(作者/出版商) 部分。 |
範例 1
"releasedEvent": [ {
"@type": "PublicationEvent",
"location": "EARTH",
"startDate": "2016-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
}, {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
},
]
範例 2
"releasedEvent": [ {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}
]
AudioObject (AssociateMedia)
AudioObject
是用來提供 Podcast 單集節目的原始媒體檔案。
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 AudioObject 。 |
contentUrl |
必要 | 網址 | 媒體檔案的網址。 |
contentSize |
必要 | 整數 | 媒體檔案大小,以位元組為單位。 |
encodingFormat |
必要 | 文字 | 媒體檔案的 IANA 媒體類型。例如:
audio/mpeg 。 |
duration |
必要 | 時間長度 | 媒體的長度,採用 ISO 8601 時間長度格式。 |
transcript |
選用 | 文字 | 單集節目的轉錄稿。 |
bitrate |
選用 | 文字 | 媒體檔案的位元率。 |
name |
選用 | 文字 | 媒體檔案的檔案名稱。 |
範例 1
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT5M32S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"name": "radiolab_podcast19.mp3",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
ListenAction (potentialAction)
ListenAction
實體會定義播放的深層連結和條件
使用者 (例如地理區域、長期、登入或訂閱狀態)
存取內容
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 ListenAction 。 |
target |
必要 |
repeated |
深層連結搭配支援的平台規格
可能不準確或不適當您可以使用多個 EntryPoint 欄位
為不同的平台組合定義不同的深層連結。 |
actionAccessibilityRequirement |
必要 |
repeated |
定義使用者必須符合怎樣的條件才能存取這個實體。如有多個
「ActionAccessSpecification 」會顯示,而使用者只要符合以下任一項目
符合規範可存取的內容 |
EntryPoint (potentialAction.target)
@type
必填
文字
一律設為 EntryPoint
。
urlTemplate
必要
網址
用來播放內容的連結。
actionPlatform
必要
文字
repeated
這個深層連結適用的平台。下列值 可能:
"http://schema.org/DesktopWebPlatform"
"http://schema.org/MobileWebPlatform"
"http://schema.org/AndroidPlatform"
"http://schema.org/AndroidTVPlatform"
"http://schema.org/IOSPlatform"
"http://schema.googleapis.com/GoogleAudioCast"
"http://schema.googleapis.com/GoogleVideoCast"
ActionAccessSpecification (potentialAction.actionAccessibilityRequirement)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 ActionAccessSpecification 。 |
category |
必要 | 文字 |
存取權需求類型。必須是下列其中一項 值:
|
availabilityStarts |
選用 | 日期時間 | 供應期間的開始時間。您可以使用這項功能 向使用者顯示該內容的確切時間。 |
availabilityEnds |
選用 | 日期時間 | 供應期間的結束時間。您可以使用這項功能 觀眾看到這項內容的確切時間 使用者。 |
eligibleRegion |
必要 | 國家/地區 repeated |
這項優惠適用的國家/地區。您可以運用這項指標 控制這項內容必須位於哪個國家/地區 廣告。 |
requiresSubscription |
必要 (如適用) | MediaSubscription | 需要訂閱套件才能存取此內容。如果您的 服務提供多個訂閱套裝方案,此為必填欄位。 如果您的服務是免費,或者只有單一訂閱級別, 可以略過這個欄位 |
國家/地區 (potentialAction.actionAccessibilityRequirement.eligibilityRegion)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Country 。 |
name |
必要 | 文字 | ISO 3166-1 alpha 2 國家/地區代碼。 |
MediaSubscription (potentialAction.actionAccessibilityRequirement.requiresSubscription)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 MediaSubscription 。 |
@id |
必要 | 網址 | URI 格式的訂閱項目套件的全域專屬 ID。 ID 必須固定,且不會隨時間而改變。視為不透明 字串且不必是有效連結。 |
name |
必要 | 文字 | 訂閱項目套件名稱的名稱。例如:
Premium ,Basic 。 |
expectsAcceptanceOf |
建議 | 優惠 | 與購買媒體訂閱項目相關的優惠。個人中心 可用來表示訂閱項目的價格。 |
優惠 (potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf)
屬性 | 優先順序 | 類型 | 說明 |
---|---|---|---|
@type |
必要 | 文字 | 一律設為 Offer 。 |
price |
必要 | 數字 | 訂閱項目的價格。 |
priceCurrency |
必要 | 文字 | 價格的幣別 (使用三字母 ISO 4217 格式)。 |
seller |
建議 | 機構 | 提供訂閱方案或購買服務 動作。請使用 機構 (作者/出版商) 部分。 |
範例 1
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
範例 2
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/castlink?streamStationId=170",
"actionPlatform": [
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
}
],
"actionAccessibilityRequirement": [
{
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ActionAccessSpecification",
"category": "Subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://www.example.com/packages/basic-pack",
"name": "Basic Pack",
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 8.99,
"priceCurrency": "USD"
}
},
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
]
},
附錄
完整範例
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-09-10T13:58:26.892Z",
"dataFeedElement": [
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"url": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"description": "A two-time Peabody Award-winner...",
"alternativeHeadline": "Radiolab - Powered by WNYC",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2.jpg"
},
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
},
"keywords": [
"Science",
"Technology",
"Philosophy",
"Education"
],
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"inLanguage": "en",
"genre": [
"Science & Medicine",
"Natural Sciences"
],
"endDate": "2017-12-22T08:59:00",
"rssFeed": "http://feeds.wnyc.org/radiolab",
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.2
}
},
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastEpisode",
"@id": "http://www.tjpodcast.org/episode?id=1",
"url": "http://www.tjpodcast.org/episode?id=1",
"name": "A Clockwork Miracle",
"description": "As legend goes, in 1562, King Philip II...",
"sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
},
"keywords": [
"Education",
"Philosophy",
"Science",
],
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
},
"episodeNumber": 101,
"inLanguage": "en",
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"genre": [
"Science",
"Philosophy",
"Fiction"
],
"datePublished": "2018-12-27T23:23:00Z",
"timeRequired": "PT22M",
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT21M45S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.8
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "53ff386e-e768-40b5-8854-1b7415826ded"
}
]
}
],
"actor": [
{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language": "en",
"@value": "Roman Mars"
},
"roleName": "Host",
"sameAs": "https://en.wikipedia.org/wiki/Roman"
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name": {
"@language": "en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
}
}
],
"releasedEvent": [
{
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
}
]
}