Thuộc tính đánh dấu nội dung của đài phát thanh

Phần này cung cấp thông tin chi tiết về các thuộc tính đánh dấu nội dung cho loại thực thể RadioBroadcastService. Để biết toàn bộ thông tin chi tiết, hãy xem Ví dụ về nguồn cấp dữ liệu đầy đủ.

Bảng thông số kỹ thuật

Thuộc tính Loại dự kiến Mô tả
@context Text Bắt buộc: Luôn đặt thuộc tính này thành ["http://schema.googleapis.com", {"@language": "xx"}], trong đó xx biểu thị ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu.

Mỗi ngữ cảnh thực thể gốc phải đặt @language thành mã ngôn ngữ thích hợp và ở định dạng BCP 47. Ví dụ: nếu ngôn ngữ được đặt thành tiếng Tây Ban Nha, thì tên sẽ được giả định là tiếng Tây Ban Nha ngay cả khi phụ đề hoặc ngôn ngữ lồng tiếng là tiếng Anh.
@type Text Bắt buộc: Luôn đặt thuộc tính này thành RadioBroadcastService.
@id URL Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.
@id phải đáp ứng các yêu cầu sau:
  • Riêng biệt trên toàn bộ danh mục của bạn
  • Tĩnh; Mã này phải cố định và không thay đổi theo thời gian (ngay cả khi thuộc tính url của chương trình thay đổi). URL này sẽ được coi là một chuỗi mờ và không cần phải là một đường liên kết đang hoạt động.
  • Dưới dạng Giá trị nhận dạng tài nguyên hợp nhất (URI)
  • Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn.
url của một thực thể đáp ứng tất cả các yêu cầu đối với giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
url URL Bắt buộc: URL chính tắc của nội dung, cung cấp thông tin về đài phát thanh.

Thuộc tính url phải đáp ứng các yêu cầu sau:
  • Mã này phải là duy nhất trên toàn hệ thống.
  • Tệp này phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
  • Đường liên kết này phải trỏ đến một trang mô tả nội dung không bị tường phí chặn.
name Text Bắt buộc: Tên chính thức của đài phát thanh. Mỗi ngôn ngữ chỉ được có một tên chính thức. Ví dụ: "WXKS FM". Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Để biết ví dụ, hãy xem phần Nhiều khu vực và ngôn ngữ.
alternateName Text Tên thay thế giúp người dùng xác định đài phát thanh. Thuộc tính này phải là tên thay thế hợp lệ của một đài, chứ không phải từ khoá để ảnh hưởng đến việc kích hoạt. Đối với từ khoá, hãy sử dụng thuộc tính keywords. Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Để biết ví dụ, hãy xem phần Nhiều khu vực và ngôn ngữ.
callSign Text Bắt buộc nếu có: Ký hiệu gọi chính thức do chính phủ cấp cho đài phát thanh. Ví dụ: "KQEI-FM". Đối với các đài phát thanh ở Bắc Mỹ, bạn phải cung cấp thuộc tính này. Đối với những khu vực không thường sử dụng ký hiệu gọi, bạn không bắt buộc phải điền thông tin này.
broadcastDisplayName Text Bắt buộc: Tên hiển thị hoặc thương hiệu của đài phát thanh. Ví dụ: "Fake Radio 105". Các giá trị này giúp người dùng xác định đài phát thanh này trong truy vấn của họ, ngoài các thông tin chính khác như ký hiệu và tên.
description Text Bắt buộc: Nội dung mô tả ngắn về đài phát thanh. Thuộc tính này có giới hạn 300 ký tự. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Để biết ví dụ, hãy xem phần Nhiều khu vực và ngôn ngữ.
slogan Text Khẩu hiệu của đài phát thanh. Ví dụ: "Đài phát thanh nhạc hư cấu số một của Google".
logo ImageObject Hình ảnh biểu trưng của đài phát thanh. Cung cấp độ phân giải cao nhất có thể. Định dạng phải là JPEG hoặc PNG. Để biết thông tin chi tiết và ví dụ, hãy xem phần ImageObject.
broadcastFrequency BroadcastFrequencySpecification Bắt buộc: Thông số kỹ thuật về tần số của đài phát thanh. Đối với đài phát thanh AM/FM truyền thống, bạn phải cung cấp thuộc tính này. Đối với luồng chỉ trực tuyến, bạn phải đặt giá trị thành chuỗi INTERNET_STREAM. Để biết thông tin chi tiết và ví dụ, hãy xem phần BroadcastFrequencySpecification.
areaServed City, State, Country, or AdministrativeArea Bắt buộc: Khu vực địa lý chính mà đài phát thanh nhắm đến. Sử dụng thuộc tính này để chọn đài phù hợp nhất trong một mạng lưới các đài liên kết có tên tương tự. Ví dụ: sử dụng tính năng này để chọn một dịch vụ phát thanh được phát sóng trên toàn quốc với các đài liên kết tại địa phương. Định dạng đề xuất là city, (optional) state, country. Để biết thông tin chi tiết và ví dụ, hãy xem phần Thành phố, Tiểu bang, Quốc gia, Khu hành chính.
broadcastAffiliateOf Organization Bắt buộc nếu có: Đơn vị liên kết mà đài phát thanh là thành viên hoặc đơn vị liên kết cung cấp nội dung được phát sóng trên đài phát thanh. Ví dụ: "NPR", "PRI" hoặc "PBS". Nếu đài phát thanh không thuộc bất kỳ tổ chức liên kết nào, thì bạn không bắt buộc phải sử dụng thuộc tính này. Để biết thông tin chi tiết và ví dụ, hãy xem phần Tổ chức.
broadcaster Organization Bắt buộc: Tổ chức sở hữu, điều hành và vận hành đài phát thanh. Để biết thông tin chi tiết và ví dụ, hãy xem phần Tổ chức.
parentService RadioBroadcastService Bắt buộc nếu có: Thuộc tính này chỉ bắt buộc khi đài phát thanh là đài phát lại hoặc đài biên dịch. Biểu thị đài phát thanh gốc mà đài phát lại hoặc đài dịch chuyển tiếp. Để biết thông tin chi tiết và ví dụ, hãy xem phần RadioBroadcastService.
potentialAction ListenAction Bắt buộc: Hành động được kích hoạt cho người dùng để nghe đài phát thanh. Để biết thông tin chi tiết, hãy xem phần ListenAction.
popularityScore PopularityScoreSpecification Rất nên dùng Lý do? Điểm số mà Google sử dụng cùng với các tín hiệu khác để xác định nội dung nghe nhìn sẽ phát cho người dùng. Điểm số này thể hiện mức độ phổ biến của nội dung so với nội dung khác trong danh mục của bạn. Do đó, thang điểm phải nhất quán trên các nguồn cấp dữ liệu và tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm phổ biến của một thực thể được đặt thành 0.
inLanguage Text Ngôn ngữ của nội dung được phát sóng trên đài phát thanh. Giá trị phải là mã ngôn ngữ ở định dạng BCP 47. Sử dụng giá trị này để thực hiện các cụm từ tìm kiếm của người dùng yêu cầu nội dung bằng một ngôn ngữ cụ thể. Nếu đài phát sóng bằng nhiều ngôn ngữ vào các thời điểm khác nhau, bạn chỉ cần liệt kê ngôn ngữ chính.
keywords Text Danh sách từ khoá liên kết với đài phát thanh. Sử dụng các từ khoá này để mở rộng các cụm từ tìm kiếm của người dùng kích hoạt đài phát thanh. Ví dụ: "tin tức", "thể thao" hoặc "nhạc rock".
identifier PropertyValue Rất nên dùng Lý do? – Mã nhận dạng bên ngoài hoặc mã nhận dạng khác giúp xác định rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Để biết thông tin chi tiết, hãy xem phần Thuộc tính giá trị nhận dạng.
sameAs URL URL của một trang web tham khảo nêu rõ thông tin định danh của mặt hàng đó. Ví dụ: trang Wikipedia về dịch vụ truyền hình.

Tham chiếu thuộc tính loại thực thể

Sau đây là các loại thực thể và tham chiếu thuộc tính của các loại thực thể đó.

BroadcastFrequencySpecification

Loại thực thể BroadcastFrequencySpecification được liên kết với thuộc tính broadcastfrequency.

Loại thực thể BroadcastFrequencySpecification được dùng để xác định đài phát thanh theo tần số. Trong trường hợp đài phát thanh kỹ thuật số, kênh tần số có thể truyền nhiều kênh phụ với nhiều chương trình. Trong những trường hợp đó, giá trị broadcastSubChannel được dùng để xác định vị trí của đài phát thanh mục tiêu trong kênh tần số.

Đối với các đài phát thanh chỉ có trên Internet, bạn không cần đối tượng BroadcastFrequencySpecification, vì vậy, hãy sử dụng giá trị chuỗi INTERNET_STREAM.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành BroadcastFrequencySpecification.
broadcastFrequencyValue Text Bắt buộc: Phần chữ số của tần suất. Ví dụ: "89,3". Đối với các đài phát thanh kỹ thuật số (DAB), đây phải là số khối. Ví dụ: "12A".
broadcastSignalModulation Text Bắt buộc: Phần điều chế tín hiệu của tần số. Giá trị phải là một trong các giá trị sau: "FM", "AM", "HD", "DAB" hoặc "DAB+".
broadcastSubChannel Text Bắt buộc nếu có: Kênh phụ trong trường hợp đài phát thanh kỹ thuật số. Đối với đài DAB và DAB+, giá trị này là mã dịch vụ. Ví dụ: "HD1" –"HD8" là các giá trị có thể có cho đài phát thanh HD và "C8D8" là giá trị có thể có cho DAB.

Sau đây là ví dụ về BroadcastFrequencySpecification:

FM (HD)

"broadcastFrequency": {
  "@type": "BroadcastFrequencySpecification",
  "broadcastFrequencyValue": "89.3",
  "broadcastSignalModulation": "FM",
  "broadcastSubChannel": "HD1"
},

SA

"broadcastFrequency": {
  "@type": "BroadcastFrequencySpecification",
  "broadcastFrequencyValue": "1010",
  "broadcastSignalModulation": "AM",
},

DAB (Phát thanh kỹ thuật số)

"broadcastFrequency": {
  "@type": "BroadcastFrequencySpecification",
  "broadcastFrequencyValue": "12B",
  "broadcastSignalModulation": "DAB",
   "broadcastSubChannel": "C8D8"
},

Chỉ có thể truy cập Internet

"broadcastFrequency": "INTERNET_STREAM",

Tổ chức

Loại thực thể Organization được liên kết với các thuộc tính broadcaster hoặc broadcastAffiliateOf.

Trong thông số kỹ thuật RadioBroadcastService, loại Organization được dùng cho cả thuộc tính broadcasterbroadcastAffiliateOf.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành Organization.
@id URL Bắt buộc: Mã nhận dạng duy nhất trên toàn cầu cho tổ chức ở định dạng URI. Giá trị này cũng phải ổn định và không thay đổi theo thời gian. URL được coi là một chuỗi nguyên vẹn và không cần phải là một đường liên kết đang hoạt động.
name Text Bắt buộc: Tên của tổ chức.
sameAs URL Thuộc tính này là URL của một trang web tham khảo giúp xác định rõ ràng tổ chức đó. Ví dụ: trang Wikipedia về tổ chức đó hoặc trang web chính thức của tổ chức đó.

Sau đây là ví dụ về Organization:

SINGLE (Đĩa đơn)

"broadcaster": {
  "@type": "Organization",
  "@id": "https://www.tjradio.org/broadcasters/billyradio",
  "sameAs": "https://www.billyradio-example.org/",
  "name": "Billy Radio Inc"
},

NHIỀU CHỦ SỞ HỮU

"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",
  }
],

NHIỀU MẠNG

"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

Loại thực thể RadioBroadcastService được liên kết với thuộc tính parentService.

Thuộc tính parentService được dùng cho trạm lặp hoặc trạm dịch để cho biết trạm mẹ.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành RadioBroadcastService.
@id URL Bắt buộc: Mã nhận dạng duy nhất trên toàn cầu ở định dạng URL, đại diện cho đài phát thanh mẹ. Nếu đài phát thanh mẹ cũng có trong nguồn cấp dữ liệu của bạn dưới dạng một thực thể riêng biệt, hãy đảm bảo rằng cả hai mã nhận dạng đều giống nhau.
name Text Bắt buộc: Tên của đài phát thanh mẹ.
sameAs URL URL của một trang web tham chiếu giúp xác định rõ ràng đài mẹ. Ví dụ: trang Wikipedia cho đài mẹ.

Sau đây là ví dụ về RadioBroadcastService:

  "parentService": {
    "@type": "RadioBroadcastService",
    "@id": "https://www.tjradio.org/stations?id=10",
    "name": "GQED-FM",
    "sameAs": "https://en.vikibedia.org/wiki/GQED-FM"
  },

Loại thực thể ImageObject được liên kết với thuộc tính logo.

Thuộc tính logo dùng để cung cấp hình ảnh biểu trưng cho đài phát thanh đã cho. Những hình ảnh này xuất hiện cùng với nội dung dưới dạng đường liên kết sâu đến một thực thể đài phát thanh nhất định.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành ImageObject.
height Integer Chiều cao của hình ảnh tính bằng pixel.
width Integer Chiều rộng của hình ảnh tính bằng pixel.
contentUrl URL Bắt buộc: URL nơi có thể tìm nạp hình ảnh.
regionsAllowed Country Các quốc gia cho phép nội dung nghe nhìn đó. Nếu bạn không chỉ định thuộc tính này, thì hệ thống sẽ cho rằng hình ảnh được phép hiển thị ở tất cả các ngôn ngữ.

Để gửi nhiều hình ảnh cho mỗi khu vực, hãy thêm nhiều loại ImageObject, mỗi loại có một nhóm quốc gia riêng và một URL hình ảnh tương ứng.

Quốc gia

Loại thực thể Country được liên kết với thuộc tính logo.regionsAllowed.

Thuộc tính Loại dự kiến Mô tả
@type Text Luôn đặt thuộc tính này thành Country.
name Text ISO 3166-1 alpha-2. Ví dụ: "GB" hoặc "US".

Sau đây là ví dụ về ImageObject:

"logo": {
  "@type": "ImageObject",
  "height": 100,
  "width": 800,
  "contentUrl": "http://www.foo.com/img/67890.jpg",
},

BIỂU TƯỢNG THEO QUỐC GIA

"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

Loại thực thể PropertyValue được liên kết với thuộc tính identifier.

Nếu bạn sử dụng hệ thống mã nhận dạng của bên thứ ba cho nội dung của mình, chẳng hạn như mã nhận dạng của Gracenote (TMS), thì tài sản identifier có thể cung cấp mã nhận dạng đó. Điều này giúp cải thiện độ chính xác của việc Google điều chỉnh các đài phát thanh của bạn.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành PropertyValue.
propertyID Text Bắt buộc: Loại giấy tờ tuỳ thân được chỉ định. Chúng tôi hỗ trợ các loại mã nhận dạng sau:
  • TMS_ROOT_ID: Mã gốc của mã Gracenote (TMS). Ví dụ: "15829".
  • TMS_ID: Mã biến thể của mã Gracenote (TMS). Ví dụ: "MV000398520000".
  • WIKIDATA_ID: Mã WikiData. Ví dụ: "Q795598".
value Text URL của một trang web tham chiếu giúp xác định rõ ràng đài mẹ. Ví dụ: trang Wikipedia cho đài mẹ.

Sau đây là ví dụ về PropertyValue:

  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "WIKIDATA_ID",
    "value": "Q795598"
  },

PopularityScoreSpecification

Loại thực thể PopularityScoreSpecification được liên kết với thuộc tính popularityScore.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành PopularityScoreSpecification.
value Number Bắt buộc: Một giá trị số dương được so sánh với các thực thể khác trong danh mục của bạn. Số càng lớn thì mức độ phổ biến càng cao.
eligibleRegion Country Một quốc gia hoặc danh sách các khu vực áp dụng điểm số về mức độ phổ biến. Nếu điểm phổ biến áp dụng trên toàn cầu, bạn chỉ cần sử dụng earth làm giá trị văn bản.
Nếu cần liệt kê các khu vực cụ thể, hãy sử dụng loại Country.

Nếu bạn bỏ qua thuộc tính này, eligibleRegion sẽ mặc định là earth.

Quốc gia

Loại thực thể Country được liên kết với thuộc tính popularityScore.eligibleRegion.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành Country.
name Text Bắt buộc: ISO 3166-1 alpha-2. Ví dụ: "GB" hoặc "US".

Sau đây là ví dụ về PopularityScoreSpecification:

MỨC ĐỘ PHỔ BIẾN TRÊN TOÀN CẦU

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 4.3,
  "eligibleRegion": "Earth"
},

THEO QUỐC GIA

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 2,
  "eligibleRegion": {
    "@type": "Country",
    "name": "US"
  }
},

Thành phố, Tiểu bang, Quốc gia, Khu vực hành chính

Các loại thực thể City, State, CountryAdministrativeArea được liên kết với thuộc tính areaServed.

Thuộc tính areaServed giúp bạn chọn trạm sạc phù hợp nhất dựa trên thông tin vị trí của người dùng. Ví dụ về thông tin vị trí là các cụm từ tìm kiếm của người dùng như "một đài phát thanh gần tôi" hoặc "đài phát thanh tin tức địa phương".

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành một trong các loại thực thể sau: City,State, Country hoặc AdministrativeArea.
name Text Bắt buộc: Tên của thành phố, tiểu bang, quốc gia hoặc khu vực. Cung cấp khu vực chi tiết nhất. Ngoài ra, hãy cung cấp chuỗi chứa. Sử dụng định dạng sau: city, state, country.

Sau đây là ví dụ về areaServed:

CITY

"areaServed": {
  "@type": "City",
  "name": "North Highlands, CA, US"
},

STATE

"areaServed": [
  {
    "@type": "State",
    "name": "California, US"
  },
  {
    "@type": "State",
    "name": "Nevada, US"
  }
],

QUỐC GIA

"areaServed": [
  {
    "@type": "Country",
    "name": "US"
  },
  {
    "@type": "Country",
    "name": "Australia"
  }
],

ADMINISTRATIVEAREA

"areaServed": [
  {
    "@type": "AdministrativeArea",
    "name": "Cape Cod, Massachusetts, US"
  }
],

ListenAction

Loại thực thể ListenAction được liên kết với thuộc tính potentialAction.

Thuộc tính ListenAction xác định các đường liên kết sâu để phát. Tệp này cũng xác định tiêu chí để người dùng truy cập vào nội dung. Ví dụ: geo/chronal/login/subscription status.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành ListenAction.
target EntryPoint Bắt buộc: Thông số kỹ thuật của đường liên kết sâu. Tệp này bao gồm thông tin về nền tảng được hỗ trợ. Bạn có thể sử dụng nhiều loại thực thể EntryPoint để xác định các đường liên kết sâu khác nhau cho các nhóm nền tảng khác nhau.
actionAccessibilityRequirement ActionAccessSpecification Bắt buộc: Phần xác định các yêu cầu mà người dùng phải đáp ứng để truy cập vào thực thể này. Nếu có nhiều loại thực thể ActionAccessSpecification, thì người dùng phù hợp với bất kỳ tiêu chí nào nêu trong thông số kỹ thuật sẽ có thể truy cập nội dung.

EntryPoint

Loại thực thể EntryPoint được liên kết với thuộc tính potentialAction.target.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành EntryPoint.
urlTemplate Text Bắt buộc: Đường liên kết dùng để bắt đầu phát nội dung của bạn.
actionPlatform Text Bắt buộc: Các nền tảng nơi đường liên kết sâu hoạt động. Sau đây là các giá trị có thể có:
  • 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

Loại thực thể ActionAccessSpecification được liên kết với thuộc tính potentialAction.actionAccessibilityRequirement.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành ActionAccessSpecification.
category Text Bắt buộc: Loại yêu cầu về quyền truy cập. Thuộc tính này phải có một trong các giá trị sau:
  • nologinrequired: Người dùng có thể thực hiện thao tác này mà không cần phải mua hoặc đăng nhập để truy cập nội dung.
  • free: Người dùng có thể thực hiện thao tác này mà không cần mua sách hay mua gói thuê bao có tính phí. Người dùng vẫn phải đăng nhập để thực hiện hành động này.
  • subscription: Thao tác này được cung cấp trong gói thuê bao có tính phí đối với dịch vụ của bạn.
availabilityStarts DateTime Thời gian bắt đầu của khung thời gian được phép đọc. Sử dụng thuộc tính này để kiểm soát thời điểm chính xác khi người dùng có thể xem nội dung này.
availabilityEnds DateTime Thời gian kết thúc của khung thời gian được phép đọc. Sử dụng thuộc tính này để kiểm soát thời điểm chính xác khi người dùng không xem được nội dung này nữa.
eligibleRegion Country Quốc gia đủ điều kiện cho Offer. Sử dụng thuộc tính này để kiểm soát quốc gia hoặc khu vực mà bạn cung cấp hoặc không cung cấp nội dung này.
requiresSubscription MediaSubscription Gói thuê bao cần thiết để truy cập nội dung. Nếu dịch vụ của bạn cung cấp nhiều gói thuê bao, thì bạn phải sử dụng thuộc tính này. Nếu dịch vụ của bạn miễn phí hoặc chỉ có một cấp dịch vụ thuê bao, thì bạn có thể bỏ qua thuộc tính này.
Quốc gia

Loại thực thể Country được liên kết với thuộc tính potentialAction.actionAccessibilityRequirement.eligibleRegion.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành Country.
name Text Bắt buộc: Mã quốc gia theo chuẩn ISO 3166-1 alpha-2.
MediaSubscription

Loại thực thể MediaSubscription được liên kết với thuộc tính potentialAction.actionAccessibilityRequirement.requiresSubscription.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành MediaSubscription.
@id Text Bắt buộc: Mã nhận dạng duy nhất trên toàn cầu cho gói thuê bao ở định dạng URI. Giá trị này cũng phải ổn định và không thay đổi theo thời gian. URL được coi là một chuỗi nguyên vẹn và không cần phải là một đường liên kết đang hoạt động.
name Text Bắt buộc: Tên gói thuê bao. Ví dụ: "G-Radio Premium" hoặc "A-Radio Basic".
expectsAcceptanceOf Offer Loại Offer liên kết với giao dịch mua Gói thuê bao nội dung nghe nhìn. Thuộc tính này dùng để thể hiện giá của gói thuê bao.
Lời đề nghị

Loại thực thể Offer được liên kết với thuộc tính potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf.

Thuộc tính Loại dự kiến Mô tả
@type Text Bắt buộc: Luôn đặt thuộc tính này thành Offer.
price Number Bắt buộc: Giá của gói thuê bao.
priceCurrency Text Bắt buộc: Đơn vị tiền tệ của giá ở định dạng ISO 4217 gồm ba chữ cái.
seller Organization Tổ chức cung cấp gói thuê bao hoặc giao dịch mua hành động. Sử dụng cùng một giản đồ như mô tả trong phần Organization.

Sau đây là ví dụ về 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"
        }
    }
},

THEO NỀN TẢNG

"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"
            }
        }
    ]
},

Ví dụ về nguồn cấp dữ liệu đầy đủ

Trong ví dụ về nguồn cấp dữ liệu đầy đủ này, chúng tôi trình bày một nhà cung cấp dữ liệu đài phát thanh giả định: TJ_RADIO. TJ_RADIO cung cấp cho chúng tôi các hành động nghe đối với dữ liệu đài phát thanh, cùng với thông tin về mối liên kết và quyền sở hữu. Trong nguồn cấp dữ liệu này, 3 mạng phát thanh (cung cấp nội dung cho các đài liên kết) được trình bày là GPR, GRI và G-music. Ngoài ra, còn có 3 đài phát thanh: GQED, GQEI và G-music.

  • GQED thuộc sở hữu của GQED Inc và GPCB, hai tổ chức riêng biệt. Ngoài ra, GQED còn liên kết với GPR vì kênh này phát sóng một số nội dung do GPR và GPI tạo ra.
  • GQEI cũng thuộc sở hữu của GQED Inc và GPCB. Đây là trạm lặp/biên dịch của GQED, phục vụ một khu vực khác. GQEI cũng liên kết với GPR và GPI.
  • G-music là một đài quốc tế thuộc sở hữu của GRJ và liên kết với mạng đài G-music (một pháp nhân khác có cùng tên với đài). Các đài G-music có mặt trên toàn quốc và phát sóng một số nội dung do mạng phát thanh G-music tạo ra.

Hãy xem các trang sau để biết thêm thông tin về các chủ đề liên quan đến các thuộc tính được mô tả trên trang này: