يوفّر هذا القسم تفاصيل خصائص ترميز المحتوى لنوع العنصر MusicPlaylist.
جدول المواصفات
| الموقع | النوع المتوقّع | الوصف | 
|---|---|---|
| @context | Text | مطلوب: يتم ضبطها دائمًا على ["http://schema.googleapis.com", {"@language": "xx"}].
 | 
| @type | Text | سمة مطلوبة: يتم ضبطها دائمًا على MusicPlaylistللمزيج. | 
| @id | URL | مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، على سبيل المثال، https://example.com/1234abc. @idيجب أن تستوفي المتطلبات التالية:
 urlللعنصر يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدامurlللعنصر كـ@id. راجِع قسم المعرّف للحصول على مزيد من التفاصيل. | 
| url | URL | مطلوبة: عنوان URL الأساسي للمحتوى، والذي يستخدمه محرّك بحث Google لمطابقة المحتوى في خلاصتك مع المحتوى في قواعد بيانات Google. urlيجب أن يستوفي المتطلبات التالية:
 urlTemplateالخاصة بعنصر الهدف بدلاً من ذلك. | 
| name | Text | سمة مطلوبة: اسم قائمة التشغيل، على سبيل المثال "مزيج من موسيقى الجاز". 
 | 
| genre | Text | مطلوبة إذا كانت قائمة التشغيل تتضمّن أنواعًا مختلفة من المحتوى: قائمة بالكلمات الرئيسية الخاصة بالنوع الذي تمثّله قائمة التشغيل يشير توفّر هذا السمة إلى Google بأنّك تريد أن تكون قائمة التشغيل هذه قائمة تشغيل حسب النوع. | 
| numTracks | عدد صحيح | مطلوبة إذا كانت قائمة التشغيل عبارة عن مجموعة من الأغاني المنظَّمة: عدد الأغاني في قائمة التشغيل يشير ظهور هذا السمة إلى محرّك بحث Google أنّ هذه القائمة منتقاة يدويًا. في حال عدم توفّر هذه السمة، يعني ذلك أنّ قائمة التشغيل هي قائمة تشغيل لا تنتهي يتم إنشاؤها تلقائيًا. | 
| potentialAction | ListenAction | مطلوبة: عنصر تنسيق إجراء يقدّم تفاصيل الإجراء راجِع خصائص تنسيق الإجراء للحصول على التفاصيل. 
 | 
| image | ImageObject | صورة قائمة تشغيل تمثّل قائمة التشغيل أو مجموعة المقاطع الصوتية راجِع خصائص ترميز الصور. | 
| creator | Organization أو Person | ننصح بهذا الإجراء إذا كان صانع المحتوى يحظى باهتمام كبير. استخدِم هذه السمة للإشارة إلى قوائم التشغيل التي أنشأتها خدمتك (تُكتب على النحو التالي: مؤسّسة مع السمة nameالتي تشير إلى خدمتك) أو مستخدم مهتم جدًا بخدمتك (يُكتب على النحو التالي: شخص مع السمةnameالتي تشير إلى المستخدم المعنيّ). | 
| keywords | Text | قائمة بالكلمات الرئيسية ("موسيقى الروك"، "موسيقى البوب") أو المشاعر ("سعيد"، "مزاجي") أو الأنشطة ("تمرين"، "استرخاء") أو عبارات أخرى ذات صلة بقائمة التشغيل | 
| description | Text | وصف موجز لقائمة التشغيل عدد الأحرف المسموح به هو 300 حرف. 
 | 
| isFamilyFriendly | صحيح/خطأ | تشير هذه السمة إلى ما إذا كان هذا المحتوى مناسبًا للعائلة (أي أنّه مناسب لجميع أفراد العائلة، بما في ذلك الأطفال). قد تستخدم منتجات Google isFamilyFriendlyعند تحديد أغنية لتشغيلها. | 
| popularityScore | PopularityScoreSpecification | إجراء مقترَح بشدة لماذا؟ هي نتيجة تستخدمها Google، بالإضافة إلى إشارات أخرى، لتحديد الوسائط التي يتم تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى مقارنةً بالمحتوى الآخر في قائمتك، لذا يجب أن يكون مقياس النتيجة متسقًا في خلاصاتك، وبين جميع العناصر في قائمتك. يتم ضبط نتيجة مدى رواج الكيانات تلقائيًا على 0. | 
| popularityScore.@type | Text | يتم ضبطه دائمًا على PopularityScoreSpecification. | 
| popularityScore.value | Number | قيمة رقمية غير سالبة تشير إلى مدى رواج العنصر. وكلما ارتفعت القيمة، ارتفع مدى الرواج. | 
| 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."
}
صفحات ذات صلة
يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع المتعلّقة بهذه المواقع: