本節提供 RadioBroadcastService
實體類型的內容標記屬性詳細資料。如需完整詳細資料,請參閱完整的動態饋給範例。
規格表
屬性 | 預期類型 | 說明 |
---|---|---|
@context |
Text |
必要:一律將這項屬性設為 ["http://schema.googleapis.com", {"@language": "xx"}] ,其中 xx 代表動態饋給中字串的語言。每個根實體的 @language 都必須設為適當的語言代碼,且採用 BCP 47 格式。舉例來說,如果語言是西班牙文,系統則會假設使用者使用的語言為西班牙文,即使字幕語言是英文也一樣。 |
@type |
Text |
必要:一律將這個屬性設為 RadioBroadcastService 。 |
@id |
URL |
必要 - URI 格式的內容 ID,例如 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 字串。如需詳細資訊和範例,請參閱 BroadcastfrequencySpec 一節。 |
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 |
與廣播電台相關聯的關鍵字清單。使用這些關鍵字可擴大觸發廣播電台的使用者查詢。例如「quot;news」、「"sports」、「"」或「quoock;rock」。 |
identifier |
PropertyValue |
強烈建議使用原因- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱 ID 屬性一節。 |
sameAs |
URL |
可明確識別項目識別資訊的參考網頁網址。例如廣播服務的維基百科頁面。 |
實體類型屬性參考資料
以下是實體類型及其屬性的參照。
Broadcastfrequency 規格
BroadcastFrequencySpecification
實體類型與 broadcastfrequency
屬性相關聯。
BroadcastFrequencySpecification
實體類型是用於按頻率識別廣播電台。以數位電台來說,頻率頻道可能會有多個子頻道,且每個頻道皆有不同節目。在這種情況下,系統會使用 broadcastSubChannel
值找出頻率管道中的目標廣播電台。
如果是僅限網際網路的廣播電台,則不需要 BroadcastFrequencySpecification
物件,請改用字串值 INTERNET_STREAM
。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 BroadcastFrequencySpecification 。 |
broadcastFrequencyValue |
Text |
必填:頻率的數值部分。例如「89.3.」。如果是數位音訊廣播 (DAB) 電台,必須是區塊號碼。例如「12A.」 |
broadcastSignalModulation |
Text |
必填:頻率信號的信號部分。這個值必須是「FM」、「AM」、「HD」、「DAB」或「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
實體類型與 parentService
屬性相關聯。
parentService
屬性用於中繼器或翻譯器車站,用來表示其母車站。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 RadioBroadcastService 。 |
@id |
URL |
必要:全球母帶 ID 的全域專屬 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
屬性相關聯。
如果您的內容 (例如 Gracenote ID (TMS)) 使用第三方 ID 系統,則可透過 identifier
屬性提供 ID。這有助於提高 Google 對電台的對帳準確度。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 PropertyValue 。 |
propertyID |
Text |
必要:指定 ID 的類型。我們支援下列 ID 類型:
|
value |
Text |
可明確識別母車站的參考網頁網址。例如,母車站的維基百科頁面。 |
以下是 PropertyValue
範例:
"identifier": {
"@type": "PropertyValue",
"propertyID": "WIKIDATA_ID",
"value": "Q795598"
},
熱門分數規格
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"
},
狀態
"areaServed": [
{
"@type": "State",
"name": "California, US"
},
{
"@type": "State",
"name": "Nevada, US"
}
],
國家/地區
"areaServed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "Australia"
}
],
行政區
"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
實體類型與 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
實體類型與 potentialAction.actionAccessibilityRequirement.requiresSubscription
屬性相關聯。
屬性 | 預期類型 | 說明 |
---|---|---|
@type |
Text |
必要:一律將這個屬性設為 MediaSubscription 。 |
@id |
Text |
必要:訂閱套件的全域唯一識別碼,採 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 |
必填:價格三個字母 (以 3 個字母組成的 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 音樂電台遍及全國,且廣播了一些來自廣播網路 G 音樂的內容。
相關網頁
如要進一步瞭解與本頁所述屬性相關的主題,請參閱以下頁面: