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

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

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

الخاصية النوع المتوقّع الوصف
@context النص مطلوبة: يتم ضبطها دائمًا على ["http://schema.googleapis.com", {"@language": "xx"}].
  • حيث تمثل ""xx"وليد لغة السلاسل في الخلاصة. يجب ضبط @language في سياق الجذر الجذري على رمز اللغة المناسب بتنسيق 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 إلى صفحة وصف المحتوى التي لم يحظرها نظام حظر الاشتراك غير المدفوع.
وبالنسبة إلى الرابط لموضع معيّن ضمن التشغيل، اطّلِع على خاصية target الكائن، urlTemplate بدلاً من ذلك.
name النص مطلوبة: اسم قائمة التشغيل، مثل "Funky Jazz Mix"
genre النص مطلوبة إذا كانت قائمة التشغيل تتضمّن مزيجًا من أنواع الموسيقى: قائمة بالكلمات الرئيسية الخاصة بالنوع الذي تمثّله قائمة التشغيل. إنّ ظهور هذا الموقع الإلكتروني يشير إلى Google أنّك تنوي إنشاء قائمة تشغيل من هذا النوع.
numTracks عدد صحيح مطلوبة إذا كانت قائمة التشغيل تشكيلة منظّمة: عدد المقاطع الصوتية في قائمة التشغيل. يشير توفّر هذا الموقع الإلكتروني إلى Google بأنّ قائمة التشغيل هذه منظّمة يدويًا. ويشير عدم توفّر هذه السمة إلى أنّ قائمة التشغيل تتضمّن عددًا لا نهائي من قوائم التشغيل.
potentialAction ListenAction مطلوبة: هي كائن ترميز "الإجراء" يوفّر تفاصيل الإجراء. للتعرُّف على التفاصيل، يُرجى الاطّلاع على خصائص ترميز الإجراءات.
image ImageObject صورة قائمة التشغيل التي تمثّل قائمة التشغيل أو التشكيلة الموسيقية راجِع سمات ترميز الصور.
creator مؤسسة أو شخص يظهر لك هذا الاقتراح إذا كان منشئ المحتوى ينال اهتمامًا كبيرًا. استخدِم هذه السمة للإشارة إلى قوائم التشغيل التي أنشأتها الخدمة التي تقدّمها (بوصفها مؤسسة، في حين أنّها تتضمّن السمة name وتشير إلى خدمتك) أو مستخدم يهتم كثيرًا بخدمتك (بوصفها شخص مع الخاصية name التي تشير إلى المستخدم المهتم).
keywords النص قائمة بالكلمات الرئيسية ("rock","pop") أو الحالة المزاجية ("happy" أو "moody") أو الأنشطة ("exercise"&&;;relaxing") أو عبارات أخرى مرتبطة بقائمة التشغيل.
description النص وصف مختصر لقائمة التشغيل. عدد الأحرف المسموح به 300 حرف.
isFamilyFriendly منطقي تحدّد هذه العلامة ما إذا كان هذا المحتوى مناسبًا لجميع أفراد العائلة (أي أنّ المحتوى مناسب لجميع أفراد العائلة، بما في ذلك الأطفال). قد تستخدم منتجات Google isFamilyFriendly عند تحديد أغنية لتشغيلها.
popularityScore مواصفات مدى الرواج يُنصح بشدة باستخدام السبب. نتيجة تستخدِمها Google، بالإضافة إلى إشارات أخرى لتحديد الوسائط التي يجب تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى بالنسبة إلى محتوى آخر في الكتالوج، وبالتالي يجب أن يكون مقياس "النتيجة" متناسقًا في جميع خلاصاتك. يتم ضبط درجة رواج الكيان تلقائيًا على 0.
popularityScore.@type النص يتم ضبطها دائمًا على PopularityScoreSpecification.
popularityScore.value Number قيمة رقمية غير سالبة تشير إلى مدى رواج الكيان، في حين تعني النتيجة الأعلى رواجًا أكبر.
popularityScore.eligibleRegion البلد المناطق التي تنطبق فيها نتيجة الرواج هذه. إذا كانت نتيجة مدى الرواج سارية عالميًا، اضبطها على EARTH. تمّ ضبط هذا الموقع تلقائيًا على EARTH.
Note: يحظى رواج اللغة المحلية بالأولوية مقارنةً بشهرة (EARTH) العالمية

مثال

مثال على قائمة تشغيل منظّمة بأغاني البوب من القرن العشرين:

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

اطّلِع على الصفحات التالية للمواضيع ذات الصلة بهذه السمات: