Properti markup konten playlist musik

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

Tabel spesifikasi

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu ditetapkan ke ["http://schema.googleapis.com", {"@language": "xx"}].
  • Dengan "xx" mewakili bahasa string dalam feed. Setiap konteks entity root harus memiliki @language yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama akan dianggap dalam bahasa Spanyol meskipun bahasa subtitel/dub dalam bahasa Inggris.
@type Teks Wajib - Selalu tetapkan ke MusicPlaylist untuk campuran.
@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). URL 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 entity memenuhi semua persyaratan sebagai ID, sebaiknya gunakan url entity 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 paywall.
Untuk deep link pemutaran, lihat properti urlTemplate objek target.
name Teks Wajib - Nama playlist, misalnya "Funky Jazz Mix".
genre Teks Wajib diisi jika playlist adalah campuran genre - Daftar kata kunci khusus untuk genre yang diwakili playlist. Kehadiran properti ini memberi tahu Google bahwa Anda ingin playlist ini menjadi playlist genre.
numTracks Bilangan Bulat Wajib jika playlist adalah campuran pilihan - Jumlah lagu dalam playlist. Kehadiran properti ini memberi tahu Google bahwa playlist ini diseleksi secara manual. Jika tidak ada properti ini, playlist akan dianggap sebagai playlist yang dibuat secara otomatis dan tanpa batas.
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 video mix musik. Lihat Properti markup gambar.
creator Organization atau Person Direkomendasikan jika kreator memiliki minat yang tinggi. Gunakan properti ini untuk menunjukkan playlist yang dibuat oleh layanan Anda (diketik sebagai Organisasi dengan properti name yang menunjukkan layanan Anda) atau pengguna yang memiliki minat tinggi terhadap layanan Anda (diketik sebagai Orang dengan properti name yang menunjukkan pengguna yang memiliki minat).
keywords Teks Daftar kata kunci ("rock", "pop"), mood ("happy", "moody"), aktivitas ("exercise", "relaxing"), 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 tersebut sesuai untuk semua anggota keluarga, termasuk anak-anak). Produk Google dapat menggunakan isFamilyFriendly saat menentukan lagu yang akan diputar.
popularityScore PopularityScoreSpecification Sangat Direkomendasikan Mengapa? Skor yang digunakan Google, beserta sinyal lainnya, untuk menentukan media yang akan diputar untuk pengguna. Skor ini menunjukkan popularitas konten sehubungan dengan konten lain di katalog Anda; oleh karena itu, skala skor harus konsisten di seluruh feed, di antara semua entitas di 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 lokalitas lebih diutamakan daripada popularitas global (EARTH)

Contoh

Contoh yang berisi playlist pilihan 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: