Properti markup konten dari playlist musik

Bagian ini memberikan detail properti markup konten untuk jenis entitas MusicPlaylist.

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu tetapkan ke ["http://schema.googleapis.com", {"@language": "xx"}].
  • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entitas root harus disetel ke @bahasa yang sesuai dengan kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke Spanyol, nama diasumsikan dalam bahasa Spanyol meskipun bahasa subtitel/sulih suara dalam bahasa Inggris.
@type Teks Wajib - Selalu tetapkan ke MusicPlaylist untuk mix.
@id URL Wajib - ID konten dalam format URI; misalnya, https://example.com/1234abc.
@id harus memenuhi persyaratan berikut:
  • Unik secara global di seluruh katalog Anda
  • Statis; ID harus stabil dan tidak berubah dari waktu ke waktu (meskipun properti URL acara berubah). ID ini akan diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi.
  • Dalam bentuk Unified Resource Identifier (URI)
  • Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda.
Karena url entitas memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entitas sebagai @id. Lihat bagian ID untuk mengetahui detail selengkapnya.
url URL Wajib - URL kanonis konten, yang digunakan Google untuk mencocokkan konten di feed Anda dengan konten di database Google.
url harus memenuhi persyaratan berikut:
  • url harus unik secara global
  • url harus berisi URL kanonis aktif yang dapat di-crawl oleh Google.
  • url harus mengarah ke halaman deskripsi konten yang tidak diblokir oleh penghalang konten berbayar.
Untuk deep link pemutaran, lihat properti urlTemplate objek target.
name Teks Wajib - Nama playlist, misalnya "Mix Musik Funky".
genre Teks Wajib jika playlist adalah campuran genre - Daftar kata kunci yang spesifik untuk genre yang diwakili playlist. Kehadiran properti ini akan memberi tahu Google bahwa Anda ingin playlist ini menjadi playlist genre.
numTracks Integer Wajib jika playlist adalah video mix pilihan - Jumlah lagu dalam playlist. Kehadiran properti ini akan memberi tahu Google bahwa playlist ini diseleksi secara manual. Tidak adanya properti ini akan menandakan bahwa playlist merupakan playlist yang dibuat secara otomatis tanpa akhir.
potentialAction ListenAction Wajib - Objek markup tindakan yang memberikan detail tindakan. Lihat Properti markup tindakan untuk mengetahui detailnya.
image ImageObject Gambar playlist yang mewakili playlist atau campuran musik. Lihat Properti markup gambar.
creator Organisasi atau Pengguna Direkomendasikan jika kreator memiliki minat tinggi. Gunakan properti ini untuk menunjukkan playlist yang dibuat oleh layanan Anda (diketik sebagai Organisasi dengan properti name yang menunjukkan layanan Anda) atau pengguna dengan minat tinggi dari layanan Anda (diketik sebagai Orang dengan properti name yang menunjukkan pengguna yang diminati).
keywords Teks Daftar kata kunci ("rock", &}}
description Teks Deskripsi singkat playlist. Batasan 300 karakter.
isFamilyFriendly Boolean Menunjukkan apakah konten ini cocok untuk keluarga (yaitu, konten cocok untuk semua anggota keluarga, termasuk anak-anak). Produk Google dapat menggunakan isFamilyFriendly saat menentukan lagu untuk diputar.
popularityScore PopularitasSkorSpesifikasi Sangat Direkomendasikan Mengapa demikian? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar bagi pengguna. Skor ini mewakili popularitas konten dalam kaitannya dengan konten lain dalam katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed Anda, di antara semua entitas dalam katalog Anda. Secara default, skor popularitas entitas disetel ke 0.
popularityScore.@type Teks Selalu tetapkan ke PopularityScoreSpecification.
popularityScore.value Number Nilai numerik non-negatif yang menunjukkan popularitas entitas; skor yang lebih tinggi berarti popularitas yang lebih tinggi.
popularityScore.eligibleRegion Negara Wilayah tempat skor popularitas ini berlaku. Jika skor popularitas berlaku secara global, tetapkan ke EARTH. Secara default, properti ini ditetapkan ke EARTH.
Note: Popularitas khusus lokalitas lebih diutamakan daripada popularitas global (EARTH)

Contoh

Contoh yang berisi playlist lagu pop tahun 2010-an yang diseleksi secara manual:

{
  "@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."
}

Lihat halaman berikut untuk topik yang terkait dengan properti ini: