يقدّم هذا القسم تفاصيل حول خصائص ترميز المحتوى لنوع الكيان Movie.
جدول المواصفات
| الموقع | النوع المتوقّع | الوصف |
|---|---|---|
@context |
Text | مطلوب: يتم ضبطه دائمًا على ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | مطلوبة: يجب ضبطها دائمًا على Movie للأفلام. |
@id |
URL | مطلوبة: معرّف المحتوى بتنسيق معرّف الموارد المنتظم (URI)، مثلاً https://example.com/1234abc.@id يجب أن يستوفي المتطلبات التالية:
url الخاص بالكيان يستوفي جميع المتطلبات كمعرّف، ننصحك باستخدام url الخاص بالكيان كـ @id. راجِع قسم المعرّف لمزيد من التفاصيل. |
url |
URL | مطلوبة: عنوان URL الأساسي للمحتوى، والذي يستخدمه محرّك بحث Google لمطابقة المحتوى في خلاصتك مع المحتوى في قواعد بيانات Google.url يجب أن يستوفي المتطلبات التالية:
urlTemplate الخاصة بالعنصر target بدلاً من ذلك. |
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 | مطلوبة إذا كان ذلك منطبقًا: عنصر ترميز الإجراء الذي يقدّم تفاصيل الإجراء.
|
sameAs |
URL | يُنصح به بشدة لماذا؟ تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد الفيلم، مثل صفحة الفيلم على "ويكيبيديا". يجب أن يكون هذا العنوان مختلفًا عن الخاصية url. |
inLanguage |
Text | يُنصح به بشدة: اللغة الأصلية للفيلم بتنسيق BCP 47 |
genre |
Text | قائمة مرتّبة بجميع الأنواع ذات الصلة على سبيل المثال : ["أكشن"، "موضة"، "بيئة"، "كرة قدم"] |
keywords |
Text | الكلمات الرئيسية أو العلامات المستخدَمة لوصف هذا المحتوى يُسمح أيضًا باستخدام مجموعة من الكلمات الرئيسية. على سبيل المثال، يمكن أن تكون ["feature, biography"] مصفوفة من الكلمات الرئيسية لوصف المحتوى. |
releasedEvent |
PublicationEvent أو FeaturedEvent أو ExclusiveEvent |
يُنصح به بشدة لماذا؟ - يُستخدَم PublicationEvent لتحديد تاريخ الإصدار الأصلي (العالمي أو المحلي) للمحتوى من قِبل الناشر، مثل تاريخ الإصدار السينمائي الأصلي لفيلم.بالإضافة إلى ذلك، استخدِم FeaturedEvent للإشارة إلى أنّ خدمتك تسوّق هذا المحتوى على أنّه محتوى أصلي أو مميّز أو خاص أو غير ذلك.يشير ExclusiveEvent إلى أنّ خدمتك لديها حقوق توزيع حصرية، ويشمل ذلك المكان والوقت.راجِع قسم الأمثلة للحصول على التفاصيل والأمثلة. |
releasedEvent.@type |
Text | مطلوبة: احرص على ضبط هذه السمة دائمًا على إحدى القيم التالية:
|
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 |
نص أو تقييم | مطلوب للمحتوى المخصّص للبالغين، ويُنصح به بشدة في الحالات الأخرى لماذا؟ - تقييم المحتوى بشكل عام إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، سيتم قبول صيغتين:
|
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 على أي مما يلي:
|
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 | مطلوبة: تحدّد هذه السمة نوع خيار الفيلم لنسخة معيّنة. اضبط الفئة على أيّ مما يلي:
|
مثال
الفيلم الرئيسي
فيلم يتضمّن نسخة معدّلة.
{
"@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"
}
صفحات ذات صلة
يمكنك الاطّلاع على الصفحات التالية للاطّلاع على المواضيع ذات الصلة بهذه المواقع: