Phần này cung cấp thông tin chi tiết về 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 | Nội dung 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 danh sách kết hợp. |
@id |
URL | Bắt buộc – Giá trị nhận dạng 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 pháp nhân đáp ứng tất cả các yêu cầu làm giá trị nhận dạng, nên bạn nên sử dụng url của một thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm chi tiết. |
url |
URL | Bắt buộc – URL chính tắc của nội dung mà Google sử dụng để 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 của danh sách phát, ví dụ: "Funky Jazz Mix".
|
genre |
Văn bản | Bắt buộc nếu danh sách phát là sự kết hợp thể loại – Danh sách từ khóa dành riêng cho thể loại mà danh sách phát đó thể hiện. Sự hiện diện của tài sản này sẽ cho Google biết rằng bạn muốn đưa danh sách phát này vào 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à danh sách phát kết 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 tài sản này sẽ báo 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ó tài sản này thì danh sách phát sẽ là tín hiệu cho thấy danh sách phát đó được tạo tự động vô thời hạn. |
potentialAction |
ListenAction | Bắt buộc – Đối tượng mã đánh dấu thao tác cung cấp thông tin chi tiết về thao tác đó. Hãy xem Thuộc tính đánh dấu hành động để biết thông tin chi tiết.
|
image |
ImageObject | Hình ảnh danh sách phát đại diện cho danh sách phát hoặc danh sách kết hợp nhạc. Hãy xem bài viết Thuộc tính đánh dấu hình ảnh. |
creator |
Tổ chức hoặc Người | Bạn nên dùng cách này nếu nhà sáng tạo quan tâm nhiều. Hãy dùng thuộc tính này để chỉ các danh sách phát do dịch vụ của bạn tạo (nhập là Tổ chức và thuộc tính name của danh sách phát cho biết dịch vụ của bạn) hoặc một người dùng quan tâm đến dịch vụ của bạn (nhập là Cá nhân với thuộc tính name cho biết người dùng quan tâm). |
keywords |
Văn bản | Danh sách các từ khóa ("rock", "pop"), tâm trạng ("happy", "moody"), hoạt động ("exercise", "relaxing") hoặc các thuật ngữ khác liên quan đến danh sách phát |
description |
Văn bản | Nội dung mô tả ngắn về danh sách phát. Giới hạn ký tự là 300.
|
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 mọi 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 một bài hát sẽ phát. |
popularityScore |
phổ biến | Rất nên chọn Tại sao? Đ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 nào 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 các nội dung khác trong danh mục; do đó, thang điểm cần phải nhất quán trên các nguồn cấp dữ liệu của bạn, giữa 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 là 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 cao hơn có nghĩa là mức độ phổ biến cao hơn. |
popularityScore.eligibleRegion |
Quốc gia | (Các) khu vực có áp dụng điểm số phổ biến này. Nếu mức độ phổ biến được áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, tài sản 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 được chọn thủ công bao gồm các bài hát pop trong những năm 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: