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

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

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

على سبيل المثال، الصورة المتحركة المعروفة باسم "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 مطلوب في حال كان ذلك منطبقًا: هو كائن ترميز للإجراءات يوفّر تفاصيل الإجراء.
  • إذا كان المحتوى متاحًا على فيديو عند الطلب (VoD)، تكون هذه السمة مطلوبة. يجب أن يوفر كائن ترميز "الإجراء" رابطًا لموضع معيّن للمحتوى.
  • إذا كان المحتوى متاحًا على قناة بث تلفزيوني مباشر، تكون هذه السمة اختيارية. يوفّر كيان BroadcastService المرتبط رابطًا لموضع معيّن في القناة بدلاً من ذلك.
  • يمكن أن يتوفّر Movie على كلّ من الفيديو عند الطلب والتلفزيون المباشر.
استخدِم مصفوفة لتحديد روابط مختلفة لصفحات في التطبيق في مناطق متعدّدة. راجِع مثال مناطق ولغات متعدّدة.
sameAs URL فيديو مقترَح بشدة لماذا؟ عنوان URL لصفحة ويب مرجعية يمكن من خلالها التعرّف على الفيلم على سبيل المثال، صفحة الفيلم ويكيبيديا. يجب أن يكون مختلفًا عن السمة url.
inLanguage Text اللغة الأصلية للفيلم بتنسيق BCP 47
genre Text قائمة مُرتبة بجميع الأنواع ذات الصلة. على سبيل المثال : ["الإجراء", "الموضة", "البيئة", "كرة القدم"]
keywords Text الكلمات الرئيسية أو العلامات المستخدمة لوصف هذا المحتوى. يُسمح أيضًا باستخدام مصفوفة من الكلمات الرئيسية. على سبيل المثال، يمكن أن تكون ["feature, السيرة الذاتية"] مجموعة من الكلمات الرئيسية لوصف المحتوى.
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 - تاريخ بدء نشر الكيان.

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

بالنسبة إلى ExclusiveEvent وFeaturedEvent، يشير هذا إلى تاريخ البدء الذي تم فيه عرض الكيان بشكل حصري أو لتاريخ العرض.PublicationEvent
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". اطّلِع على قائمة الوكالات.
  • قيمة "التقييم غير معروف" (غير حساسة لحالة الأحرف) للإشارة إلى أنك لا تعرف تقييم الفيلم.
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: تحظى الشعبية الخاصة باللغة المحلية بالأولوية على مدى رواجها على مستوى العالم (إيرث)
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"
}

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