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 danh sách kết hợp. |
@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ả yêu cầu để có 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. Xem phần Identifier để 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 target. |
name |
Văn bản | Bắt buộc – Tên của danh sách phát, chẳng hạn như "Funky Jazz Mix".
|
genre |
Văn bản | Bắt buộc nếu danh sách phát có nhiều thể loại – Danh sách từ khoá liên quan đến thể loại mà danh sách phát đó đại diện. Sự hiện diện của tài sản này báo hiệu cho Google rằng bạn dự định danh sách phát này sẽ trở thành một 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 nhạc kết hợp tuyển chọn – Số lượng bản nhạc trong danh sách phát. Sự hiện diện của cơ sở lưu trú 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. Việc không có thuộc tính này sẽ báo hiệu rằng danh sách phát này là một danh sách phát vô tận được tạo tự động. |
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. Xem Thuộc tính đánh dấu hành động để biết 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 danh sách nhạc kết hợp. Hãy xem bài viết Thuộc tính đánh dấu hình ảnh. |
creator |
Organization (Tổ chức) hoặc Person (Người) | Nên dùng nếu nhà sáng tạo quan tâm nhiều đến video. Sử dụng thuộc tính này để cho biết các danh sách phát được tạo bởi dịch vụ của bạn (được nhập là 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 rất quan tâm đến dịch vụ của bạn (được nhập là Người 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 từ khoá ("nhạc rock", "pop"), tâm trạng ("vui", "khiêu điệu"), hoạt động ("tập thể dục", "thư giãn") hoặc các cụm từ khác liên quan đến danh sách phát. |
description |
Văn bản | 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 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 khi xác định một bài hát sẽ phát. |
popularityScore |
PopularityScoreSpecification | Rất nên dùng 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 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 những nội dung khác trong danh mục của bạn; do đó, thang điểm cần 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 mức độ 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 | Một 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 có áp dụng điểm số 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ụ chứa danh sách phát được tuyển chọn thủ công gồm các bài hát nhạc pop 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 để biết những chủ đề liên quan đến những tài sản này: