本節提供
RadioBroadcastService
實體類型。如需完整詳細資料,請參閱
完整動態饋給範例:
規格表
屬性 | 預期類型 | 說明 |
---|---|---|
@context |
Text |
必要:一律將這個屬性設為 ["http://schema.googleapis.com", {"@language": "xx"}] ,其中 xx 代表動態饋給中的字串語言。每個根實體內容都必須將 @language 設為適當的語言代碼,且採用 BCP 47 格式。舉例來說,如果將語言設為西班牙文,即使字幕或配音語言是英文,系統也會假設名稱是以西班牙文顯示。 |
@type |
Text |
必要:一律將這個屬性設為 RadioBroadcastService 。 |
@id |
URL |
必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc。@id 必須符合下列規定:
url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id 。詳情請參閱「ID」一節。 |
url |
URL |
必要:內容的標準網址,用於提供廣播電台的相關資訊。url 屬性必須符合下列規定:
|
name |
Text |
必填:廣播電台的官方名稱。每種語言只能有一個正式名稱。例如「WXKS FM」。使用陣列列出不同語言的名稱。如需範例,請參閱「多個區域和語言」。 |
alternateName |
Text |
可協助使用者識別廣播電台的備用名稱。這個屬性必須是車站的合法別名,而不是影響觸發關鍵字的關鍵字。如果是關鍵字,請改用 keywords 屬性。使用陣列列出不同語言的名稱。如需範例,請參閱「多個區域和語言」。 |
callSign |
Text |
必填 (如適用):官方政府核發的廣播電台呼號。例如「KQEI-FM」。北美廣播電台必須為這個屬性。針對不常使用呼號的區域,不一定要設定。 |
broadcastDisplayName |
Text |
必填:廣播電台的顯示名稱或品牌。例如「Fake Radio 105」。這些值可協助使用者在查詢中辨識這個廣播電台,以及呼號和名稱等其他重要資訊。 |
description |
Text |
必填:提供廣播電台的簡短說明。這項資源的長度上限為 300 個半形字元。使用陣列標記多種語言的說明。如需範例,請參閱「多個區域和語言」。 |
slogan |
Text |
廣播電台的口號。例如「Google 首屈一指的虛構音樂電台」。 |
logo |
ImageObject |
充電站的標誌圖片。提供可用的最高解析度。格式必須是 JPEG 或 PNG。如需詳細資訊和範例,請參閱 ImageObject 一節。 |
broadcastFrequency |
BroadcastFrequencySpecification |
必填:廣播電台的頻率規格。針對地面 AM/FM 廣播電台,這個屬性為必要項目。如果是僅限線上的串流,值必須設為 INTERNET_STREAM 字串。如需詳細資料和範例,請參閱 BroadcastFrequencySpecification 一節。 |
areaServed |
City, State, Country, or AdministrativeArea |
必填:廣播電台指定的主要地理區域。使用此屬性在聯名及相似名稱的電台網路中選取最適合的電台。舉例來說,您可以利用這個工具選取在全國各地播出的廣播電台服務。建議格式為 city, (optional) state, country。如需詳細資料和範例,請參閱城市、州/省、國家/地區、行政區一節。 |
broadcastAffiliateOf |
Organization |
適用情況:廣播電台所屬的聯盟頻道,或是提供電台廣播內容的聯盟頻道。例如「NPR」「PRI」、或「PBS」。如果廣播電台不屬於任何聯盟關係,則不必加入這個屬性。如需詳細資料和範例,請參閱「機構」一節。 |
broadcaster |
Organization |
必填:擁有、執行和經營廣播電台的機構。如需詳細資料和範例,請參閱「機構」一節。 |
parentService |
RadioBroadcastService |
如適用:只有在廣播電台是重複員或譯者時,才需要使用這項屬性。代表重製者或翻譯業者的原始電台。如需詳細資訊和範例,請參閱 RadioBroadcastService 一節。 |
potentialAction |
ListenAction |
必要:為使用者收聽廣播電台而觸發的動作。詳情請參閱「ListenAction」一節。 |
popularityScore |
PopularityScoreSpecification |
強烈建議原因Google 運用分數和其他信號來判斷要向使用者顯示的媒體。這項分數代表和你的目錄中其他內容相比,該內容的熱門程度。因此,整體動態饋給和目錄中所有實體都必須一致。根據預設,實體的熱門程度分數會設為 0 。 |
inLanguage |
Text |
在廣播電台上播送的內容語言。這個值必須是 BCP 47 格式的語言代碼。此值可用來執行要求特定語言內容的使用者查詢。如果電視台在不同時間播送不同語言的內容,只需列出主要語言即可。 |
keywords |
Text |
與廣播電台相關的關鍵字清單。使用這些關鍵字來擴大觸發廣播電台的使用者查詢。例如「news」「運動」或「搖滾」。 |
identifier |
PropertyValue |
強烈建議原因- 可明確識別這個實體的外部 ID 或其他 ID。你可以使用多個 ID。詳情請參閱「ID 屬性」一節。 |
sameAs |
URL |
可明確識別項目身分的參照網頁網址。例如廣播服務的維基百科頁面。 |
實體類型屬性參照
以下是實體類型及其屬性參照。
BroadcastFrequencySpecification
BroadcastFrequencySpecification
實體類型與
broadcastfrequency
屬性。
BroadcastFrequencySpecification
實體類型用來識別無線電
控制電台的方式以數位電台來說
可以提供多個採用不同節目的子頻道在這種情況下
broadcastSubChannel
值可用來在以下範圍內尋找目標廣播電台:
展示頻率管道
如果是僅限網際網路的廣播電台,BroadcastFrequencySpecification
物件
不需要,因此請改用字串值 INTERNET_STREAM
。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 BroadcastFrequencySpecification 。 |
broadcastFrequencyValue |
Text |
必填:頻率的數字部分。例如「89.3」。如果是數位音訊廣播 (DAB) 電台,這個值必須是區塊號碼。例如「12A」。 |
broadcastSignalModulation |
Text |
必填:頻率的信號調節部分。值須為「FM」、「AM」、「HD」或「DAB」或「DAB+」 |
broadcastSubChannel |
Text |
如適用:數位電台時的子頻道。如果是 DAB 和 DAB+ 站點,這個值會是服務 ID。例如「HD1」-「HD8」HD 高畫質無線電和「C8D8」的可能值即為 DAB 的可能值。 |
以下是 BroadcastFrequencySpecification
範例:
FM (HD)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
上午
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "1010",
"broadcastSignalModulation": "AM",
},
DAB
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "12B",
"broadcastSignalModulation": "DAB",
"broadcastSubChannel": "C8D8"
},
僅限網際網路
"broadcastFrequency": "INTERNET_STREAM",
機構
Organization
實體類型與 broadcaster
或
broadcastAffiliateOf
屬性。
在 RadioBroadcastService
規格中,使用的是 Organization
類型
broadcaster
和 broadcastAffiliateOf
資源都適用
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 Organization 。 |
@id |
URL |
必要: URI 格式的機構的全域專屬 ID。這個 ID 應固定,不會隨著時間而改變。系統會將其視為不透明字串,且不一定要是有效連結。 |
name |
Text |
必填:機構名稱。 |
sameAs |
URL |
這個資源是可明確識別機構組織的參照網頁網址。例如該機構的維基百科頁面或該機構的官方網站。 |
以下是 Organization
範例:
單曲
"broadcaster": {
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio",
"sameAs": "https://www.billyradio-example.org/",
"name": "Billy Radio Inc"
},
多個擁有者
"broadcaster": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/billyradio"
"name": "Billy Radio Inc"
"sameAs": "https://www.billyradio-example.org/"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/broadcasters/Gmusic"
"name": "Gmusic",
}
],
多個網路
"broadcastAffiliateOf": [
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/npr",
"name": "NPR",
"sameAs": "https://en.wikipedia.org/wiki/NPR"
},
{
"@type": "Organization",
"@id": "https://www.tjradio.org/networks/pri",
"name": "PRI",
"sameAs": "https://www.pri.org/"
}
],
RadioBroadcastService
RadioBroadcastService
實體類型與 parentService
相關聯
資源。
parentService
屬性用於中繼器或翻譯站
表示其母車站。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 RadioBroadcastService 。 |
@id |
URL |
必填:全域不重複 ID,採用代表母廣播電台的網址格式。如果動態饋給中的母廣播電台也做為獨立實體納入,請確認這兩個 ID 相同。 |
name |
Text |
必填:母廣播電台的名稱。 |
sameAs |
URL |
可明確識別母車站的參照網頁網址。例如母車站的維基百科網頁。 |
以下是 RadioBroadcastService
範例:
"parentService": {
"@type": "RadioBroadcastService",
"@id": "https://www.tjradio.org/stations?id=10",
"name": "GQED-FM",
"sameAs": "https://en.vikibedia.org/wiki/GQED-FM"
},
ImageObject
ImageObject
實體類型與 logo
屬性相關聯。
logo
屬性是用來提供指定廣播電台的標誌圖片。這些圖片會與特定無線電實體的深層連結一併顯示。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 ImageObject 。 |
height |
Integer |
圖片的高度 (以像素為單位)。 |
width |
Integer |
圖片寬度 (以像素為單位)。 |
contentUrl |
URL |
必要:可擷取圖片的網址。 |
regionsAllowed |
Country |
允許播放媒體內容的國家/地區。如未指定,系統會假設圖片可在所有語言代碼中顯示。 如要為每個區域提交不同的圖片,請新增多個 ImageObject 類型,每種類型都有自己適用的國家/地區組合和對應的圖片網址。 |
國家/地區
Country
實體類型與 logo.regionsAllowed
屬性相關聯。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
這個屬性一律設為 Country 。 |
name |
Text |
ISO 3166-1 alpha-2。例如「GB」或「US」。 |
以下是ImageObject
範例:
通用標誌
"logo": {
"@type": "ImageObject",
"height": 100,
"width": 800,
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
各國家/地區的標誌
"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
PropertyValue
實體類型與 identifier
屬性相關聯。
如果您的內容採用第三方 ID 系統 (例如 Gracenote ID),
(TMS) 的情況下,可透過 identifier
屬性提供 ID。這可以
Google 和您廣播電台的對帳資料準確性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 PropertyValue 。 |
propertyID |
Text |
必要:指定 ID 的類型。我們支援下列 ID 類型:
|
value |
Text |
可明確識別母車站的參照網頁網址。例如母車站的維基百科網頁。 |
以下是 PropertyValue
範例:
"identifier": {
"@type": "PropertyValue",
"propertyID": "WIKIDATA_ID",
"value": "Q795598"
},
PopularityScoreSpecification
PopularityScoreSpecification
實體類型與
popularityScore
屬性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 PopularityScoreSpecification 。 |
value |
Number |
必填:與目錄中其他實體比較的正數值。數字越大,表示熱門程度越高。 |
eligibleRegion |
Country |
適用熱門程度分數的國家/地區或地區清單。如果熱門程度分數適用於全球適用,請直接使用 earth 做為文字值。如需列出特定地區,請使用 Country 類型。如果未提供這項資源, eligibleRegion 的預設值為 earth 。 |
國家/地區
Country
實體類型與
popularityScore.eligibleRegion
屬性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 Country 。 |
name |
Text |
必要:ISO 3166-1 alpha-2。例如「GB」或「US」。 |
以下是 PopularityScoreSpecification
範例:
全球熱門
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
國家/地區專屬
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
城市、州、國家/地區、AdministrativeArea
City
、State
、Country
和 AdministrativeArea
實體類型為
與 areaServed
屬性建立關聯
areaServed
屬性可協助您根據
使用者的位置資訊。位置資訊的例子包括使用者
,例如「附近的廣播電台」或「地方新聞電台」
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:請務必將這個屬性一律設為下列任一實體類型:City 、State 、Country 或 AdministrativeArea 。 |
name |
Text |
必填:城市、州/省、國家/地區或區域的名稱。提供最精細的區域。此外,請提供內含鏈結。格式如下:city, state, country。 |
以下是 areaServed
範例:
CITY
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
州/省
"areaServed": [
{
"@type": "State",
"name": "California, US"
},
{
"@type": "State",
"name": "Nevada, US"
}
],
國家/地區
"areaServed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "Australia"
}
],
ADMINISTRATIVEAREA
"areaServed": [
{
"@type": "AdministrativeArea",
"name": "Cape Cod, Massachusetts, US"
}
],
ListenAction
ListenAction
實體類型與 potentialAction
屬性相關聯。
ListenAction
屬性會定義要播放的深層連結。此外,這項作業也會定義
使用者存取內容的條件例如 geo/chronal/login/subscription status
。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 ListenAction 。 |
target |
EntryPoint |
必要:深層連結的規格。其中包含支援的平台資訊。您可以使用多種 EntryPoint 實體類型,為不同平台集定義不同的深層連結。 |
actionAccessibilityRequirement |
ActionAccessSpecification |
必要:定義這個實體的使用者相關規定。如果存在多種 ActionAccessSpecification 實體類型,則符合「任何」規格條件的使用者可以存取內容。 |
EntryPoint
EntryPoint
實體類型與 potentialAction.target
相關聯
資源。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 EntryPoint 。 |
urlTemplate |
Text |
必要:用來啟動播放內容的連結。 |
actionPlatform |
Text |
必填:深層連結適用的平台。以下是可能的值:
|
ActionAccessSpecification
ActionAccessSpecification
實體類型與
potentialAction.actionAccessibilityRequirement
屬性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 ActionAccessSpecification 。 |
category |
Text |
必填:存取權的類型。必須是下列其中一個值:
|
availabilityStarts |
DateTime |
供應期間的開始時間。使用這個屬性控制使用者可存取內容的確切時間。 |
availabilityEnds |
DateTime |
供應期間的結束時間。這項屬性可用來控制使用者無法再使用這項內容的確切時間。 |
eligibleRegion |
Country |
適用 Offer 的國家/地區。你可以使用這項屬性來控制這項內容的適用國家/地區或區域。 |
requiresSubscription |
MediaSubscription |
存取內容所需的訂閱套件。如果您的服務提供多個訂閱套裝方案,就必須提供這項屬性。如果您的服務免費,或是只有單一層級的訂閱服務,則可略過這項資源。 |
國家/地區
Country
實體類型與
potentialAction.actionAccessibilityRequirement.eligibleRegion
屬性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 Country 。 |
name |
Text |
必填:ISO 3166-1 alpha-2 國家/地區代碼。 |
MediaSubscription
MediaSubscription
實體類型與
potentialAction.actionAccessibilityRequirement.requiresSubscription
屬性。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 MediaSubscription 。 |
@id |
Text |
必填:訂閱項目套件的全域專屬 ID,採 URI 格式。這個 ID 應固定,不會隨著時間而改變。系統會將其視為不透明字串,且不一定要是有效連結。 |
name |
Text |
必填:訂閱項目套件的名稱。例如「G-Radio Premium」或「基本版 A-Radio 基本版」 |
expectsAcceptanceOf |
Offer |
與購買媒體訂閱項目相關的 Offer 類型。這個屬性用來表示訂閱項目的價格。 |
優惠
Offer
實體類型與
potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf
資源。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 Offer 。 |
price |
Number |
必填:訂閱項目的價格, |
priceCurrency |
Text |
必填:價格幣別,採用三字母 ISO 4217 格式。 |
seller |
Organization |
提供訂閱或購買動作的機構。請使用 Organization 一節中說明的結構定義。 |
以下是 ListenAction
範例:
通用深層連結
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.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"
}
}
},
平台專屬
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjradio.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.tjradio.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": "G-Radio 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"
}
}
]
},
完整動態饋給範例
以這個完整動態饋給範例,我們提出假設的無線電資料供應商:TJ_RADIO。 TJ_RADIO 會提供電台資料的收聽動作,以及聯盟和擁有權資訊。 在這個動態饋給中,3 個電台 (提供內容給聯盟電台) 會以 GPR、GRI 和 G-music 的形式呈現。 還提供 3 個廣播電台:GQED、GQEI 和 G-music。
- GQED 為 GQED Inc 和 GPCB 所有,這兩個機構各自獨立。此外,GQED 與 GPR 相關,因為這項服務會播送 GPR 和 GPI 製作的部分內容。
- GQEI 也屬於 GQED Inc,以及 GPCB。這是 GQED 的中繼器/翻譯站,服務範圍是其他區域。GQEI 也與 GPR 和 GPI 相關。
- G-music 是國際電台,由 GRJ 擁有,並隸屬於「G-music」(名稱與電台相同的不同實體)。全球音樂電台遍布整個國家/地區,並播送 G-music 廣播聯播網創作的部分內容。
相關網頁
如要進一步瞭解房源相關主題,請參閱下列網頁 中所述內容: