خصائص ترميز المحتوى الخاصة بقوائم تشغيل الموسيقى

يوفّر هذا القسم تفاصيل خصائص ترميز المحتوى لنوع العنصر MusicPlaylist.

جدول المواصفات

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطها دائمًا على ["http://schema.googleapis.com", {"@language": "xx"}].
  • حيث يمثّل "xx" لغة السلاسل في الخلاصة. يجب ضبط السمة @language في كل سياق كيان جذر على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، يُفترض أن تكون الأسماء باللغة الإسبانية حتى لو كانت لغة الترجمة أو الدبلجة هي الإنجليزية.
@type Text سمة مطلوبة: يتم ضبطها دائمًا على 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 إلى صفحة وصف محتوى غير محظورة بواسطة جدار دفع.
بالنسبة إلى الرابط لصفحة في التطبيق الخاص بميزة التشغيل، اطّلِع على سمة 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."
}

يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع المتعلّقة بهذه المواقع: