خصائص ترميز محتوى الأفلام

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

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

الموقع النوع المتوقّع الوصف
@context Text مطلوب: يتم ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}]
  • حيث يمثّل"xx" لغة السلاسل في الخلاصة. يجب ضبط السمة @language في كل سياق كيان جذر على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، يُفترض أن تكون الأسماء باللغة الإسبانية حتى لو كانت لغة الترجمة أو الدبلجة هي الإنجليزية.
@type Text مطلوبة: يتم ضبطها دائمًا على Movie للأفلام.
@id URL مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، على سبيل المثال، https://example.com/1234abc.
@id يجب أن تستوفي المتطلبات التالية:
  • فريد على مستوى العالم في جميع قنوات التسويق
  • ثابتة: يجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت (حتى إذا تغيّرت خاصية url للعرض). وسيتم التعامل معه كسلسلة مبهمة ولا يلزم أن يكون رابطًا منشورًا.
  • في شكل معرّف موارد موحّد (URI)
  • يجب أن يكون النطاق المستخدَم في القيمة @id مملوكًا لمؤسستك.
بما أنّ url للكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url للكيان كـ @id. راجِع قسم المعرّف للحصول على مزيد من التفاصيل.
url URL مطلوبة: عنوان URL الأساسي للمحتوى، والذي يستخدمه محرّك بحث Google لمطابقة المحتوى في خلاصتك مع المحتوى في قواعد بيانات Google.
url يجب أن يستوفي العنوان المتطلبات التالية:
  • يجب أن يكون url فريدًا على مستوى العالم.
  • يجب أن يحتوي url على عنوان URL أساسي صالح يمكن لمحرّك بحث Google الزحف إليه.
بالنسبة إلى الرابط لصفحة في التطبيق الخاص بميزة التشغيل، اطّلِع على سمة urlTemplate الخاصة بعنصر الهدف بدلاً من ذلك.
name Text سمة مطلوبة: اسم الفيلم.
  • استخدِم صفيفًا لعرض الأسماء بلغات مختلفة. اطّلِع على مثال مناطق ولغات متعدّدة.
  • يُرجى العلم أنّه يمكن استخدام اسم واحد فقط لكل لغة (زوج لغة-بلد).
titleEIDR Text إجراءات مقترَحة بشدة لماذا؟ ‫- معرّف EIDR (Entertainment Identifier Registry) الذي يمثّل على المستوى الأكثر عمومية/تجريدية فيلمًا أو برنامجًا تلفزيونيًا

على سبيل المثال، عنوانEIDR للفيلم السينمائي المعروف باسم "Ghostbusters" هو "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Text إجراء مقترَح بشدة لماذا؟ ‫- معرّف EIDR (Entertainment Identifier Registry) الذي يمثّل نسخة معيّنة من فيلم أو برنامج تلفزيوني

على سبيل المثال، الفيلم السينمائي المعروف باسم "Ghostbusters" الذي يحمل رقم تعريف عنوان EIDR‏ "10.5240/7EC7-228A-510A-053E-CBB8-J"، يتضمّن عدة نُسخ، مثل "10.5240/1F2A-E1C5-680A-14C6-E76B-I" و "10.5240/8A35-3BEE-6497-5D12-9E4F-3". يجب إدخال السمة

titleEIDR عند تقديم editEIDR.
potentialAction WatchAction مطلوبة إذا كان ذلك منطبقًا: عنصر ترميز الإجراء الذي يقدّم تفاصيل الإجراء
  • إذا كان المحتوى متوفّرًا عند الطلب، يجب إدخال هذه السمة. ويجب أن يقدّم عنصر ترميز الإجراء رابطًا لصفحة في التطبيق يؤدي إلى المحتوى.
  • إذا كان المحتوى متوفّرًا على قناة LiveTV، يكون هذا الحقل اختياريًا، ويقدّم العنصر BroadcastService المرتبط رابطًا لصفحة القناة بدلاً من ذلك.
  • يمكن أن يكون Movie متوفّرًا في كلّ من الفيديوهات عند الطلب والبث المباشر.
استخدِم مصفوفة لتحديد روابط مختلفة لصفحات معيّنة في مناطق متعدّدة. اطّلِع على مثال مناطق ولغات متعدّدة.
sameAs URL إجراء مقترَح بشدة لماذا؟ عنوان URL لصفحة ويب مرجعية يمكنها تحديد الفيلم، مثل صفحة الفيلم على "ويكيبيديا" يجب أن يكون هذا العنوان مختلفًا عن عنوان السمة url.
inLanguage Text اللغة الأصلية للفيلم بتنسيق BCP 47
genre Text قائمة بجميع الأنواع ذات الصلة على سبيل المثال : ["حركة"، "موضة"، "بيئة"، "كرة قدم"]
keywords Text الكلمات الرئيسية أو العلامات المستخدَمة لوصف هذا المحتوى يُسمح أيضًا بصفيف من الكلمات الرئيسية. على سبيل المثال، يمكن أن يكون ["feature, biography"] صفيفًا من الكلمات الرئيسية لوصف المحتوى.
releasedEvent PublicationEvent أو FeaturedEvent أو ExclusiveEvent إجراء مقترَح بشدة لماذا؟ - يُستخدَم الرمز PublicationEvent لتحديد تاريخ الإصدار الأصلي (العالمي أو المحلي) للمحتوى من قِبل الناشر، مثل تاريخ الإصدار الأصلي للفيلم في دور العرض.

بالإضافة إلى ذلك، استخدِم الرمز FeaturedEvent للإشارة إلى أنّ خدمتك تسوّق هذا المحتوى على أنّه أصلي أو مميّز أو خاص وما إلى ذلك.

يحدد الرمز ExclusiveEvent أنّ خدمتك تمتلك حقوق التوزيع الحصرية، ويشمل ذلك مكان الإصدار والوقت.

اطّلِع على قسم الأمثلة للاطّلاع على التفاصيل والأمثلة.
releasedEvent.@type Text سمة مطلوبة: احرص على ضبط هذه السمة دائمًا على إحدى القيم التالية:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location البلد سمة مطلوبة: المناطق المرتبطة بهذا الحدث.

بالنسبة إلى PublicationEvent، هذه هي المنطقة التي تم نشر المحتوى فيها.

بالنسبة إلى FeaturedEvent وExclusiveEvent، هذه هي المنطقة التي يظهر فيها المحتوى أو يكون فيها حصريًا.

استخدِم رموز ISO 3166 للبلدان. للإشارة إلى أي مكان في العالم، اضبط القيمة على EARTH.
releasedEvent.startDate Date أو DateTime مُقترَح - مطلوبة لعنصر ExclusiveEvent: تاريخ بدء نشر العنصر.

بالنسبة إلى عنصر PublicationEvent، يشير ذلك إلى تاريخ الإصدار الأول لهذا العنصر، مثل تاريخ عرض فيلم لأول مرة في دور العرض.

بالنسبة إلى عنصرَي ExclusiveEvent وFeaturedEvent، يشير ذلك إلى تاريخ بدء عرض العنصر حصريًا أو بشكل بارز.
releasedEvent.endDate Date أو DateTime مُستحسَن - سمة مطلوبة لسمة ExclusiveEvent: لا تنطبق هذه السمة إلا على نوعَي المحتوى ExclusiveEvent وFeaturedEvent.

بالنسبة إلى سمة ExclusiveEvent، يمثّل هذا التاريخ تاريخ انتهاء صلاحية حقوق المحتوى.

بالنسبة إلى سمة FeaturedEvent، يمثّل هذا التاريخ آخر تاريخ عرض فيه الموفّر المحتوى.

إذا كان المحتوى حصريًا أو معروضًا بشكل دائم، اضبط سمة endDate على 20 عامًا من التاريخ الحالي.
releasedEvent.publishedBy Organization أو Person اختياري: المؤسسة أو الشخص الذي نشر هذا الكيان.
description Text إجراءات مقترَحة بشدة لماذا؟ ملخّص للفيلم يُفضّل استخدام ملخّصات القصة بدلاً من الملخّصات الوقائعية. عدد الأحرف المسموح به هو 300 حرف.
duration المدة مدة عرض الفيلم بتنسيق ISO 8601 يُرجى استخدام التنسيق: "PT00H00M".
director الشخص إجراء مقترَح بشدة لماذا؟ تمثّل هذه السمة مخرجي الفيلم.
actor الشخص إجراءات مقترَحة بشدة لماذا؟ تمثّل هذه السمة الممثلين في الفيلم.
producer Organization أو Person إجراءات مقترَحة بشدة لماذا؟ تمثّل هذه السمة منتجي الفيلم.
image ImageObject مطلوبة لأجهزة Google TV: الصور ذات الصلة بالفيلم لمزيد من التفاصيل حول السمات المطلوبة والاختيارية التي يجب تضمينها مع image، اطّلِع على سمات الصورة.
trailer.description Text وصف المقطع الدعائي اطّلِع على مثال المقطع الدعائي.
trailer.inLanguage Text لغة المقطع الدعائي بتنسيق BCP 47
trailer.url URL عنوان URL لمقطع دعائي مستضاف بشكل علني وحمّلته استوديوهات الإنتاج المعنية أو مصادر مفوَّضة
trailer.regionsAllowed مكان المناطق التي يُسمح فيها بعرض الوسائط في حال عدم تحديد هذه السمة، يُفترض أنّه مسموح بعرضه في كل مكان. حدِّد البلدان بتنسيق ISO 3166.
identifier PropertyValue إجراءات مقترَحة بشدة لماذا؟ ‫- المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح يُسمح باستخدام عدّة معرّفات. راجِع قسم خصائص المعرّف للحصول على التفاصيل.
review مراجعة تقييمات المراجعات للفيلم
review.reviewRating التقييم مطلوبة في حال تقديم مراجعة تُستخدَم هذه السمة لتحديد التقييم الذي تم منحه في المراجعة.
contentRating Text أو Rating يجب توفيره إذا كان المحتوى مخصّصًا للبالغين، ويُنصح بشدة بتوفيره في جميع الحالات الأخرى. لماذا؟ - التقييم العام للمحتوى إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، يتم قبول الصيغتَين التاليتَين:
  • وكالة التقييم التي تُضاف قبل التقييم مع ترك مسافة بين الاسم والتقييم على سبيل المثال، يجب وصف التقييم "PG-13" الصادر عن وكالة "MPAA" في الولايات المتحدة على النحو التالي: "MPAA PG-13". اطّلِع على قائمة الوكالات.
  • قيمة "RATING NOT KNOWN" (لا تُراعي حالة الأحرف) للإشارة إلى أنّك لا تعرف تقييم الفيلم
contentRating.author المؤسسة مطلوبة إذا كان contentRating يستخدم Rating: اسم وكالة التقييم.
contentRating.ratingValue Text سمة مطلوبة إذا كان contentRating يستخدم Rating: قيمة التقييم.
contentRating.advisoryCode Text الرمز الإرشادي للمحتوى تشمل القيم المقبولة D وFV وL وS وV. D = حوار، وFV = عنف خيالي، وL = لغة، وS = محتوى جنسي، وV = عنف.
popularityScore PopularityScoreSpecification إجراء مقترَح بشدة لماذا؟ هي نتيجة تستخدمها Google، بالإضافة إلى إشارات أخرى، لتحديد الوسائط التي يتم تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى مقارنةً بالمحتوى الآخر في قائمتك، لذا يجب أن يكون مقياس النتيجة متسقًا في خلاصاتك، وبين جميع العناصر في قائمتك. يتم ضبط نتيجة مدى رواج الكيانات تلقائيًا على 0.
popularityScore.@type Text يتم ضبطه دائمًا على PopularityScoreSpecification.
popularityScore.value Number قيمة رقمية غير سالبة تشير إلى مدى رواج العنصر. وكلما ارتفعت القيمة، ارتفع مدى الرواج.
popularityScore.eligibleRegion البلد المناطق التي تنطبق فيها نتيجة مدى الانتشار هذه إذا كانت نتيجة مدى الرواج سارية على مستوى العالم، اضبطها على EARTH. يتم ضبط هذه السمة تلقائيًا على EARTH.
Note: تُعطى الأولوية للمحتوى الرائج في لغة معيّنة على المحتوى الرائج على مستوى العالم (EARTH).
category Text سمة مطلوبة إذا كان ذلك منطبقًا: يجب تعبئة هذه السمة إذا كان الكيان خيارًا من خيارات Movie. اضبط category على أيٍّ ممّا يلي:
  • Home Release: نسخة تم بيعها أو تأجيرها لمشاهدتها في المنزل
  • Theatrical Release: نسخة تم عرضها في دور السينما
  • International Release: نسخة تم تعديلها للإصدار على مستوى العالم
  • Remastered: نسخة تم تحسين صورها أو صوتها أو كليهما وفقًا لمعيار أحدث
  • Unrated: نسخة لم تفحصها جمعية MPAA أو وكالة مشابهة
  • Director Cut: نسخة تمثّل التعديل الذي تمت الموافقة عليه من قِبل المخرج
  • Extended Cut: نسخة أطول من النسخة المعروضة في دور العرض
workExample فيلم تُستخدَم لتحديد الصيغ المختلفة للفيلم. يجب تضمين هذه السمة في عنصر Movie الرئيسي، وليس في عناصر Movie لإصدارات الأسعار المتغيرة.
workExample.@id URL بالنسبة إلى خيارات المنتج Movie، تقدّم هذه السمة @id للوحدة Movie التي تشكّل خيارًا منها.
workExample.@type Text مطلوبة: يتم ضبطها دائمًا على Movie. ويمكن تمثيل ذلك على شكل صفيف لعنصر Movie يتضمّن خيارات متعددة.
workExample.@id URL مطلوبة: @id خيار Movie
workExample.name Text سمة مطلوبة: اسم الصيغة Movie.
workExample.category Text مطلوبة: نوع خيار الفيلم لإصدار معيّن. اضبط الفئة على أيٍّ ممّا يلي:
  • Home Release: نسخة تم بيعها أو تأجيرها لمشاهدتها في المنزل
  • Theatrical Release: نسخة تم عرضها في دور السينما
  • International Release: نسخة تم تعديلها للإصدار على مستوى العالم
  • Remastered: نسخة تم تحسين صورها أو صوتها أو كليهما وفقًا لمعيار أحدث
  • Unrated: نسخة لم تفحصها جمعية MPAA أو وكالة مشابهة
  • Director Cut: نسخة تمثّل التعديل الذي تمت الموافقة عليه من قِبل المخرج
  • Extended Cut: نسخة أطول من النسخة المعروضة في دور العرض

مثال

فيلم يتضمّن نسخة ممتدة

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

نسخة ممتدة من الفيلم الرئيسي

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

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