Podcast Schema.org 規格

本節提供 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 選用

ImageObject

repeated

系列叢書的標誌圖片。提供這項資訊完整說明 ImageObject。提供可用的最高解析度。JPEG 或 PNG 建議採用。如需詳細資訊和範例,請參閱 ImageObject (logo) 區段。
image 必要

ImageObject

repeated

系列叢書的圖片。提供完整說明 ImageObject。提供可用的最高解析度。JPEG 或 PNG 為 詳情請參閱「ImageObject (logo)」一節。 範例。
isFamilyFriendly 必要 布林值 指出內容是否闔家皆宜 (即是否適合闔家觀賞) 適合全家大小,包含兒童)。Google 產品 可能會使用 isFamilyFriendly 來決定要播放的內容。 值必須是 truefalse
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 或更具體的子類型:FeaturedEventExclusiveEvent 標示 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 選用

ImageObject

repeated

系列叢書的圖片。這必須是完整的說明 ImageObject。提供可用的最高解析度。JPEG 或 PNG 建議採用。請參閱 ImageObject (logo) 部分 詳細資料和範例
isFamilyFriendly 必要 布林值 指出內容是否闔家皆宜 (也就是說, 內容適合所有家庭成員,包括兒童)。Google 敬上 產品可能會使用 isFamilyFriendly 決定要播放的內容。 值必須是 truefalse
inLanguage 必要 文字 Podcast 單集節目的內容語言,採用 ISO 639-1 格式。使用這份草稿 值來執行要求特定語言內容的使用者查詢。如果 內容有多種語言版本,請只列出一種主要語言。
genre 必要

文字

repeated

Podcast 系列的類別或類型。例如追蹤標準 Podcast 類別
associatedMedia 選用 AudioObject Podcast 單集節目的音訊檔案。如需詳細資訊和範例,請參閱 AudioObject(associatedMedia)
potentialAction 必要 ListenAction 要觸發的動作,讓使用者能聆聽內容。詳情 請參閱「ListenAction」一節。
popularityScore 選用 PopularityScoreSpecification 有多個熱門關鍵字時,用來決定放送優先順序的熱門程度分數 候選檔案。如需詳細資訊和範例,請參閱 popityScoreSpecification 區段。
keywords 選用

文字

repeated

與 Podcast 系列相關的關鍵字清單。這些關鍵字可能以 用於擴充可觸發這個 Podcast 單集節目的使用者查詢。適用對象 例如 newssportshistory
identifier 必要

PropertyValue

repeated

如果是 PodcastEpisode,請使用這個屬性提供 GUID。 GUID 必須是一組可用來識別 Podcast 的全域 ID 集數。與單集節目的「@id」欄位不同。

請參閱 PropertyValue (identifier) 部分以瞭解 範例。

sameAs 選用 網址 第三方 (不在您的網域內) 參照的網頁 明確指出項目的身分。Google 會將這個網頁用於 有多個類似系列時,會發出混淆。舉例來說,維基百科 或 Podcast 單集節目首頁請注意,系列叢書層級參考資料 亦不得在此提供頁面。我們強烈建議您 單集節目的混淆。
releasedEvent 選用 PublicationEvent 等更具體的子類型: FeaturedEventFeaturedEvent 標記 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 必要 文字 一律設為 OrganizationPerson
@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 必要 文字 一律設為 OrganizationPerson
@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

允許播放媒體內容的國家/地區:

  • 如果未指定,則系統會假設映像檔適用於所有 語言代碼。
  • 如要分別為每個區域提交不同的圖片,請新增多張 ImageObject 屬性,各有一組自己的國家/地區及 對應的圖片網址

國家/地區 (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

適用此熱門程度分數的一或多個地區清單。

如果熱門程度分數適用於全球,文字請使用 earth 值。

如需列出特定區域,請使用「Country」類型。

如果未填寫這個欄位,eligibleRegion 會預設為 earth

國家/地區 (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 的其中一個值, ExclusiveEventFeaturedEvent
location 必要 國家/地區 發布事件的區域。您還可以使用 表示專屬限制和發行限制 專屬實體。請使用 ISO 3166 代碼指定國家/地區。如需 設為 EARTH已明確設定 locationEARTH (適用於特定語言) 這些限制不適用。
startDate 建議 (for ExclusiveEvent) 日期或日期時間 實體的開始日期出版品如果選擇 PublicationEvent,表示應用程式的初始發布日期 這個實體情況下為 ExclusiveEventFeaturedEvent,代表 實體的獨佔性或主打性。
endDate 建議 (for ExclusiveEvent) 日期或日期時間 實體的發布日期。如果選擇 PublicationEvent,代表最終發布日期 。情況下為 ExclusiveEventFeaturedEvent,代表 實體的獨佔性或主打性。
publishedBy 必要 機構或個人 OrganizationPerson 實體, 此實體將發布並套用至這個出版品活動。請使用 與 機構 (作者/出版商) 部分。

範例 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 必要

EntryPoint

repeated

深層連結搭配支援的平台規格 可能不準確或不適當您可以使用多個 EntryPoint 欄位 為不同的平台組合定義不同的深層連結。
actionAccessibilityRequirement 必要

ActionAccessSpecification

repeated

定義使用者必須符合怎樣的條件才能存取這個實體。如有多個 「ActionAccessSpecification」會顯示,而使用者只要符合以下任一項目 符合規範可存取的內容

EntryPoint (potentialAction.target)

table class="fixed"> 屬性 優先順序 類型 說明 @type 必填 文字 一律設為 EntryPointurlTemplate 必要 網址 用來播放內容的連結。 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 必要 文字

存取權需求類型。必須是下列其中一項 值:

  • nologinrequired:使用者可執行這項動作 無須購買或登入即可存取內容
  • free:這個動作無須購買或 須付費訂閱。這項操作需要 使用者登入。
  • subscription:付費活動已納入 訂閱服務。
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 必要 文字 訂閱項目套件名稱的名稱。例如: PremiumBasic
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"
            }
        }
    ]
}