廣播電台的內容標記屬性

本節提供 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 屬性必須符合下列規定：
  • 不得重複。
  • 必須包含 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。如需詳細資料和範例，請參閱「城市、州/省、國家/地區、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 實體類型與 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))，則 ID 可由 identifier 屬性提供。這有助於 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"
  }
},

城市、州/省、國家/地區、行政區

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 必要：深層連結適用的平台。可能的值如下：
  • 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 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 電台網製作的部分內容。

如要進一步瞭解本頁面所述屬性的相關主題，請參閱下列頁面：