廣播電台的內容標記屬性

本節提供 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必須符合下列規定：
  • 目錄中的全域唯一項目
  • 靜態；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 字串。如需詳細資訊和範例，請參閱 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 實體類型與 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 類型：
  • 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 實體類型與 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 必要：深層連結適用的平台。可能的值如下：
  • 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 實體類型與 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 實體類型與 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 音樂的內容。

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