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

Bu bölümde, MusicPlaylist varlık türü için içerik işaretleme özelliklerinin ayrıntıları sunulmaktadı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ı, @language (dil) BCP 47 biçiminde uygun dil koduna ayarlanmış olmalıdır. Örneğin, dil İspanyolcaya ayarlanırsa altyazının/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: İçerik tanımlayıcının URI biçiminde olması gerekir. Örneğin, https://example.com/1234abc.
@id aşağıdaki şartları karşılamalıdır:
  • Kataloğunuzda tüm dünyada benzersiz
  • Statik; Kimlik sabit olmalı ve zaman içinde değişmemelidir (programın URL özelliği değişse bile). Opak dize olarak işlenir ve çalışan bir bağlantı olması gerekmez.
  • Birleşik Kaynak Tanımlayıcısı (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 gereksinimleri karşıladığı için @id olarak bir tüzel kişinin url türünü kullanmanızı öneririz. Daha fazla bilgi için Tanımlayıcı bölümünü inceleyin.
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 gereksinimleri karşılamalıdır:
  • url tüm dünyada 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 yönlendirmelidir.
Oynatmanın derin bağlantısı için bunun yerine hedef nesnenin urlTemplate özelliğine bakın.
name Metin Zorunlu - Oynatma listesinin adı; örneğin, "Eğlenceli Caz Mix".
genre Metin Oynatma listesi bir tür karışımıysa gereklidir: Oynatma listesinin temsil ettiği türe özgü anahtar kelimelerin listesi. Bu özelliğin varlığı, Google'a bu oynatma listesinin bir tür oynatma listesi olmasını istediğinizi bildirir.
numTracks Integer Oynatma listesi seçilmiş bir mix ise: Oynatma listesindeki parçaların sayısı. Bu özelliğin varlığı, Google'a bu oynatma listesinin özenle seçildiğini gösterir. Bu özelliğin olmaması, oynatma listesinin otomatik olarak oluşturulmuş 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 konusuna bakın.
image ImageObject Oynatma listesini veya müzik karışımını temsil eden bir oynatma listesi resmi. Resim işaretleme özellikleri konusuna bakın.
creator Kuruluş veya Kişi İçerik üreticinin ilgisi yüksekse önerilir. Hizmetiniz tarafından oluşturulan oynatma listelerini belirtmek için bu özelliği kullanın (hizmetinizi name ifadesiyle Kuruluş olarak yazılır) veya yüksek düzeyde ilgi gösteren bir kullanıcınızı (name mülküyle ilgilenen kullanıcı olduğunu belirten, Kişi olarak yazılır).
keywords Metin Anahtar kelime listesi ("rock", "pop", ruh halleri), ruh halleri, aktiviteler ("egzersiz", "relaxing" ve oynatma listesi ile ilgili diğer terimler).
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ı gösterir (yani içerik, çocuklar dahil olmak üzere ailenin tüm üyeleri için uygundur). Google ürünleri, çalınacak şarkıyı belirlerken isFamilyFriendly özelliğini kullanabilir.
popularityScore Popülerlik Puanı Spesifikasyonu Önemle tavsiye edilir Neden? Google'ın, kullanıcılar için hangi medyayı oynatacağını belirlemek üzere kullandığı puan ve diğer sinyaller. Bu puan, kataloğunuzdaki diğer içeriklere göre içeriğin popülerliğini gösterir. Bu nedenle, puan ölçeğinin kataloğunuzdaki tüm varlıklar arasında feed'leriniz arasında tutarlı olması gerekir. Varsayılan olarak, varlığın popülerlik puanı 0 olarak ayarlanır.
popularityScore.@type Metin Her zaman PopularityScoreSpecification olarak ayarlayın.
popularityScore.value Number Varlığın popülerliğini belirten negatif olmayan sayısal değer. Yüksek puan, popülerliğin yüksek olduğu 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 ayarlanmıştır.
Note: Yerele özel popülerlik, dünya genelinde (EARTH) popülerliğe göre önceliklidir

Örnek

2010'ların popüler şarkılarını manuel olarak içeren 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: