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

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

Spesifikasyon tablosu

Özellik 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 varlık bağlamı, BCP 47 biçiminde uygun dil koduna ayarlanmış @dil değerine ayarlanmalıdır. Örneğin, dil İspanyolcaya ayarlanırsa altyazı/dublaj dili İngilizce olsa bile adların İspanyolca olduğu varsayılır.
@type Metin Zorunlu: Mix'ler için her zaman MusicPlaylist olarak ayarlayın.
@id URL Gerekli - URI biçimindeki içeriğin tanımlayıcısı; örneğin, https://example.com/1234abc.
@id adresi aşağıdaki koşulları karşılamalıdır:
  • Kataloğunuz genelinde küresel olarak benzersiz
  • 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.
  • Birleştirilmiş Kaynak Tanımlayıcı (URI) biçiminde
  • @id değeri için kullanılan alan adı, kuruluşunuza ait olmalıdır.
Bir varlığın url özelliği, tanımlayıcı olarak tüm koşulları karşıladığı için varlığın url özelliğini @id olarak kullanmanızı öneririz. Daha fazla ayrıntı 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, genel 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çıklama sayfasına yönlendirmelidir.
Oynatma derin bağlantısı için bunun yerine hedef nesnesinin urlTemplate özelliğine bakın.
name Metin Zorunlu: Çalma listesinin adı (ör. "Funky Caz Mix'i").
genre Metin Oynatma listesi bir tür mix'iyse gereklidir: Oynatma listesinin temsil ettiği türe özel anahtar kelime listesi. Bu özelliğin varlığı, Google'a bu oynatma listesinin bir tür oynatma listesi olmasını istediğinize işaret eder.
numTracks Tamsayı Oynatma listesi seçilmiş bir mix ise gereklidir: Oynatma listesindeki parçaların sayısı. Bu özelliğin varlığı, Google'a bu oynatma listesinin özel olarak seçildiğini gösterir. Bu özelliğin olmaması, oynatma listesinin otomatik olarak oluşturulan sonsuz bir oynatma listesi olduğunu gösterir.
potentialAction ListenAction Gerekli: İş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 mix'ini temsil eden bir oynatma listesi resmi. Resim işaretleme özellikleri konusuna bakın.
creator Organization veya Person İçerik üreticinin ilgi düzeyi yüksekse önerilir. Hizmetiniz tarafından oluşturulan oynatma listelerini (hizmetinizi belirten name özelliğiyle Kuruluş olarak yazın) veya hizmetinizin yüksek ilgi gösteren bir kullanıcısını (ilgili kullanıcıyı name özelliğiyle birlikte Kişi olarak yazın) belirtmek için bu özelliği kullanın.
keywords Metin Anahtar kelime ("rock", "pop"), ruh halleri ("mutlu", "kasvetli"), etkinlikler ("egzersiz", "rahatlama") veya oynatma listesiyle ilgili diğer terimlerin listesi.
description Metin Oynatma listesinin kısa bir açıklaması. 300 karakter sınırlaması.
isFamilyFriendly Boole Bu içeriğin ailelere uygun olup olmadığını (yani çocuklar da dahil olmak üzere ailenin tüm üyeleri için uygun olup olmadığını) belirtir. Google ürünleri, çalacak şarkıyı belirlerken isFamilyFriendly kullanabilir.
popularityScore PopularityScoreSpecification Önemle Tavsiye Edilir Neden? Kullanıcılar için oynatılacak medyayı belirlemek üzere Google'ın ve diğer sinyallerin kullandığı puandır. Bu puan, içeriğin kataloğunuzdaki diğer içeriklere kıyasla popülerliğini temsil eder. Bu nedenle, puan ölçeğinin feed'leriniz ve kataloğunuzdaki tüm öğeler arasında tutarlı olması gerekir. Varsayılan olarak, varlığın popülerlik puanı 0'a ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification seçeneğine ayarla.
popularityScore.value Number Varlığın popülerliğini gösteren, negatif olmayan, sayısal bir değer. yüksek puan, daha yüksek popülerlik anlamına gelir.
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 değerine ayarlıdır.
Note: Yerel ayara özgü popülerlik, dünya genelindeki (EARTH) popülerliğe göre önceliklidir

Örnek

2010'ların pop şarkılarından oluşan özel bir şarkı listesini 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 tesislerle ilgili konular için aşağıdaki sayfalara göz atın: