Müzik oynatma listelerinin içerik işaretleme özellikleri

Bu bölümde, MusicPlaylist varlık türüne ait içerik işaretleme özelliklerinin ayrıntıları sağlanmaktadır.

Spesifikasyon tablosu

Mülk Beklenen Tür Açıklama
@context Metin Zorunlu: Her zaman ["http://schema.googleapis.com", {"@language": "xx"}] olarak ayarlanır.
  • Burada "xx", feed'deki dizelerin dilini temsil eder. Her kök öğe bağlamının @language özelliği, BCP 47 biçiminde uygun dil koduna ayarlanmalıdır. Örneğin, dil İspanyolca olarak ayarlanmışsa altyazı/dublaj dili İngilizce olsa bile adların İspanyolca olduğu varsayılır.
@type Metin Zorunlu: Karışık listeler için her zaman MusicPlaylist olarak ayarlanır.
@id URL Zorunlu: İçeriğin URI biçimindeki tanımlayıcısıdır. Örneğin, https://example.com/1234abc.
@id aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuzda dünya genelinde benzersiz olmalıdır.
  • Statik; Kimlik sabit olmalı ve zaman içinde değişmemelidir (programın url özelliği değişse bile). Bu, opak bir dize olarak işlenir ve çalışan bir bağlantı olması gerekmez.
  • Tekdüzen Kaynak Tanımlayıcısı (URI) biçiminde
  • @id değeri için kullanılan alan adı, kuruluşunuza ait olmalıdır.
Bir öğenin url, tanımlayıcı olarak tüm koşulları karşıladığı için @id olarak öğenin url değerini kullanmanızı öneririz. Daha fazla bilgi için Tanımlayıcı bölümüne bakın.
url URL Zorunlu: Google'ın feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için kullandığı içeriğin standart URL'si.
url aşağıdaki koşulları karşılamalıdır:
  • url global olarak benzersiz olmalıdır
  • url, Google'ın tarayabileceği çalışan bir standart URL içermelidir.
  • url, ödeme duvarı tarafından engellenmeyen bir içerik açıklaması sayfasına işaret etmelidir.
Oynatma işleminin derin bağlantısı için hedef nesnesinin urlTemplate mülküne bakın.
name Metin Zorunlu: Şarkı listesinin adı (ör. "Funky Jazz Mix").
genre Metin Oynatma listesi bir tür karmasıysa gereklidir: Oynatma listesinin temsil ettiği türe özgü anahtar kelimelerin listesi. Bu özelliğin varlığı, Google'a bu oynatma listesinin tür çalma listesi olmasını istediğinizi bildirir.
numTracks Tamsayı Oynatma listesi, seçilen parçalardan oluşan bir listeyse gereklidir: Oynatma listesindeki parçaların sayısı. Bu özelliğin varlığı, Google'a bu oynatma listesinin manuel olarak seçildiğini gösterir. Bu mülkün olmaması, oynatma listesinin sonsuz bir otomatik olarak oluşturulmuş oynatma listesi olduğunu gösterir.
potentialAction ListenAction Zorunlu: İşlemin ayrıntılarını sağlayan bir İşlem işaretleme nesnesi. Ayrıntılar için İşlem işaretleme özellikleri bölümüne bakın.
image ImageObject Oynatma listesini veya müzik derlemesini temsil eden bir oynatma listesi resmi. Resim işaretleme özellikleri bölümüne bakın.
creator Organization veya Person İçerik üreticinin ilgi alanı yüksekse önerilir. Bu mülkü, hizmetiniz tarafından oluşturulan oynatma listelerini (name mülkü hizmetinizi belirten Kuruluş olarak yazılır) veya hizmetinizin ilgi alanı yüksek bir kullanıcısını (name mülkü ilgili kullanıcıyı belirten Kişi olarak yazılır) belirtmek için kullanın.
keywords Metin Anahtar kelimeler ("rock", "pop"), ruh halleri ("mutlu", "kasvetli"), etkinlikler ("egzersiz", "dinlendirici") veya oynatma listesiyle ilgili diğer terimlerin listesi.
description Metin Oynatma listesinin kısa bir açıklaması. 300 karakterle sınırlıdır.
isFamilyFriendly Boole Bu içeriğin aileye uygun olup olmadığını (yani, çocuklar da dahil olmak üzere ailenin tüm üyeleri için uygun olup olmadığını) belirtir. Google ürünleri, çalacağı şarkıyı belirlerken isFamilyFriendly'ü kullanabilir.
popularityScore PopularityScoreSpecification Yüksek Önerilen Neden? Google'ın, kullanıcılara hangi medyanın oynatılacağını belirlemek için diğer sinyallerle birlikte kullandığı bir puan. Bu puan, içeriğin katalogunuzdaki diğer içeriklere göre popülerliğini gösterir. Bu nedenle, puanın ölçeği feed'lerinizde ve katalogunuzdaki tüm öğeler arasında tutarlı olmalıdır. Varsayılan olarak, bir öğenin popülerlik puanı 0 olarak ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification olarak ayarlanır.
popularityScore.value Number Öğenin popülerliğini gösteren, sıfırdan büyük bir sayısal değerdir. Puan ne kadar yüksekse popülerlik de o kadar yüksektir.
popularityScore.eligibleRegion Ülke Bu popülerlik puanının geçerli olduğu bölgeler. Popülerlik puanı dünya genelinde geçerliyse EARTH olarak ayarlayın. Bu özellik varsayılan olarak EARTH olarak ayarlanmıştır.
Note: Yerel dili temel alan popülerlik, küresel (DÜNYA) popülerlikten önceliklidir

Örnek

2010'ların pop şarkılarından oluşan, özenle seçilmiş bir oynatma listesi içeren örnek:

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

Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın: