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ể MusicPlaylist.
Bảng thông số kỹ thuật
| Thuộc tính | Loại dự kiến | Mô tả |
|---|---|---|
@context |
Văn bản | Bắt buộc – Luôn đặt thành ["http://schema.googleapis.com", {"@language": "xx"}].
|
@type |
Văn bản | Bắt buộc – Luôn đặt thành MusicPlaylist cho các bản phối. |
@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:
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. Google sử dụng URL này để so khớp 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.url phải đáp ứng các yêu cầu sau:
urlTemplate của đối tượng mục tiêu. |
name |
Văn bản | Bắt buộc – Tên danh sách phát, ví dụ: "Bản phối nhạc Funky Jazz".
|
genre |
Văn bản | Bắt buộc nếu danh sách phát là danh sách phát kết hợp nhiều thể loại – Danh sách từ khoá dành riêng cho thể loại mà danh sách phát thể hiện. Việc có thuộc tính này cho Google biết rằng bạn muốn danh sách phát này là danh sách phát theo thể loại. |
numTracks |
Số nguyên | Bắt buộc nếu danh sách phát là một bản nhạc tổng hợp được tuyển chọn – Số lượng bản nhạc trong danh sách phát. Sự hiện diện của thuộc tính này cho Google biết rằng danh sách phát này được tuyển chọn thủ công. Nếu không có thuộc tính này, thì danh sách phát sẽ là danh sách phát được tạo tự động và phát liên tục. |
potentialAction |
ListenAction | Bắt buộc – Đối tượng đánh dấu hành động cung cấp thông tin chi tiết về hành động. Hãy xem Thuộc tính đánh dấu hành động để biết thông tin chi tiết.
|
image |
ImageObject (Đối tượng hình ảnh) | Hình ảnh danh sách phát đại diện cho danh sách phát hoặc bản nhạc kết hợp. Xem Thuộc tính đánh dấu hình ảnh. |
creator |
Tổ chức hoặc Người | Bạn nên sử dụng tính năng này nếu nhà sáng tạo có mức độ quan tâm cao. Sử dụng thuộc tính này để chỉ báo danh sách phát do dịch vụ của bạn tạo (được nhập dưới dạng Tổ chức với thuộc tính name cho biết dịch vụ của bạn) hoặc người dùng có mối quan tâm cao đến dịch vụ của bạn (được nhập dưới dạng Người với thuộc tính name cho biết người dùng có mối quan tâm). |
keywords |
Văn bản | Danh sách từ khoá ("rock", "pop"), tâm trạng ("happy", "moody"), hoạt động ("exercise", "relaxing") hoặc các cụm từ khác liên quan đến danh sách phát. |
description |
Văn bản | Nội dung mô tả ngắn gọn về danh sách phát. Giới hạn 300 ký tự.
|
isFamilyFriendly |
Boolean | Cho biết nội dung này có phù hợp với gia đình hay không (tức là nội dung phù hợp với tất cả thành viên trong gia đình, bao gồm cả trẻ em). Các sản phẩm của Google có thể sử dụng isFamilyFriendly khi xác định bài hát để phát. |
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 cần phải nhất quán trên các nguồn cấp dữ liệu, trong số 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. |
popularityScore.@type |
Văn bản | Luôn đặt thành PopularityScoreSpecification. |
popularityScore.value |
Number | Giá trị số không âm cho biết mức độ phổ biến của thực thể; điểm số càng cao thì mức độ phổ biến càng cao. |
popularityScore.eligibleRegion |
Quốc gia | (Các) khu vực áp dụng điểm số về mức độ phổ biến này. Nếu điểm phổ biến có thể áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, thuộc tính này được đặt thành EARTH. Note: Mức độ phổ biến theo ngôn ngữ được ưu tiên hơn mức độ phổ biến trên toàn cầu (EARTH) |
Ví dụ:
Ví dụ về một danh sách phát do người dùng tuyển chọn gồm các bài hát pop của thập niên 2010:
{
"@context":["http://schema.googleapis.com/", {"@language": "en"}],
"@type":"MusicPlaylist",
"@id":"http://www.example.com/playlist/top-pop-songs/",
"url":"http://www.example.com/playlist/top-pop-songs/",
"name":"Top Pop Songs of the 2010s",
"image":[
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo1.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["US","UK","MX"]
},
{
"@type": "ImageObject",
"contentUrl" : "http://www.example.com/playlist/top-pop-songs/1x1/photo2.jpg",
"dateModified" : "2018-01-05T22:11:33+00:00",
"regionsAllowed" : ["UA", "IR"]
}],
"genre": [
"pop",
"2010s"
],
"numTracks":"46",
"potentialAction":{
"@type":"ListenAction",
"target":[
{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/playlist/top-pop-songs?autoplay=true",
"actionPlatform":[
"http://schema.org/DesktopWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "android-app://com.app.example/playlist/top-pop-songs?autoplay=true",
"actionPlatform": "http://schema.org/AndroidPlatform"
}
],
"expectsAcceptanceOf":{
"@type":"Offer",
"category":"free",
"eligibleRegion": {
"@type":"Country",
"name":"US"
}
}
},
"creator": {
"@type": "Organization",
"name": "example.com"
},
"keywords": [
"pop",
"Party music"
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description":"Top pop songs from the last decade."
}
Các trang liên quan
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những tài sản này: