ویژگی های نشانه گذاری محتوای لیست های پخش موسیقی

این بخش جزئیات ویژگی های نشانه گذاری محتوا را برای نوع موجودیت MusicPlaylist ارائه می دهد.

جدول مشخصات

ویژگی نوع مورد انتظار شرح
@context متن مورد نیاز - همیشه روی ["http://schema.googleapis.com", {"@language": "xx"}] تنظیم شود.
  • جایی که "xx" نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید زبان @ آن را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، فرض می شود که نام ها به زبان اسپانیایی باشند، حتی اگر زبان زیرنویس/دوبله به زبان انگلیسی باشد.
@type متن مورد نیاز - همیشه برای میکس روی MusicPlaylist تنظیم شود.
@id URL مورد نیاز - شناسه محتوا در قالب URI. برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • در سراسر کاتالوگ شما منحصر به فرد است
  • استاتیک؛ شناسه باید پایدار باشد و در طول زمان تغییر نکند (حتی اگر ویژگی url نمایش تغییر کند). به عنوان یک رشته مات در نظر گرفته می شود و لازم نیست یک پیوند کاری باشد.
  • در قالب شناسه منبع یکپارچه (URI)
  • دامنه استفاده شده برای مقدار ID @ باید متعلق به سازمان شما باشد.
از آنجایی که url یک موجودیت همه الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url موجودیت به‌عنوان @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
url URL الزامی - URL متعارف محتوا، که Google از آن برای مطابقت محتوای موجود در فید شما با محتوای پایگاه داده Google استفاده می کند.
url باید شرایط زیر را داشته باشد:
  • url باید در سطح جهانی منحصر به فرد باشد
  • url باید حاوی یک URL معمولی باشد که Google بتواند آن را بخزد.
  • url باید به صفحه توضیحات محتوا اشاره کند که توسط paywall مسدود نشده است.
برای پیوند عمیق پخش، به جای آن ویژگی urlTemplate شی مورد نظر را ببینید.
name متن مورد نیاز - نام لیست پخش، به عنوان مثال "Funky Jazz Mix".
  • از یک آرایه برای فهرست کردن نام ها به زبان های مختلف استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
genre متن اگر فهرست پخش ترکیبی از ژانر باشد، الزامی است - فهرستی از کلمات کلیدی خاص برای ژانری که لیست پخش نشان‌دهنده آن است. وجود این ویژگی به گوگل نشان می دهد که شما قصد دارید این لیست پخش یک لیست پخش سبک باشد.
numTracks عدد صحیح اگر لیست پخش ترکیبی انتخاب شده باشد، الزامی است - تعداد آهنگ‌های موجود در فهرست پخش. وجود این ویژگی به گوگل نشان می دهد که این لیست پخش دستی تنظیم شده است. عدم وجود این ویژگی نشان می دهد که لیست پخش یک لیست پخش بی پایان است که به صورت خودکار تولید می شود.
potentialAction ListenAction مورد نیاز - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. برای جزئیات بیشتر به ویژگی های نشانه گذاری اقدام مراجعه کنید.
image ImageObject یک تصویر لیست پخش که نشان دهنده لیست پخش یا ترکیب موسیقی است. ویژگی های نشانه گذاری تصویر را ببینید.
creator سازمان یا شخص توصیه می شود اگر سازنده علاقه زیادی دارد. از این ویژگی برای نشان دادن لیست‌های پخش ایجاد شده توسط سرویس خود (تایپ شده به عنوان Organisation با ویژگی name آن نشان دهنده خدمات شما) یا یک کاربر با علاقه بالا از سرویس خود (به عنوان Person با ویژگی name آن نشان دهنده کاربر مورد علاقه) استفاده کنید.
keywords متن فهرستی از کلمات کلیدی ("راک"، "پاپ")، حالت‌ها ("شاد"، "خوش خلق")، فعالیت‌ها ("ورزش"، "آرام‌شدن")، یا سایر عبارات مرتبط با لیست پخش.
description متن توضیح مختصری از لیست پخش محدودیت 300 کاراکتر
  • از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
isFamilyFriendly بولی نشان می دهد که آیا این محتوا برای خانواده مناسب است یا نه (یعنی محتوا برای همه اعضای یک خانواده از جمله کودکان مناسب است). هنگام تعیین آهنگی برای پخش، ممکن است محصولات Google از isFamilyFriendly استفاده کنند.
popularityScore PopularityScoreSpecification بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن به‌علاوه سیگنال‌های دیگر استفاده می‌کند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است.
popularityScore.@type متن همیشه روی PopularityScoreSpecification تنظیم شود.
popularityScore.value عدد یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است.
popularityScore.eligibleRegion کشور منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی EARTH تنظیم کنید. به طور پیش فرض، این ویژگی روی EARTH تنظیم شده است.
Note: محبوبیت خاص محلی بر محبوبیت جهانی (EARTH) اولویت دارد

مثال

مثالی که حاوی یک لیست پخش دستی از آهنگ های پاپ دهه 2010 است:

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

برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید: