خصائص ترميز المحتوى للبرامج التلفزيونية

يقدّم هذا القسم تفاصيل حول سمات ترميز المحتوى لأنواع العناصر TVSeries وTVEpisode وTVSeason.

إنّ تقديم TVSeason ككيان كامل هو أمر اختياري. راجِع قسم علاقات TVSeries وTVSeason وTVEpisode للحصول على التفاصيل.

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

TVSeries

الموقع	النوع المتوقّع	الوصف
`@context`	Text	مطلوب: يتم ضبطه دائمًا على `["http://schema.org", {"@language": "xx"}]` يمثّل"xx" لغة السلاسل في الخلاصة. يجب ضبط @language لكل سياق كيان رئيسي على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، يُفترض أنّ الأسماء باللغة الإسبانية حتى لو كانت لغة الترجمة والشرح باللغة الإنجليزية.
`@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVSeries`.
`@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 (Entertainment Identifier Registry) يمثّل على المستوى العام أو المجرد، عملاً سينمائيًا أو تلفزيونيًا. على سبيل المثال، المعرّف EIDR الخاص بالبرنامج التلفزيوني المعروف باسم "صراع العروش" هو "10.5240/C1B5-3BA1-8991-A571-8472-W".
`potentialAction`	WatchAction	مطلوبة إذا كان ذلك منطبقًا: عنصر ترميز الإجراء الذي يقدّم تفاصيل الإجراء. إذا كان المحتوى متاحًا على خدمة "الفيديو عند الطلب" (VoD)، يجب تضمين هذه السمة، ويجب أن يوفّر عنصر ترميز الإجراء رابطًا لصفحة معيّنة للمحتوى. إذا كان المحتوى متاحًا على قناة LiveTV، يكون هذا العنصر اختياريًا، إذ يوفّر العنصر المرتبط `BroadcastService` الرابط لصفحة معيّنة من القناة بدلاً من ذلك. يمكن أن يتوفّر `TVSeries` على كلّ من VoD وLiveTV. استخدِم مصفوفة لتحديد روابط مختلفة لصفحات معيّنة في مناطق متعددة. راجِع مثال المناطق واللغات المتعددة.
`sameAs`	URL	يُنصح به بشدة لماذا؟ تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد البرنامج التلفزيوني، مثل صفحة البرنامج على "ويكيبيديا". يجب أن يكون هذا العنوان مختلفًا عن الخاصية `url`.
`inLanguage`	Text	يُنصح به بشدة: اللغة الأصلية للمسلسل بتنسيق BCP 47
`genre`	Text	قائمة مرتّبة بجميع الأنواع ذات الصلة على سبيل المثال : `["Action", "Fashion", "Environment", "Football"]`
`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 حرف. استخدِم مصفوفة لترميز الوصف بلغات متعددة. راجِع مثال المناطق واللغات المتعددة.
`actor`	Person أو PerformingGroup أو PerformanceRole	يُنصح به بشدة لماذا؟ هي مصفوفة من أعضاء فريق التمثيل في المسلسل. اطّلِع على إرشادات تصميم النماذج هنا.
`director`	الشخص	يُنصح به بشدة لماذا؟ تمثّل هذه السمة مُخرِجي البرنامج التلفزيوني.
`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	يُنصح به بشدة لماذا؟ - المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح. يُسمح باستخدام عدّة معرّفات. راجِع قسم سمات المعرّف للحصول على التفاصيل.
`popularityScore`	PopularityScoreSpecification	يُنصح به بشدة لماذا؟ هي عبارة عن نتيجة تستخدمها Google، بالإضافة إلى إشارات أخرى، لتحديد الوسائط التي سيتم تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى مقارنةً بالمحتوى الآخر في الكتالوج، لذا يجب أن يكون مقياس النتيجة متسقًا في جميع خلاصاتك، أي بين جميع العناصر في الكتالوج. يتم ضبط نتيجة رواج الكيان تلقائيًا على 0.
`popularityScore.@type`	Text	يجب ضبطها دائمًا على `PopularityScoreSpecification`.
`popularityScore.value`	Number	قيمة رقمية غير سالبة تشير إلى مدى رواج العنصر، وكلما كانت النتيجة أعلى، كان العنصر أكثر رواجًا.
`popularityScore.eligibleRegion`	البلد	المناطق التي ينطبق عليها مقياس الرواج هذا إذا كانت نتيجة مقياس الرواج قابلة للتطبيق على مستوى العالم، اضبط القيمة على `EARTH`. يتم ضبط هذه السمة تلقائيًا على `EARTH`. `Note:` تُعطى الأولوية لمستوى الرواج الخاص باللغة على مستوى الرواج العالمي (EARTH)
`review`	مراجعة	تقييمات المراجعات للمسلسل التلفزيوني
`review.reviewRating`	التقييم	مطلوبة في حال توفير `review` تُستخدَم هذه السمة لتحديد التقييم الممنوح في المراجعة.
`contentRating`	نص أو تقييم	مطلوبة للمحتوى المخصّص للبالغين، ويُنصح بها بشدة في الحالات الأخرى: التقييم العام للمحتوى إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، سيتم قبول صيغتين: وكالة التقييم التي تمّت إضافتها قبل التقييم مع مسافة بيضاء بينهما على سبيل المثال، يجب وصف تصنيف "TV-MA" من وكالة "TVPG" في الولايات المتحدة على النحو التالي: "TVPG TV-MA". اطّلِع على قائمة الوكالات. القيمة "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 = عنف.

TVEpisode

الموقع	النوع المتوقّع	الوصف
`@context`	Text	مطلوب: يتم ضبطه دائمًا على `["http://schema.org", {"@language": "xx"}]` يمثّل"xx" لغة السلاسل في الخلاصة. يجب ضبط @language لكل سياق كيان رئيسي على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، يُفترض أنّ الأسماء باللغة الإسبانية حتى لو كانت لغة الترجمة والشرح باللغة الإنجليزية.
`@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVEpisode`.
`@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 (Entertainment Identifier Registry) يمثّل على المستوى العام أو المجرد، عملاً سينمائيًا أو تلفزيونيًا. على سبيل المثال، عنوان EIDR للحلقة الأولى من الموسم الأول من المسلسل التلفزيوني المعروف باسم "صراع العروش" هو "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Text	يُنصح به بشدة لماذا؟ - معرّف EIDR (Entertainment Identifier Registry) يمثّل تعديلاً أو إصدارًا معيّنًا لعمل سينمائي أو تلفزيوني على سبيل المثال، الحلقة الأولى من الموسم الأول من البرنامج التلفزيوني المعروف باسم "صراع العروش"، والذي يحمل معرّف EIDR للعنوان "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X"، تتضمّن تعديلاً واحدًا، مثل "10.5240/FB97-C847-2969-D0AB-ECD1-C". السمة `titleEIDR` مطلوبة عند توفير editEIDR.
`inLanguage`	Text	مطلوبة بشدة اللغة الأصلية للحلقة بتنسيق BCP 47
`episodeNumber`	عدد صحيح	مطلوب: الرقم الذي يشير إلى موضع هذه الحلقة في ترتيب الحلقات ضمن الموسم. `episodeNumber` يجب إعادة ضبطها لكل موسم، أي يجب أن تكون الحلقة الأولى من كل موسم هي 1.
`partOfSeason`	TVSeason	مطلوبة: تمثّل هذه السمة الموسم التلفزيوني الذي تنتمي إليه الحلقة. حتى إذا لم يكن `TVEpisode` مرتبطًا بـ `TVSeason`، عليك تقديم السمتَين `partOfSeason.@id` و`partOfSeason.seasonNumber`. الحل البديل هو: خذ `partofSeries.@id` (على سبيل المثال، http://www.example.com/my_favorite_tv_show) وأضِف حقل طلب بحث للقيم النائبة (على سبيل المثال، ?season1) لإنشاء `partOfSeason.@id` فريد (على سبيل المثال، http://www.example.com/my_favorite_tv_show?season1). اضبط قيمة `partOfSeason.seasonNumber` على 1.
`partOfSeason.@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVSeason`.
`partOfSeason.@id`	URL	مطلوبة: `@id` `TVSeason` الذي تمثّل هذه الحلقة جزءًا منه.
`partOfSeason.seasonNumber`	عدد صحيح	مطلوب: الرقم الذي يشير إلى موضع هذا الموسم في ترتيب المواسم ضمن المسلسل التلفزيوني.
`partOfSeries`	TVSeries	مطلوبة: تمثّل هذه السمة المسلسل التلفزيوني الذي تنتمي إليه هذه الحلقة.
`partOfSeries.@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVSeries`.
`partOfSeries.@id`	URL	مطلوبة: `@id` `TVSeries` الذي تمثّل هذه الحلقة جزءًا منه.
`partOfSeries.name`	Text	مطلوبة: اسم المسلسل التلفزيوني
`partOfSeries.sameAs`	Text	تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد البرنامج التلفزيوني، مثل صفحة البرنامج على "ويكيبيديا". يجب أن يكون هذا العنوان مختلفًا عن الخاصية `url`.
`potentialAction`	WatchAction	مطلوبة إذا كان ذلك منطبقًا: عنصر ترميز الإجراء الذي يقدّم تفاصيل الإجراء. إذا كان المحتوى متاحًا على خدمة "الفيديو عند الطلب" (VoD)، يجب تضمين هذه السمة، ويجب أن يوفّر عنصر ترميز الإجراء رابطًا لصفحة معيّنة للمحتوى. إذا كان المحتوى متاحًا على قناة LiveTV، يكون هذا العنصر اختياريًا، إذ يوفّر العنصر المرتبط `BroadcastService` الرابط لصفحة معيّنة من القناة بدلاً من ذلك. يمكن أن يتوفّر `TVEpisode` على كلّ من VoD وLiveTV. استخدِم مصفوفة لتحديد روابط مختلفة لصفحات معيّنة في مناطق متعددة. راجِع مثال المناطق واللغات المتعددة.
`sameAs`	يُنصح به بشدة لماذا؟ عنوان URL	تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد الحلقة، مثل صفحة الحلقة على Wikipedia. يجب أن يكون هذا العنوان مختلفًا عن الخاصية `url`.
`duration`	المدة	تمثّل هذه السمة مدة الحلقة بالتنسيق ISO 8601. يُرجى استخدام التنسيق: "PT00H00M".
`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 حرف. استخدِم مصفوفة لترميز الوصف بلغات متعددة. اطّلِع على مثال تمثيل لغات متعددة.
`genre`	Text	قائمة مرتّبة بجميع الأنواع ذات الصلة على سبيل المثال : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Text	الكلمات الرئيسية أو العلامات المستخدَمة لوصف هذا المحتوى يُسمح أيضًا باستخدام مجموعة من الكلمات الرئيسية. على سبيل المثال، يمكن أن تكون ["feature, biography"] مصفوفة من الكلمات الرئيسية لوصف المحتوى.
`actor`	Person أو PerformingGroup أو PerformanceRole	يُنصح به بشدة لماذا؟ هي مصفوفة من الممثلين المشاركين في الحلقة. اطّلِع على إرشادات تصميم النماذج هنا.
`director`	الشخص	يُنصح به بشدة لماذا؟ تمثّل هذه السمة مخرجي الحلقة.
`producer`	Organization أو Person	يُنصح به بشدة لماذا؟ تمثّل هذه الخاصية منتجي الموسم.
`image`	ImageObject	موصى به بشدة لماذا؟ لـ Google TV: صور متنوّعة ذات صلة بالحلقة التلفزيونية للحصول على مزيد من التفاصيل حول السمات المطلوبة والاختيارية التي يجب تضمينها مع `image`، يمكنك الاطّلاع على سمات الصور.
`trailer.description`	Text	تمثّل هذه السمة وصف المقطع الدعائي. اطّلِع على مثال المقطع الدعائي.
`trailer.inLanguage`	Text	يُنصح بشدة: لغة المقطع الدعائي بتنسيق BCP 47
`trailer.url`	URL	عنوان URL لمقطع دعائي مستضاف بشكل علني وتم تحميله من قِبل استوديوهات الإنتاج المعنية أو مصادر معتمَدة
`trailer.regionsAllowed`	مكان	تمثّل هذه السمة المناطق التي يُسمح فيها بعرض الوسائط. في حال عدم تحديد هذه السمة، يُفترض أنّ الفيديو مسموح بعرضه في كل مكان. حدِّد البلدان بالتنسيق ISO 3166.
`review`	مراجعة	مراجعة التقييمات الخاصة بالحلقة التلفزيونية
`review.reviewRating`	التقييم	مطلوبة في حال توفير `review` تُستخدَم هذه السمة لتحديد التقييم الممنوح في المراجعة.
`contentRating`	نص أو تقييم	مطلوبة للمحتوى المخصّص للبالغين، ويُنصح بها بشدة في الحالات الأخرى: التقييم العام للمحتوى إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، سيتم قبول صيغتين: وكالة التقييم التي تمّت إضافتها قبل التقييم مع مسافة بيضاء بينهما على سبيل المثال، يجب وصف تصنيف "TV-MA" من وكالة "TVPG" في الولايات المتحدة على النحو التالي: "TVPG TV-MA". اطّلِع على قائمة الوكالات. القيمة "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 = عنف.
`identifier`	PropertyValue	يُنصح به بشدة لماذا؟ - المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح. يُسمح باستخدام عدّة معرّفات. راجِع قسم سمات المعرّف للحصول على التفاصيل.
`popularityScore`	PopularityScoreSpecification	يُنصح به بشدة لماذا؟ هي عبارة عن نتيجة تستخدمها Google، بالإضافة إلى إشارات أخرى، لتحديد الوسائط التي سيتم تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى مقارنةً بالمحتوى الآخر في الكتالوج، لذا يجب أن يكون مقياس النتيجة متسقًا في جميع خلاصاتك، أي بين جميع العناصر في الكتالوج. يتم ضبط نتيجة رواج الكيان تلقائيًا على 0.
`popularityScore.@type`	Text	يجب ضبطها دائمًا على `PopularityScoreSpecification`.
`popularityScore.value`	Number	قيمة رقمية غير سالبة تشير إلى مدى رواج العنصر، وكلما كانت النتيجة أعلى، كان العنصر أكثر رواجًا.
`popularityScore.eligibleRegion`	البلد	المناطق التي ينطبق عليها مقياس الرواج هذا إذا كانت نتيجة مقياس الرواج قابلة للتطبيق على مستوى العالم، اضبط القيمة على `EARTH`. يتم ضبط هذه السمة تلقائيًا على `EARTH`. `Note:` تُعطى الأولوية لمستوى الرواج الخاص باللغة على مستوى الرواج العالمي (EARTH)

TVSeason

الموقع	النوع المتوقّع	الوصف
`@context`	Text	مطلوب: يتم ضبطه دائمًا على `["http://schema.org", {"@language": "xx"}]` يمثّل"xx" لغة السلاسل في الخلاصة. يجب ضبط @language لكل سياق كيان رئيسي على رمز اللغة المناسب بتنسيق BCP 47. على سبيل المثال، إذا تم ضبط اللغة على الإسبانية، يُفترض أنّ الأسماء باللغة الإسبانية حتى لو كانت لغة الترجمة والشرح باللغة الإنجليزية.
`@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVSeason`.
`@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 (Entertainment Identifier Registry) يمثّل على المستوى العام أو المجرد، عملاً سينمائيًا أو تلفزيونيًا. على سبيل المثال، رقم تعريف EIDR الخاص بالموسم الأول من المسلسل التلفزيوني المعروف باسم "صراع العروش" هو "10.5240/FD91-C72C-4161-FCBA-058B-1".
`seasonNumber`	عدد صحيح	مطلوب: الرقم الذي يشير إلى موضع هذا الموسم في ترتيب المواسم ضمن المسلسل التلفزيوني.
`partOfSeries`	TVSeries	مطلوب: المسلسل التلفزيوني الذي ينتمي إليه هذا الموسم.
`partOfSeries.@type`	Text	مطلوبة: يجب ضبطها دائمًا على `TVSeries`.
`partOfSeries.@id`	URL	مطلوب: `@id` `TVSeries` الذي يمثّل هذا الموسم جزءًا منه.
`partOfSeries.name`	Text	مطلوبة: اسم المسلسل التلفزيوني
`partOfSeries.sameAs`	Text	تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد البرنامج التلفزيوني، مثل صفحة البرنامج على "ويكيبيديا". يجب أن يكون هذا العنوان مختلفًا عن الخاصية `url`.
`potentialAction`	WatchAction	مطلوبة إذا كان ذلك منطبقًا: عنصر ترميز الإجراء الذي يقدّم تفاصيل الإجراء. إذا كان المحتوى متاحًا على خدمة "الفيديو عند الطلب" (VoD)، يجب تضمين هذه السمة، ويجب أن يوفّر عنصر ترميز الإجراء رابطًا لصفحة معيّنة للمحتوى. إذا كان المحتوى متاحًا على قناة LiveTV، يكون هذا العنصر اختياريًا، إذ يوفّر العنصر المرتبط `BroadcastService` الرابط لصفحة معيّنة من القناة بدلاً من ذلك. يمكن أن يتوفّر `TVSeason` على كلّ من VoD وLiveTV. استخدِم مصفوفة لتحديد روابط مختلفة لصفحات معيّنة في مناطق متعددة. راجِع مثال المناطق واللغات المتعددة.
`sameAs`	URL	يُنصح به بشدة لماذا؟ تمثّل هذه السمة عنوان URL لصفحة ويب مرجعية يمكنها تحديد الموسم، مثل صفحة الموسم على "ويكيبيديا". يجب أن يكون هذا العنوان مختلفًا عن الخاصية `url`.
`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 حرف. استخدِم مصفوفة لترميز الوصف بلغات متعددة. اطّلِع على مثال تمثيل لغات متعددة.
`actor`	[Person أو PerformingGroup أو PerformanceRole	يُنصح به بشدة لماذا؟ مصفوفة تضم أعضاء فريق التمثيل في الموسم اطّلِع على إرشادات تصميم النماذج هنا.
`director`	الشخص	يُنصح به بشدة لماذا؟ هي مصفوفة من مخرجي البرنامج.
`producer`	Organization أو Person	يُنصح به بشدة لماذا؟ تمثّل هذه السمة منتجي الموسم.
`image`	ImageObject	تمثّل هذه السمة الصور المرتبطة بـ TVSeason. للحصول على مزيد من التفاصيل حول السمات المطلوبة والاختيارية التي يجب تضمينها مع `image`، يمكنك الاطّلاع على سمات الصور.
`genre`	Text	قائمة مرتّبة بجميع الأنواع ذات الصلة على سبيل المثال : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Text	الكلمات الرئيسية أو العلامات المستخدَمة لوصف هذا المحتوى يُسمح أيضًا باستخدام مجموعة من الكلمات الرئيسية. على سبيل المثال، يمكن أن تكون ["feature, biography"] مصفوفة من الكلمات الرئيسية لوصف المحتوى.
`trailer.description`	Text	تمثّل هذه السمة وصف المقطع الدعائي. اطّلِع على مثال المقطع الدعائي.
`trailer.inLanguage`	Text	يُنصح بشدة: لغة المقطع الدعائي بتنسيق BCP 47
`trailer.url`	URL	عنوان URL لمقطع دعائي مستضاف بشكل علني وتم تحميله من قِبل استوديوهات الإنتاج المعنية أو مصادر معتمَدة
`trailer.regionsAllowed`	مكان	تمثّل هذه السمة المناطق التي يُسمح فيها بعرض الوسائط. في حال عدم تحديد هذه السمة، يُفترض أنّ الفيديو مسموح بعرضه في كل مكان. حدِّد البلدان بالتنسيق ISO 3166.
`identifier`	PropertyValue	يُنصح به بشدة لماذا؟ - المعرّف الخارجي أو المعرّف الآخر الذي يعرّف هذا الكيان بوضوح. يُسمح باستخدام عدّة معرّفات. راجِع قسم سمات المعرّف للحصول على التفاصيل.
`popularityScore`	PopularityScoreSpecification	يُنصح به بشدة لماذا؟ هي عبارة عن نتيجة تستخدمها Google، بالإضافة إلى إشارات أخرى، لتحديد الوسائط التي سيتم تشغيلها للمستخدمين. تمثّل هذه النتيجة مدى رواج المحتوى مقارنةً بالمحتوى الآخر في الكتالوج، لذا يجب أن يكون مقياس النتيجة متسقًا في جميع خلاصاتك، أي بين جميع العناصر في الكتالوج. يتم ضبط نتيجة رواج الكيان تلقائيًا على 0.
`popularityScore.@type`	Text	يجب ضبطها دائمًا على `PopularityScoreSpecification`.
`popularityScore.value`	Number	قيمة رقمية غير سالبة تشير إلى مدى رواج العنصر، وكلما كانت النتيجة أعلى، كان العنصر أكثر رواجًا.
`popularityScore.eligibleRegion`	البلد	المناطق التي ينطبق عليها مقياس الرواج هذا إذا كانت نتيجة مقياس الرواج قابلة للتطبيق على مستوى العالم، اضبط القيمة على `EARTH`. يتم ضبط هذه السمة تلقائيًا على `EARTH`. `Note:` تُعطى الأولوية لمستوى الرواج الخاص باللغة على مستوى الرواج العالمي (EARTH)
`review`	مراجعة	مراجعة تقييمات الموسم التلفزيوني
`review.reviewRating`	التقييم	مطلوبة في حال توفير `review` تُستخدَم هذه السمة لتحديد التقييم الممنوح في المراجعة.
`contentRating`	نص أو تقييم	مطلوبة للمحتوى المخصّص للبالغين، ويُنصح بها بشدة في الحالات الأخرى: التقييم العام للمحتوى إذا تم تقديم التقييم حسب الفئة العمرية في شكل سلسلة نصية، سيتم قبول صيغتين: وكالة التقييم التي تمّت إضافتها قبل التقييم مع مسافة بيضاء بينهما على سبيل المثال، يجب وصف تصنيف "TV-MA" من وكالة "TVPG" في الولايات المتحدة على النحو التالي: "TVPG TV-MA". اطّلِع على قائمة الوكالات. القيمة "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 = عنف.

مواصفات المُنفِّذ

تتيح لك السمة actor في أنواع الكيانات TVSeries وTVEpisode وTVSeason تحديد المزيد من التفاصيل حول الممثلين، بما في ذلك أسماء الشخصيات التي يؤدونها والأدوار التي يلعبونها في البرنامج التلفزيوني. تتضمّن الأقسام التالية المعلومات نفسها، بالإضافة إلى بعض الأمثلة التي توضّح كيفية الاستخدام.

الموقع النوع المتوقّع الوصف

الموقع	النوع المتوقّع	الوصف
`actor`	Person أو PerformingGroup أو PerformanceRole	يُنصح به بشدة لماذا؟ : مصفوفة من أعضاء فريق التمثيل. استخدِم النوع PerformanceRole عندما يكون الدور الذي تم تأديته واسم الشخصية التي يؤديها الممثلون معروفَين (اختياريًا). في هذه الحالة، يتم تضمين الممثّل Person أو PerformingGroup داخل الكائن PerformanceRole. استخدِم النوع Person للإشارة إلى الممثلين الفرديين أو PerformingGroup لتقديم تفاصيل عن المجموعات أو الفرق الموسيقية عندما تكون الأدوار التي يؤديها أعضاء فريق التمثيل غير معروفة. استخدِم مصفوفة لتمثيل عدة قيم من النوع Person أو PerformingGroup أو PerformanceRole.

actor

Person أو PerformingGroup أو PerformanceRole

يُنصح به بشدة لماذا؟ : مصفوفة من أعضاء فريق التمثيل.

استخدِم النوع PerformanceRole عندما يكون الدور الذي تم تأديته واسم الشخصية التي يؤديها الممثلون معروفَين (اختياريًا). في هذه الحالة، يتم تضمين الممثّل Person أو PerformingGroup داخل الكائن PerformanceRole.
استخدِم النوع Person للإشارة إلى الممثلين الفرديين أو PerformingGroup لتقديم تفاصيل عن المجموعات أو الفرق الموسيقية عندما تكون الأدوار التي يؤديها أعضاء فريق التمثيل غير معروفة.

استخدِم مصفوفة لتمثيل عدة قيم من النوع Person أو PerformingGroup أو PerformanceRole.

استخدام النوعَين `Person` أو `PerformingGroup`

يجب توفير السمات التالية عند استخدام النوع Person أو PerformingGroup

الموقع	النوع المتوقّع	الوصف
`@type`	Person أو PerformingGroup	مطلوبة - يجب ضبطها دائمًا على Person أو PerformingGroup
`@id`	URL	يُنصح به بشدة لماذا؟ - معرّف الممثلين أو المجموعة المؤدية بتنسيق معرّف الموارد المنتظم (URI)، مثل https://example.com/actor/abc `@id` يجب أن تستوفي المتطلبات التالية: معرّف فريد عالميًا في الكتالوج لكل ممثل أو مجموعة مؤدية ويجب أن يكون المعرّف ثابتًا ولا يتغير بمرور الوقت. وسيتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. في شكل معرّف موارد موحّد (URI) يجب أن تكون مؤسستك مالكة للنطاق المستخدَم للقيمة `@id`. يُرجى العِلم أنّه يجب استخدام `@id` المستخدَمة في سمة "الممثل" بشكل متّسق في جميع أنحاء الخلاصة. على سبيل المثال، إذا كان هناك فيلمان يضمّان الممثل نفسه، يجب أن تبقى قيمة `@id` هي نفسها في كلا العنصرَين الخاصَّين بالممثل.
`name`	Text	مطلوبة: تمثّل هذه السمة اسم الممثل أو الممثلة أو أحد أفراد فريق التمثيل أو المجموعة الفنية.
`sameAs`	URL	يُنصح به بشدة لماذا؟ - عنوان URL لصفحة ويب مرجعية يمكنها تحديد الممثل أو المجموعة المؤدية، مثل صفحة الممثل على "ويكيبيديا" يجب أن يكون هذا المعرّف مختلفًا عن الخاصية `@id`.

استخدام النوع `PerformanceRole`

قدِّم السمات التالية عند استخدام النوع PerformanceRole

الموقع	النوع المتوقّع	الوصف
`@type`	PerformanceRole	مطلوبة - يتم ضبطها دائمًا على PerformanceRole
`roleName`	Text	يُنصح به بشدة لماذا؟ - دور يؤديه أو يمثّله أو يجسّده أحد أعضاء فريق التمثيل يُرجى الاطّلاع على قائمة القيم المقبولة هنا.
`characterName`	Text	تمثّل هذه السمة اسم شخصية معيّنة تمثّل دورًا في فيلم أو مسرحية أو غير ذلك. لا تضبط هذا الحقل إذا كان نوع الجهة الفاعلة هو PerformingGroup.
`actor`	Person أو PerformingGroup	مطلوب - تمثّل هذه السمة الممثلين المشاركين في المحتوى عند استخدام نوع البيانات Person. تمثّل هذه السمة المجموعة أو الفرق الموسيقية التي أدّت المحتوى عند استخدام نوع البيانات PerformingGroup.
`actor.@type`	Person أو PerformingGroup	مطلوبة - يجب ضبطها دائمًا على Person أو PerformingGroup
`actor.@id`	URL	يُنصح به بشدة لماذا؟ - معرّف الجهة الفاعلة أو المجموعة المؤدية بتنسيق معرّف الموارد المنتظم (URI)، مثل https://example.com/actor/abc `@id` يجب أن تستوفي المتطلبات التالية: معرّف فريد عالميًا في الكتالوج لكل ممثل أو مجموعة مؤدية ويجب أن يكون المعرّف ثابتًا ولا يتغير بمرور الوقت. وسيتم التعامل معه كسلسلة مبهمة ولا يُشترط أن يكون رابطًا منشورًا. في شكل معرّف موارد موحّد (URI) يجب أن تكون مؤسستك مالكة للنطاق المستخدَم للقيمة `@id`. يُرجى العِلم أنّه يجب استخدام `@id` المستخدَمة في سمة "الممثل" بشكل متّسق في جميع أنحاء الخلاصة. على سبيل المثال، إذا كان هناك فيلمان يضمّان الممثل نفسه، يجب أن تبقى قيمة `@id` هي نفسها في كلا العنصرَين الخاصَّين بالممثل.
`actor.name`	Text	مطلوبة: تمثّل هذه السمة اسم الممثل أو الممثلة أو أحد أفراد فريق التمثيل أو المجموعة الفنية.
`actor.sameAs`	URL	يُنصح به بشدة لماذا؟ - عنوان URL لصفحة ويب مرجعية يمكنها تحديد الممثل أو المجموعة المؤدية، مثل صفحة الممثل على "ويكيبيديا" يجب أن يكون هذا المعرّف مختلفًا عن الخاصية actor.@id.

أسماء الأدوار المقبولة

تتطلّب هذه القيم أن تكون قيمة actor.@type هي Person.

قيمة `roleName`	الوصف
"Cameo"	دور الظهور الخاص، ويُعرف أيضًا باسم الظهور الموجز، هو ظهور موجز لشخص معروف في عمل من أعمال الفنون الأدائية.
"VoiceActor"	الأداء الصوتي هو الأداء الذي يتم فيه استخدام صوت الممثل ولكن لا يظهر الممثل على الشاشة. يظهر هذا النوع من المحتوى غالبًا في الرسوم المتحركة، ولكنّه يحدث أيضًا عندما يتم دبلجة صوت أحد الممثلين فوق كلام ممثل آخر.
"مضاعفة"	الممثّل البديل هو شخص يحلّ محلّ ممثّل آخر ولا يظهر وجهه.
"MotionCaptureActor"	يشير مصطلح MotionCaptureActor إلى الشخص الذي يسجّل حركات الممثلين البشريين، ويستخدم هذه المعلومات لتحريك نماذج الشخصيات الرقمية في رسوم متحركة ثنائية أو ثلاثية الأبعاد على الكمبيوتر.

يتم قبول هذه القيم بشكل عام للنوعَين Person وPerformingGroup.

قيمة `roleName`	الوصف
"الممثّل"	الممثل هو شخص يجسّد شخصية في عرض مسرحي أو في وسائل الإعلام الحديثة، مثل الأفلام والراديو والتلفزيون.
"GuestStar"	"الممثل الضيف هو ممثل يؤدي دورًا خياليًا ويظهر في حلقة واحدة أو بضع حلقات. في بعض الحالات، قد يجسّد نجم ضيف شخصية متكررة مهمة وقد يظهر عدة مرات في مسلسل، على الرغم من أنّه ليس عضوًا في فريق الممثلين الرئيسيين. اضبط القيمة على "GuestStar" عندما يقدّم الممثلون أداءً كضيف أو يشاركون في البرنامج كضيوف. يجب تقديم معلومات عن النجوم الضيوف على مستوى الحلقة فقط، ويجب عدم إضافتها على مستوى TVSeries.
"ضيف"	"ضيف في برنامج حواري يُرجى العِلم أنّه على الرغم من أنّ "GuestStar" هو دور خيالي، فإنّ "Guest" هو ظهور غير خيالي.
"المذيع"	المذيع هو الشخص الذي يقدّم فقرات افتتاحية وختامية للبرنامج، ويعرّف الجمهور بالمضيف والمتسابقين و/أو الضيوف المشاهير، ويصف الجوائز المتاحة، ويشجّع الجمهور قبل التسجيل ويقدّم لهم الترفيه خلال الاستراحات.
"المعلّق"	يقدّم المعلّق تعليقًا في الوقت الفعلي على مباراة أو حدث، عادةً أثناء بث مباشر.
"انطباعي"	المقلّد هو مؤدٍّ يعتمد أسلوبه على تقليد أصوات المشاهير وشخصيات الرسوم المتحركة وطريقة كلامهم وتصرفاتهم.
"المضيف"	هو الشخص الذي يقدّم البرامج التلفزيونية أو يستضيفها، وغالبًا ما يكون وسيطًا بين البرنامج والجمهور. "المضيف" هو بشكل عام دور غير خيالي.
"CoHost"	تمثّل هذه السمة الشخص الذي يستضيف فعالية أو برنامجًا بشكل مشترك مع أشخاص آخرين.
"GuestHost"	المضيف الضيف هو مضيف، عادةً ما يكون مضيف برنامج حواري، يستضيف البرنامج بدلاً من المضيف العادي عندما لا يكون متاحًا.
"مذيع الأخبار"	هو الشخص الذي يعرض/يُطلع الجمهور على الأخبار والفعاليات التي تحدث على نطاق محلي ووطني ودولي من خلال برنامج إخباري تلفزيوني.
"المراسِل"	المراسل أو الصحفي الميداني هو عادةً صحفي أو معلّق يعمل في مجلة أو وكيل يقدّم تقاريرًا إلى صحيفة أو أخبار إذاعية أو تلفزيونية أو نوع آخر من الشركات من موقع بعيد، غالبًا ما يكون نائيًا.
"ShowJudge"	القاضي هو شخص يُعتبر غالبًا خبيرًا في مجال البرنامج، ويتم منحه دور "القاضي" لتقييم المتسابقين الذين يشاركون في تجارب الأداء ويدخلون المنافسة في المسلسل التلفزيوني.
"المشارك في حلقة النقاش"	أحد أعضاء لجنة مناقشة أو استشارية في برنامج إذاعي أو تلفزيوني
"المشارك"	المتسابق هو شخص يشارك في مسابقة أو برنامج تلفزيوني.
"StoryNarrator"	الراوي هو شخص يروي شيئًا، لا سيما شخصية تحكي أحداث رواية أو قصيدة سردية
"MusicalArtist"	"يمكن أن يكون الفنّان الموسيقي شخصًا أو مجموعة أو شخصية خيالية أدّت عادةً عروضًا أمام الجمهور بشكل منتظم أو سجّلت مقاطع موسيقية أو ألبومات موسيقية. يجب أن يكون لدى المؤلّفين وكتّاب الكلمات هذا النوع فقط إذا كانت بيانات الاعتماد الخاصة ببعض الأعمال الموسيقية تشير إلى أنّهم يساهمون أيضًا كفنانين رئيسيين. يمكن استخدام هذا النوع لربط "موسيقيين" أو "مجموعات موسيقية" دائمين، و"موسيقيين" أو "مجموعات موسيقية" ضيوف بالبرامج.

التمييز بين الدور الرئيسي والدور الثانوي للممثل

للتفريق بين الممثلين الرئيسيين والممثلين الضيوف أو المساعدين في برنامج تلفزيوني، أضِف الممثلين الرئيسيين إلى كيانات TVSeries فقط، وأضِف الممثلين الضيوف أو الممثلين الذين يؤدون أدوارًا مساعدة إلى كيانات TVEpisode فقط. تأكَّد من عدم إضافة الممثلين الرئيسيين أو العاديين إلى عناصر TVEpisode.

أمثلة

مثال على `TVSeries` و`TVEpisode` و`TVSeason`

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

أمثلة على سمة `Actor`

دور الممثّل غير معروف

عندما يكون دور الممثل غير معروف، ننصحك بتقديم معلومات الممثل باستخدام النوع Person أو PerformingGroup .

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

دور المُنفِّذ معروف

عندما يكون دور الممثل معروفًا، ننصح بتقديم معلومات الممثل باستخدام نوع PerformanceRole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

الأدوار المعروفة لمجموعة فرعية من الممثلين

عندما تكون البيانات الوصفية الخاصة بدور الأداء غير معروفة، ننصح بتقديم معلومات الممثل باستخدام النوع Person أو PerformingGroup. في الحالة الأخرى التي تكون فيها هذه المعلومات معروفة، استخدِم PerformanceRole . يمكن إضافة هذه الأنواع في المصفوفة نفسها معًا.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

صفحات ذات صلة

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

خصائص ترميز المحتوى للبرامج التلفزيونية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

TVSeries

TVEpisode

TVSeason

مواصفات المُنفِّذ

استخدام النوعَين Person أو PerformingGroup

استخدام النوع PerformanceRole

أسماء الأدوار المقبولة

التمييز بين الدور الرئيسي والدور الثانوي للممثل

أمثلة

مثال على TVSeries وTVEpisode وTVSeason

TVSeries

TVEpisode

TVSeason

أمثلة على سمة Actor

دور الممثّل غير معروف

دور المُنفِّذ معروف

الأدوار المعروفة لمجموعة فرعية من الممثلين

صفحات ذات صلة

خصائص ترميز المحتوى للبرامج التلفزيونية

استخدام النوعَين `Person` أو `PerformingGroup`

استخدام النوع `PerformanceRole`

مثال على `TVSeries` و`TVEpisode` و`TVSeason`

أمثلة على سمة `Actor`