廣播電台的內容標記屬性

本節提供 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 必須符合下列規定:
  • 產品目錄全球不重複
  • 靜態;這個 ID 應固定,不會隨時間而改變 (即使節目的網址資源有所變更),系統會視為不透明字串,且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url URL 必要:內容的標準網址,用於提供廣播電台的相關資訊。

url 屬性必須符合下列規定:
  • 此 ID 在全域範圍內不得重複。
  • 且必須包含 Google 可檢索的實際標準網址。
  • 網址必須指向未遭到付費牆封鎖的內容說明頁面。
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 實體類型與 broadcasterbroadcastAffiliateOf 屬性。

RadioBroadcastService 規格中,使用的是 Organization 類型 broadcasterbroadcastAffiliateOf 資源都適用

屬性 預期類型 說明
@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 實體類型與 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 類型:
  • TMS_ROOT_ID:Gracenote ID (TMS) 根 ID。例如「15829」。
  • TMS_ID:Gracenote ID (TMS) 變化版本 ID。例如「MV000398520000」。
  • WIKIDATA_ID:WikiData ID。例如「Q795598」。
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

CityStateCountryAdministrativeArea 實體類型為 與 areaServed 屬性建立關聯

areaServed 屬性可協助您根據 使用者的位置資訊。位置資訊的例子包括使用者 ,例如「附近的廣播電台」或「地方新聞電台」

屬性 預期類型 說明
@type Text 必要:請務必將這個屬性一律設為下列任一實體類型:CityStateCountryAdministrativeArea
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 必填:深層連結適用的平台。以下是可能的值:
  • 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

ActionAccessSpecification 實體類型與 potentialAction.actionAccessibilityRequirement 屬性。

屬性 預期類型 說明
@type Text 必要:一律將這個屬性設為 ActionAccessSpecification
category Text 必填:存取權的類型。必須是下列其中一個值:
  • nologinrequired:使用者無須購買或登入即可存取內容。
  • free:使用者無須購買或付費訂閱,即可執行這項操作。這項操作仍會要求使用者登入。
  • subscription:服務須付費訂閱才能使用。
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 廣播聯播網創作的部分內容。

如要進一步瞭解房源相關主題,請參閱下列網頁 中所述內容: