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

يقدّم هذا القسم تفاصيل خصائص ترميز المحتوى لنوع الكيان 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 للعنصر target بدلاً من ذلك.
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: تحظى الشعبية الخاصة باللغة المحلية بالأولوية على مدى رواجها على مستوى العالم (إيرث)

مثال

مثال يحتوي على قائمة تشغيل منظَّمة يدويًا لأغاني البوب في العقد الثاني من القرن الـ 20:

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

اطلع على الصفحات التالية للحصول على الموضوعات ذات الصلة بهذه الخصائص: