Properti markup konten playlist musik

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

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.googleapis.com", {"@language": "xx"}].
  • Di mana "xx" mewakili bahasa string dalam feed. Setiap konteks root entity harus menyetel @language-nya ke kode bahasa yang sesuai dalam format format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama dianggap sebagai bahasa Spanyol meskipun bahasa subtitel/sulih suara adalah bahasa Inggris.
@type Teks Wajib - Selalu ditetapkan 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 jika properti URL acara berubah). String 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 yang berfungsi dan 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 "Funky Jazz Mix".
genre Teks Wajib jika playlist adalah campuran genre - Daftar kata kunci khusus untuk genre yang diwakili oleh playlist. Keberadaan properti ini memberi tahu Google bahwa Anda bermaksud membuat playlist ini sebagai playlist genre.
numTracks Bilangan Bulat Wajib jika playlist adalah video mix hasil seleksi - Jumlah lagu dalam playlist. Keberadaan properti ini memberi tahu Google bahwa playlist ini diseleksi secara manual. Jika tidak ada properti ini, menandakan bahwa playlist tersebut merupakan playlist yang dibuat secara otomatis tanpa batas.
potentialAction ListenAction Wajib - Objek markup Action yang memberikan detail tindakan. Lihat Properti markup Tindakan untuk mengetahui detailnya.
image ImageObject Gambar playlist yang mewakili playlist atau mix musik. Lihat Properti markup gambar.
creator Organisasi atau Individu Direkomendasikan jika kreator sangat berminat. Gunakan properti ini untuk menunjukkan playlist yang dibuat oleh layanan Anda (yang diketik sebagai Organization dengan properti name yang menunjukkan layanan Anda) atau pengguna yang memiliki minat tinggi terhadap layanan Anda (diketik Person dengan properti name miliknya yang menunjukkan pengguna yang diminati).
keywords Teks Daftar kata kunci ("rock", "pop"), suasana hati ("bahagia", "moody"), aktivitas ("berolahraga", "santai"), atau istilah lain yang terkait dengan playlist.
description Teks Deskripsi singkat playlist. Batas 300 karakter.
isFamilyFriendly Boolean Menunjukkan apakah konten ini cocok untuk keluarga (yaitu, konten sesuai untuk semua anggota keluarga, termasuk anak-anak). Produk Google dapat menggunakan isFamilyFriendly saat menentukan lagu untuk diputar.
popularityScore PopularityScoreSpecification Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, serta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten dalam kaitannya dengan konten lain di 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 ditetapkan ke 0.
popularityScore.@type Teks Selalu ditetapkan 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 lokal lebih diutamakan daripada popularitas global (EARTH)

Contoh

Contoh yang berisi playlist hasil seleksi lagu pop tahun 2010-an:

{
  "@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: