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 podcast.
Quy cách của Podcast Series
PodcastSeries
là đại diện cho một loạt podcast, cũng là
được gọi là "chương trình" podcast.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@context |
Bắt buộc | Văn bản | Ngữ cảnh schema.org. Luôn đặt thành
[http://schema.googleapis.com,{@language}:xx}] , nơi
xx phải bằng mã ngôn ngữ. Thao tác này sẽ đặt ngôn ngữ mặc định
được dùng cho các giá trị văn bản trong thực thể. |
@type |
Bắt buộc | Văn bản | Luôn đặt thành PodcastSeries . |
@id |
Bắt buộc | Văn bản | Mã nhận dạng duy nhất trên toàn cầu cho loạt podcast ở định dạng URI. Mã nhận dạng phải là
ổn định và không thay đổi theo thời gian. Nó được coi là một chuỗi mờ và không
phải là đường liên kết đang hoạt động. Miền dùng cho giá trị @id phải
thuộc sở hữu của tổ chức của bạn.
|
url |
Bắt buộc | Văn bản | URL chính tắc trên trang web giới thiệu loạt podcast, hoặc
được mô tả. Mã này phải là duy nhất trên toàn hệ thống. Liên kết này giúp
đối chiếu nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google. Cho
chế độ phát, hãy sử dụng target.urlTemplate đã nêu chi tiết trong phần ListenAction của tài liệu. |
name |
Bắt buộc | Văn bản | Tên của loạt podcast. Chỉ thêm một tên cho mỗi ngôn ngữ. Dùng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Hãy xem cột Nhiều ví dụ về khu vực và ngôn ngữ. |
description |
Bắt buộc | Văn bản | Bản tóm tắt loạt podcast. Dùng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Xem Ví dụ về nhiều khu vực và ngôn ngữ. |
alternativeHeadline |
Không bắt buộc | Văn bản | Phụ đề của loạt podcast. |
author |
Bắt buộc | lặp lại |
Người hoặc nhóm phát triển hoặc phân phối chương trình. Thường đề cập đến máy chủ lưu trữ. Để biết ví dụ và thông tin chi tiết, hãy xem phần Tổ chức, Cá nhân (tác giả/nhà xuất bản). |
publisher |
Không bắt buộc | lặp lại |
Nhóm hoặc mạng ban đầu chịu trách nhiệm xuất bản chương trình. Thường xuyên đề cập đến một tổ chức chịu trách nhiệm xuất bản/sản xuất một số podcast. Để biết ví dụ và thông tin chi tiết, vui lòng xem phần Tổ chức, Người (tác giả/nhà xuất bản). Bạn nên sử dụng trường này cho phân định và phải được cung cấp nếu có. |
actor |
Không bắt buộc | lặp lại |
Diễn viên của podcast. Để biết ví dụ và thông tin chi tiết, hãy xem phần Người thực hiện (người tổ chức/khách) . |
logo |
Không bắt buộc | ImageObject (Đối tượng hình ảnh) lặp lại |
Hình ảnh biểu trưng của bộ sách. Hãy cung cấp thông tin này dưới dạng được mô tả đầy đủ
ImageObject . Cung cấp độ phân giải cao nhất hiện có. JPEG hoặc PNG
được ưu tiên. Để biết thông tin chi tiết và ví dụ, hãy xem
ImageObject (biểu trưng). |
image |
Bắt buộc | ImageObject (Đối tượng hình ảnh) lặp lại |
Một hình minh hoạ của bộ sách. Cung cấp thông tin dưới dạng được mô tả đầy đủ
ImageObject . Cung cấp độ phân giải cao nhất hiện có. JPEG hoặc PNG là
ưu tiên. Vui lòng xem phần ImageObject (biểu trưng) để biết thông tin chi tiết và
ví dụ. |
isFamilyFriendly |
Bắt buộc | Boolean | Cho biết liệu nội dung này có phù hợp với gia đình hay không (tức là nếu nội dung
phù hợp với mọi thành viên trong một gia đình, bao gồm cả trẻ em). Các sản phẩm của Google
có thể sử dụng isFamilyFriendly để xác định nội dung nào sẽ phát. Chiến lược phát hành đĩa đơn
giá trị phải là true hoặc false . |
inLanguage |
Bắt buộc | Văn bản | Ngôn ngữ của nội dung podcast theo định dạng ISO 639-1. Giá trị này có thể được sử dụng để thực hiện người dùng những truy vấn yêu cầu nội dung bằng một ngôn ngữ cụ thể. |
genre |
Bắt buộc | Văn bản lặp lại |
Danh mục hoặc thể loại của loạt podcast. Ví dụ: bạn có thể theo dõi chuẩn Danh mục podcast. |
endDate |
Không bắt buộc | Ngày | Ngày phát hành tập kết thúc của loạt podcast. Chỉ bao gồm trường này khi bộ sách đã kết thúc. |
rssFeed |
Bắt buộc | URL | URL đến nguồn cấp dữ liệu RSS của loạt podcast. |
potentialAction |
Bắt buộc | ListenAction |
Hành động cần kích hoạt để người dùng nghe nội dung. Để biết thông tin chi tiết, hãy xem ListenAction. |
popularityScore
| Không bắt buộc | PopularityScoreSpecification |
Điểm số về mức độ phổ biến giúp xác định mức độ ưu tiên phân phát khi có
nhiều đề xuất. Vui lòng xem
Mục PopularityScoreSpecification (popularityScore) cho
thông tin chi tiết và ví dụ. |
keywords |
Không bắt buộc | Văn bản lặp lại |
Danh sách từ khoá sẽ liên kết với loạt podcast. Các các từ khoá có thể dùng để mở rộng cụm từ tìm kiếm của người dùng có thể kích hoạt podcast này loạt phim. Ví dụ: tên khách mời, chủ đề được đề cập, v.v. |
sameAs |
Không bắt buộc | URL | URL của trang web tham chiếu của một bên thứ ba (không phải trong miền của bạn) thể hiện rõ ràng đặc điểm của mặt hàng. Trang web này được sử dụng cho phân định khi tồn tại nhiều chuỗi đồng dạng. Ví dụ: Wikipedia hoặc trang chủ của loạt podcast. Bạn nên sử dụng trường này để phân định chuỗi. |
releasedEvent |
Không bắt buộc | PublicationEvent hoặc các loại phụ cụ thể khác – FeaturedEvent hoặc ExclusiveEvent |
Sự kiện đánh dấu việc xuất bản hoặc phát hành loạt podcast. Đáp có thể ghi chú về lần phát hành podcast đầu tiên của nhà xuất bản thì các loại chuyên biệt hơn có thể được sử dụng để biểu thị tính độc quyền hoặc tính nổi bật bản phát hành. Để biết thông tin chi tiết và ví dụ, hãy xem PublicationEvent, Phần FeaturedEvent, Sự kiện độc quyền (releasedEvent). Xin lưu ý rằng việc đánh dấu loạt video dưới dạng độc quyền hoặc nổi bật ngụ ý rằng tất cả các tập của chương trình đều độc quyền hoặc nổi bật. |
countryOfOrigin |
Không bắt buộc | Quốc gia | Quốc gia của văn phòng chính của công ty sản xuất hoặc cá nhân phụ trách podcast đó. |
Thông số kỹ thuật của podcast
PodcastEpisode
là đại diện schema.org của một tập
trong PodcastSeries
.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@context |
Bắt buộc | Văn bản | Ngữ cảnh schema.org. Luôn đặt thành [http://schema.googleapis.com,{@language:xx}]
trong đó xx là mã ngôn ngữ. Thao tác này sẽ đặt ký tự mặc định
ngôn ngữ dùng cho các giá trị văn bản trong nguồn cấp dữ liệu. |
@type |
Bắt buộc | Văn bản | Luôn đặt thành PodcastEpisode . |
@id |
Bắt buộc | Văn bản | Mã nhận dạng duy nhất trên toàn cầu cho tập podcast ở định dạng URI. Mã nhận dạng phải là
ổn định và không thay đổi theo thời gian. Nó được coi là một chuỗi mờ và không
phải là đường liên kết đang hoạt động. Tổ chức của bạn phải sở hữu miền được dùng cho giá trị @id . |
url |
Bắt buộc | Văn bản | URL chính tắc trên trang web mà bạn giới thiệu hoặc mô tả
tập podcast. Giá trị này phải là duy nhất trên toàn hệ thống. Đường liên kết này được dùng để trợ giúp
điều chỉnh chính xác nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong
cơ sở dữ liệu. Để phát lại, target.urlTemplate được nêu chi tiết trong phần
Phần ListenAction của tài liệu được sử dụng. |
name
| Bắt buộc | Văn bản | Tên của tập podcast. Chỉ được dùng một tên cho mỗi ngôn ngữ. Sử dụng một mảng để đánh dấu nội dung mô tả bằng nhiều ngôn ngữ. Xem Nhiều khu vực và ngôn ngữ ví dụ. |
description |
Bắt buộc | Văn bản | Nội dung mô tả về tập podcast. |
alternativeHeadline |
Bắt buộc | Văn bản | Tiêu đề phụ của tập podcast. |
author |
Bắt buộc | lặp lại |
Người hoặc nhóm phát triển hoặc phân phối tập đó. Giá trị này thường
tham chiếu đến máy chủ. Nếu tác giả giống với chương trình, bạn có thể sử dụng lại
qua thực thể PodcastSeries . Ví dụ và
chi tiết, vui lòng xem Tổ chức, Cá nhân (tác giả/nhà xuất bản). |
publisher |
Bắt buộc | lặp lại |
Nhóm hoặc mạng ban đầu chịu trách nhiệm xuất bản chương trình. Thường xuyên là một tổ chức chịu trách nhiệm xuất bản hoặc sản xuất một số podcast. Vui lòng xem mục Tổ chức, Cá nhân (tác giả/nhà xuất bản) cho ví dụ và thông tin chi tiết. Bạn nên sử dụng trường này để phân định và phân biệt bạn nên xác định mã này nếu có thể. |
actor |
Bắt buộc | lặp lại |
Diễn viên của podcast. Để biết ví dụ và thông tin chi tiết, hãy xem Phần Actor (người tổ chức/khách). |
datePublished |
Bắt buộc | Ngày giờ | Ngày giờ phát hành tập podcast. Giá trị này được dùng để sắp xếp chuỗi tập và phân định. |
episodeNumber |
Bắt buộc | Số nguyên | Số tập. |
partOfSeries |
Bắt buộc | PodcastSeries | PodcastSeries chứa tập podcast này. Vui lòng xem
PodcastSeries(partOfSeries) để xem thông tin chi tiết và ví dụ. |
partOfSeason |
Không bắt buộc | PodcastSeason | Đối với chương trình dài tập nhiều phần, tài sản này cung cấp thông tin về các mùa bằng số phần và tên phần. Vui lòng xem PodcastSeason(partOfSeason) để biết chi tiết và ví dụ. |
timeRequired |
Bắt buộc | Thời lượng | Thời lượng của tập ở định dạng thời lượng ISO 8601. |
image |
Không bắt buộc | ImageObject (Đối tượng hình ảnh) lặp lại |
Một hình minh hoạ của bộ sách. Thông tin này phải được mô tả đầy đủ
ImageObject . Cung cấp độ phân giải cao nhất hiện có. JPEG hoặc PNG
được ưu tiên. Vui lòng xem phần ImageObject (biểu trưng) để
thông tin chi tiết và ví dụ. |
isFamilyFriendly |
Bắt buộc | Boolean | Cho biết liệu nội dung này có phù hợp với gia đình hay không (nghĩa là
nội dung phù hợp với mọi thành viên trong một gia đình, bao gồm cả trẻ em). Điều khoản
các sản phẩm có thể sử dụng isFamilyFriendly để xác định nội dung sẽ phát.
Giá trị phải là true hoặc false . |
inLanguage |
Bắt buộc | Văn bản | Ngôn ngữ nội dung của tập podcast ở định dạng ISO 639-1. Dùng bản thảo này để đáp ứng các truy vấn của người dùng yêu cầu nội dung bằng một ngôn ngữ cụ thể. Nếu nội dung bằng nhiều ngôn ngữ, vui lòng chỉ nêu một ngôn ngữ chính. |
genre |
Bắt buộc | Văn bản lặp lại |
Danh mục hoặc thể loại của loạt podcast. Ví dụ: bạn có thể tuân theo danh mục Podcast tiêu chuẩn. |
associatedMedia |
Không bắt buộc | AudioObject | Tệp âm thanh của tập podcast. Để biết thông tin chi tiết và ví dụ, hãy xem AudioObject(associatedMedia). |
potentialAction |
Bắt buộc | ListenAction | Hành động cần kích hoạt để người dùng nghe nội dung. Để biết thông tin chi tiết, hãy xem phần ListenAction. |
popularityScore |
Không bắt buộc | PopularityScoreSpecification | Điểm mức độ phổ biến để xác định mức độ ưu tiên phân phát khi có nhiều ứng cử viên. Để biết thông tin chi tiết và ví dụ, hãy xem CommonScoreSpecification. |
keywords |
Không bắt buộc | Văn bản lặp lại |
Danh sách từ khoá liên quan đến loạt podcast. Những từ khóa này có thể
được dùng để mở rộng các cụm từ tìm kiếm của người dùng có thể kích hoạt tập podcast này. Cho
ví dụ: news , sports hoặc history . |
identifier |
Bắt buộc | PropertyValue lặp lại |
Đối với Xem phần PropertyValue (identifier) để biết ví dụ: |
sameAs |
Không bắt buộc | URL | URL của trang web tham chiếu của một bên thứ ba (không phải trong miền của bạn) thể hiện rõ ràng đặc điểm của mặt hàng. Google sử dụng trang web này cho phân định khi tồn tại nhiều chuỗi đồng dạng. Ví dụ: Wikipedia hoặc trang chủ của các tập podcast. Xin lưu ý rằng tài liệu tham khảo cấp bộ sách không được cung cấp trang tại đây. Bạn nên sử dụng trường này cho phân định của tập phim. |
releasedEvent |
Không bắt buộc | PublicationEvent hoặc loại phụ cụ thể hơn – FeaturedEvent hoặc FeaturedEvent | Sự kiện đánh dấu việc xuất bản hoặc phát hành tập podcast. Đáp sự kiện xuất bản có thể ghi lại lần phát hành đầu tiên của tập podcast nhà xuất bản và các loại phụ cụ thể hơn có thể biểu thị tính độc quyền hoặc tính nổi bật bản phát hành. Để biết thông tin chi tiết và ví dụ, hãy xem Phần PublicationEvent, FeaturedEvent, ExclusiveEvent (releasedEvent). Xin lưu ý rằng việc đánh dấu một bộ sách là độc quyền hoặc nổi bật ở trên có nghĩa là tất cả các tập của chương trình là độc quyền hoặc nổi bật. Bạn nên đánh dấu như vậy các thuộc tính ở cấp chi tiết nhất. |
countryOfOrigin |
Không bắt buộc | Quốc gia | Quốc gia của trụ sở chính của công ty hoặc cá nhân sản xuất chịu trách nhiệm cho podcast. |
PodcastSeries (partOfSeries)
Sử dụng partOfSeries
để thiết lập mối quan hệ giữa PodcastEpisode
và PodcastSeries
mẹ. Bởi vì thông tin chi tiết về PodcastSeries
được mô tả trong thực thể PodcastSeries
riêng biệt, nên bạn không cần cung cấp
toàn bộ thông tin chi tiết trong partOfSeries
. Bạn chỉ cần cung cấp các thông tin sau
thuộc tính:
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành PodcastSeries . |
@id |
Bắt buộc | URL | Mã nhận dạng duy nhất trên toàn cầu cho chuỗi chủ đề ở định dạng URI. Mã này phải khớp với
Mã của thực thể PodcastSeries hoàn chỉnh trong nguồn cấp dữ liệu của bạn. |
name |
Bắt buộc | Văn bản | Tên của loạt podcast.
|
Ví dụ 1
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=1",
"name": "Radiolab"
},
PodcastSeason (partOfSeason)
PodcastSeason
thể hiện thông tin mùa của
PodcastEpisode
, quan trọng nhất là số phần. Bạn chỉ cần
thuộc tính này khi loạt podcast có nhiều phần.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành PodcastSeason |
@id |
Bắt buộc | URL | Giá trị nhận dạng duy nhất trên toàn cầu cho phần ở định dạng URI. Mã nhận dạng này phải cố định và không thay đổi theo thời gian. Chuỗi này được coi là một chuỗi mờ và không cần là một đường liên kết đang hoạt động. |
seasonNumber |
Bắt buộc | Số nguyên | Số phần của loạt podcast. |
name |
Không bắt buộc | Văn bản | Tên của phần podcast. |
Ví dụ 1
"partOfSeason": {
"@type": "PodcastSeason",
"@id": "http://www.tjpodcast.org/seriesx/season?id=1",
"seasonNumber": 1,
"name": "Radiolab Season 1"
},
Tổ chức, Cá nhân (tác giả hoặc nhà xuất bản)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Organization hoặc Person . |
@id |
Bắt buộc | URL | Mã nhận dạng duy nhất trên toàn cầu cho tổ chức hoặc cá nhân ở định dạng URI. Mã phải ổn định và không thay đổi theo thời gian. Nó được coi là một chuỗi mờ và không cần phải là đường liên kết đang hoạt động. |
name |
Bắt buộc | Văn bản | Tên tổ chức hoặc tên cá nhân. |
sameAs |
Không bắt buộc | URL | URL của trang web tham chiếu của một bên thứ ba (không phải trong miền của bạn) thể hiện rõ ràng đặc điểm của mặt hàng. Google sử dụng trang web này cho phân định khi tồn tại nhiều chuỗi đồng dạng. Ví dụ: Trang Wikipedia của một tổ chức hoặc trang web chính thức của tổ chức. |
Ví dụ 1
"author": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
Ví dụ 2
"author": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/jad_abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
"name": "Jad Abumrad"
},
Diễn viên (Người dẫn chương trình hoặc khách mời)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Organization hoặc Person . |
@id |
Bắt buộc | URL | Mã nhận dạng duy nhất trên toàn cầu cho tổ chức hoặc cá nhân ở định dạng URI. Mã phải ổn định và không thay đổi theo thời gian. Nó được coi là một chuỗi mờ và không cần phải là đường liên kết đang hoạt động. |
name |
Bắt buộc | Văn bản | Tên của tổ chức hoặc cá nhân. |
roleName |
Bắt buộc | Văn bản | "Người lưu trữ" hoặc "Khách". |
sameAs |
Không bắt buộc | URL | URL của trang web tham chiếu của một bên thứ ba (không phải trong miền của bạn) thể hiện rõ ràng đặc điểm của mặt hàng. Google sử dụng trang web này cho phân định khi tồn tại nhiều chuỗi đồng dạng. Ví dụ: Trang Wikipedia của một tổ chức hoặc trang web chính thức của tổ chức. |
Ví dụ 1
"actor":[{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language":"en",
"@value": "Roman Mars"
},
"roleName": "Host"
"sameAs": "https://en.wikipedia.org/wiki/Roman",
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name":{
"@language":"en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
},
}]
ImageObject (biểu trưng hoặc hình ảnh)
ImageObject
dùng để cung cấp biểu trưng hoặc hình minh hoạ cho nội dung.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành ImageObject . |
height |
Không bắt buộc | Số nguyên | Chiều cao của hình ảnh tính bằng pixel. |
width |
Không bắt buộc | Số nguyên | Chiều rộng của hình ảnh tính bằng pixel. |
contentUrl |
Bắt buộc | URL | URL nơi có thể đặt hình ảnh. |
regionsAllowed |
Không bắt buộc | Quốc gia lặp lại |
Các quốc gia cho phép nội dung nghe nhìn này:
|
Quốc gia (image.regionAllowed)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Country. |
name |
Bắt buộc | Văn bản |
Mã quốc gia theo ISO 3166-1 alpha-2. Ví dụ: GB ,
US |
Ví dụ 1
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
Ví dụ 2
"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 (giá trị nhận dạng)
Nếu có giá trị nhận dạng duy nhất trên toàn cầu (GUID) cho nội dung của mình, bạn có thể cung cấp các mã này cùng
Trường identifier
để cải thiện độ chính xác của việc Google điều chỉnh dữ liệu
nội dung. Xin lưu ý rằng bạn phải có mã GUID đối với PodcastEpisode
.
Trường này phải khác với trường @id
của tập (không phải
trong miền của bạn) và phải đại diện cho tập nguồn trên toàn cầu và
theo thời gian, trên nhiều nguồn.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành "PropertyValue". |
propertyID |
Bắt buộc | Văn bản | Luôn đặt thành GUID . |
value |
Bắt buộc | Văn bản | Mã GUID của chương trình dài tập hoặc tập. |
Ví dụ 1
"identifier": {
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},
Phổ biếnScoreSpecification (commonityScore)
popularityScore
có thể giúp người dùng truy cập vào
trong các trường hợp mà tiêu chí từ truy vấn của người dùng phù hợp với nhiều
khỏi nguồn cấp dữ liệu của bạn. Nội dung có điểm mức độ phổ biến cao nhất
có sẵn cho khu vực của người dùng được phân phát cho người dùng khi giá trị này là
sẵn có. Theo mặc định, tất cả nội dung không có trường này sẽ có điểm mức độ phổ biến là 0
. Chiến lược phát hành đĩa đơn
so sánh điểm xảy ra trong phạm vi toàn bộ danh mục của bạn, vì vậy vui lòng
đảm bảo quy mô nhất quán trên tất cả nguồn cấp dữ liệu của bạn.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành PopularityScoreSpecification . |
value |
Bắt buộc | Số | Một giá trị số dương để so sánh với các thực thể khác trong danh mục của bạn để ưu tiên phân phát. Số lớn hơn thể hiện mức độ phổ biến cao hơn. |
eligibleRegion |
Không bắt buộc | Quốc gia hoặc văn bản lặp lại |
Một khu vực hoặc danh sách các khu vực áp dụng điểm phổ biến này. Nếu mức độ phổ biến được áp dụng trên toàn cầu, hãy dùng Nếu các khu vực cụ thể cần được liệt kê, vui lòng sử dụng loại "Quốc gia". Nếu bạn không điền trường này, |
Quốc gia (commonityScore.EligibleRegion)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Country . |
name |
Bắt buộc | Văn bản |
Mã quốc gia theo ISO 3166-1 alpha-2. Ví dụ: GB ,
US |
Ví dụ 1
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
Ví dụ 2
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
Ví dụ 3
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 101,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
PublicationEvent, FeaturedEvent, ExclusiveEvent (releasedEvent)
- PublicationEvent
- Sử dụng đối tượng này để biểu thị ngày và địa điểm xuất bản một chương trình hoặc
tập phim (còn được gọi là "ngày phát hành" của một loạt phim hoặc tập phim).
Ngoài ra, trường
publishedBy
biểu thị việc xuất bản hoặc phân phối thực thể của loạt podcast hoặc tập podcast. - ExclusiveEvent
- Sử dụng đối tượng này để biểu thị rằng nhà cung cấp có quyền phân phối độc quyền đối với podcast. Nội dung độc quyền có thể có giới hạn về thời gian và khu vực cụ thể, đồng thời phải bao gồm trường tổ chức trỏ đến nhà cung cấp độc quyền .
- FeaturedEvent
- Sử dụng đối tượng này để thể hiện rằng nhà cung cấp muốn giới thiệu podcast người tiêu dùng (ví dụ: dưới dạng "gốc").
- Bản gốc khác với Độc quyền
- Thuật ngữ "bản gốc (nổi bật") thường biểu thị các quyền độc hữu đối với một
thực thể, khiến thuật ngữ bị quá tải. Do đó, ý nghĩa dự định phải được tách riêng
theo 2 hạng mục trên. Thực thể ban đầu cũng có thể là
loại trừ và trong trường hợp này,
releasedEvent
có thể lấy một mảng có cả hai loại sự kiện trên cùng một thực thể.
Xin lưu ý rằng mặc dù tính độc quyền hoặc tính năng nổi bật có thể có ý nghĩa tương tự trong
danh mục của nhà cung cấp, PublicationEvent
thường được áp dụng để bật
phân định các đối tượng và cung cấp thêm siêu dữ liệu về đối tượng đó,
chẳng hạn như ngày phát hành của một chương trình dài tập hoặc một tập phim.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt là một trong PublicationEvent ,
ExclusiveEvent hoặc FeaturedEvent . |
location |
Bắt buộc | Quốc gia | Khu vực diễn ra sự kiện ấn bản. Bạn cũng có thể sử dụng
để thể hiện các hạn chế về độc quyền và hạn chế phân phối
của thực thể. Hãy sử dụng mã ISO 3166 cho quốc gia đó. Nếu bạn cần đăng ký
ngữ nghĩa toàn cục, được đặt thành EARTH . Đặt rõ ràng
location đến EARTH , tuỳ theo ngôn ngữ cụ thể
không áp dụng quy định hạn chế nào. |
startDate |
Nên dùng (Bắt buộc đối với Sự kiện độc quyền) | Ngày hoặc ngày giờ | Ngày bắt đầu của thực thể ấn bản. Trong trường hợp
PublicationEvent , đây biểu thị ngày phát hành ban đầu của
thực thể này. Trong trường hợp ExclusiveEvent hoặc
FeaturedEvent , đại diện cho ngày bắt đầu của
tính độc quyền hoặc tính nổi bật của đối tượng. |
endDate |
Nên dùng (Bắt buộc đối với Sự kiện độc quyền) | Ngày hoặc ngày giờ | Ngày kết thúc xuất bản của thực thể. Trong trường hợp
PublicationEvent , biểu thị ngày xuất bản chính thức
của thực thể này. Trong trường hợp ExclusiveEvent hoặc
FeaturedEvent , đại diện cho ngày kết thúc của
tính độc quyền hoặc tính nổi bật của đối tượng. |
publishedBy |
Bắt buộc | Tổ chức hoặc cá nhân | Thực thể Organization hoặc Person
xuất bản thực thể này và áp dụng cho sự kiện xuất bản này. Vui lòng sử dụng
cùng một giản đồ như được mô tả trong
Tổ chức
(tác giả/Nhà xuất bản). |
Ví dụ 1
"releasedEvent": [ {
"@type": "PublicationEvent",
"location": "EARTH",
"startDate": "2016-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
}, {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
},
]
Ví dụ 2
"releasedEvent": [ {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}
]
AudioObject (AssociatedMedia)
AudioObject
dùng để cung cấp tệp nội dung nghe nhìn thô cho tập podcast.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành AudioObject . |
contentUrl |
Bắt buộc | URL | URL của tệp nội dung nghe nhìn. |
contentSize |
Bắt buộc | Số nguyên | Kích thước của tệp nội dung nghe nhìn tính bằng byte. |
encodingFormat |
Bắt buộc | Văn bản | Loại nội dung nghe nhìn IANA của tệp đa phương tiện. Ví dụ:
audio/mpeg . |
duration |
Bắt buộc | Thời lượng | Thời lượng của nội dung nghe nhìn ở định dạng thời lượng ISO 8601. |
transcript |
Không bắt buộc | Văn bản | Bản chép lời của tập podcast đó. |
bitrate |
Không bắt buộc | Văn bản | Tốc độ bit của tệp đa phương tiện. |
name |
Không bắt buộc | Văn bản | Tên tệp của tệp đa phương tiện. |
Ví dụ 1
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT5M32S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"name": "radiolab_podcast19.mp3",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
ListenAction (VisibilityAction)
Thực thể ListenAction
xác định các đường liên kết sâu để phát và tiêu chí
để người dùng (ví dụ: trạng thái theo khu vực địa lý, thứ tự thời gian, thông tin đăng nhập hoặc gói thuê bao)
truy cập vào nội dung.
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành ListenAction . |
target |
Bắt buộc |
lặp lại |
Quy cách của đường liên kết sâu với nền tảng được hỗ trợ
của bạn. Bạn có thể sử dụng nhiều trường EntryPoint để
xác định các liên kết sâu khác nhau cho các nhóm nền tảng khác nhau. |
actionAccessibilityRequirement |
Bắt buộc |
lặp lại |
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
ActionAccessSpecification giới thiệu, một người dùng phù hợp với bất kỳ
đặc tả kỹ thuật số có thể truy cập vào nội dung. |
EntryPoint (tiềm năngAction.target)
@type
Bắt buộc
Văn bản
Luôn đặt thành EntryPoint
.
urlTemplate
Bắt buộc
URL
Đường liên kết dùng để bắt đầu phát nội dung của bạn.
actionPlatform
Bắt buộc
Văn bản
lặp lại
Nền tảng mà đường liên kết sâu này là hợp lệ. Các giá trị sau đây có thể là:
"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 (tiềm năngAction.actionAccessibilityRequirement)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành ActionAccessSpecification . |
category |
Bắt buộc | Văn bản |
Loại yêu cầu về quyền truy cập. Tên này phải là một trong những tên sau giá trị:
|
availabilityStarts |
Không bắt buộc | Ngày giờ | Thời gian bắt đầu của khung thời gian được phép đọc. Bạn có thể sử dụng tính năng này để kiểm soát thời điểm chính xác mà người dùng có thể xem nội dung này. |
availabilityEnds |
Không bắt buộc | Ngày giờ | Thời gian kết thúc của khung thời gian được phép đọc. Bạn có thể sử dụng tính năng này để kiểm soát thời điểm chính xác mà nội dung này ngừng xuất hiện người dùng. |
eligibleRegion |
Bắt buộc | Quốc gia lặp lại |
Quốc gia đủ điều kiện nhận Ưu đãi này. Bạn có thể dùng địa chỉ này để kiểm soát quốc gia hoặc khu vực nơi phải có nội dung này sẵn có. |
requiresSubscription |
Bắt buộc nếu có | MediaSubscription | Cần có gói thuê bao để truy cập vào nội dung này. Nếu dịch vụ cung cấp nhiều gói thuê bao, trường này là bắt buộc. Nếu dịch vụ của bạn miễn phí hoặc chỉ có một cấp thuê bao, bạn có thể bỏ qua trường này. |
Quốc gia (OpportunityAction.actionAccessibilityRequirement.EligibleRegion)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Country . |
name |
Bắt buộc | Văn bản | Chiến lược phát hành đĩa đơn Mã quốc gia theo ISO 3166-1 alpha 2. |
MediaSubscription (tiềm năngAction.actionAccessibility yêument.Yêu cầu đăng ký)
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành MediaSubscription . |
@id |
Bắt buộc | URL | Mã nhận dạng duy nhất trên toàn hệ thống cho gói thuê bao ở định dạng URI. Chiến lược phát hành đĩa đơn Mã nhận dạng phải cố định và không thay đổi theo thời gian. Mã này được coi là giá trị mờ và không cần phải là một đường liên kết đang hoạt động. |
name |
Bắt buộc | Văn bản | Tên của gói thuê bao. Ví dụ:
Premium , Basic . |
expectsAcceptanceOf |
Recommended (Nên dùng) | Lời đề nghị | Ưu đãi liên quan đến giao dịch mua Gói thuê bao nội dung nghe nhìn. Bạn có thể sử dụng giá trị này để cho biết giá của gói thuê bao. |
Ưu đãi ().
Thuộc tính | Mức độ ưu tiên | Loại | Mô tả |
---|---|---|---|
@type |
Bắt buộc | Văn bản | Luôn đặt thành Offer . |
price |
Bắt buộc | Số | Giá của gói thuê bao. |
priceCurrency |
Bắt buộc | Văn bản | Đơn vị tiền tệ (ở định dạng ISO 4217 gồm ba chữ cái) của giá. |
seller |
Recommended (Nên dùng) | Tổ chức | Tổ chức cung cấp gói thuê bao hoặc giao dịch mua hành động. Hãy sử dụng cùng một giản đồ như được mô tả trong Tổ chức (tác giả/Nhà xuất bản). |
Ví dụ 1
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.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"
}
}
},
Ví dụ 2
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.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.tjpodcast.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": "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"
}
}
]
},
Phụ lục
Ví dụ đầy đủ
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-09-10T13:58:26.892Z",
"dataFeedElement": [
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"url": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"description": "A two-time Peabody Award-winner...",
"alternativeHeadline": "Radiolab - Powered by WNYC",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2.jpg"
},
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
},
"keywords": [
"Science",
"Technology",
"Philosophy",
"Education"
],
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"inLanguage": "en",
"genre": [
"Science & Medicine",
"Natural Sciences"
],
"endDate": "2017-12-22T08:59:00",
"rssFeed": "http://feeds.wnyc.org/radiolab",
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.2
}
},
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastEpisode",
"@id": "http://www.tjpodcast.org/episode?id=1",
"url": "http://www.tjpodcast.org/episode?id=1",
"name": "A Clockwork Miracle",
"description": "As legend goes, in 1562, King Philip II...",
"sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
},
"keywords": [
"Education",
"Philosophy",
"Science",
],
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
},
"episodeNumber": 101,
"inLanguage": "en",
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"genre": [
"Science",
"Philosophy",
"Fiction"
],
"datePublished": "2018-12-27T23:23:00Z",
"timeRequired": "PT22M",
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT21M45S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.8
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "53ff386e-e768-40b5-8854-1b7415826ded"
}
]
}
],
"actor": [
{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language": "en",
"@value": "Roman Mars"
},
"roleName": "Host",
"sameAs": "https://en.wikipedia.org/wiki/Roman"
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name": {
"@language": "en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
}
}
],
"releasedEvent": [
{
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
}
]
}