本節提供 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。如需詳細資料和範例,請參閱「城市、州/省、國家/地區、AdministrativeArea」一節。 |
broadcastAffiliateOf |
Organization |
如適用,請務必提供:廣播電台所屬的聯盟,或提供廣播電台播送內容的聯盟。例如「NPR」、「PRI」或「PBS」。如果電台不屬於任何聯盟,則此屬性就不是必要屬性。如需詳細資訊和範例,請參閱「機構」一節。 |
broadcaster |
Organization |
必填:擁有、經營及營運電台的機構。如需詳細資訊和範例,請參閱「機構」一節。 |
parentService |
RadioBroadcastService |
適用時為必填:只有在無線電台是中繼器或轉譯器時,才需要這個屬性。代表中繼器或轉譯器轉播的原始電台。詳情和範例請參閱「RadioBroadcastService」一節。 |
potentialAction |
ListenAction |
必要:使用者觸發的動作,可收聽電台。詳情請參閱「ListenAction」一節。 |
popularityScore |
PopularityScoreSpecification |
強烈建議 原因 Google 會使用這項分數和其他信號,判斷要為使用者播放哪些媒體。這個分數代表目錄中內容的熱門程度。因此,動態饋給和目錄中的所有實體都必須使用一致的分數範圍。實體的熱門程度分數預設為 0。 |
inLanguage |
Text |
廣播電台播送內容的語言。這個值必須是 BCP 47 格式的語言代碼。使用這個值來滿足使用者查詢,要求以特定語言顯示內容。如果電台在不同時段以不同語言播報,請只列出主要語言。 |
keywords |
Text |
與電台相關的關鍵字清單。使用這些關鍵字擴大觸發電台的使用者查詢。例如「新聞」、「體育」或「搖滾」。 |
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 Radio 的可能值,「C8D8」則是 DAB 的可能值。 |
以下是 BroadcastFrequencySpecification 範例:
FM (HD)
"broadcastFrequency": {
"@type": "BroadcastFrequencySpecification",
"broadcastFrequencyValue": "89.3",
"broadcastSignalModulation": "FM",
"broadcastSubChannel": "HD1"
},
AM
"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 |
必填:機構的全域不重複 ID,採 URI 格式。這個 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 範例:
UNIVERSAL LOGO
"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)),則 ID 可由 identifier 屬性提供。這有助於 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"
}
},
城市、州/省、國家/地區、行政區
City、State、Country 和 AdministrativeArea 實體類型與 areaServed 屬性相關聯。
areaServed 屬性可協助您根據使用者的位置資訊,選取最合適的電台。位置資訊的例子包括使用者查詢,例如「附近的廣播電台」或「當地新聞廣播」。
| 屬性 | 預期類型 | 說明 |
|---|---|---|
@type |
Text |
必要:請務必將這項屬性設為下列其中一種實體類型:City、State、Country 或 AdministrativeArea。 |
name |
Text |
必要:城市、州/省、國家/地區或區域的名稱。請提供最精細的區域。並提供包含的鏈結。請使用下列格式:city, state, country。 |
以下是 areaServed 範例:
城市
"areaServed": {
"@type": "City",
"name": "North Highlands, CA, US"
},
STATE
"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 Basic」。 |
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 有關聯,因為 GQED 會播放 GPR 和 GPI 製作的部分內容。
- GQEI 由 GQED Inc 和 GPCB 擁有。這是 GQED 的中繼站/轉譯站,服務範圍不同。GQEI 也隸屬於 GPR 和 GPI。
- G-music 是 GRJ 擁有的國際電台,隸屬於 G-music 廣播網 (與電台同名,但為不同實體)。G-music 電台遍布全國,並播放 G-music 電台網製作的部分內容。
相關網頁
如要進一步瞭解本頁面所述屬性的相關主題,請參閱下列頁面: