ویژگی های نشانه گذاری محتوای نمایش های تلویزیونی

این بخش جزئیات ویژگی‌های نشانه‌گذاری محتوا را برای انواع موجودیت‌های TVSeries ، TVEpisode و TVSeason ارائه می‌دهد.

ارائه TVSeason به عنوان یک موجودیت کامل اختیاری است. برای جزئیات بیشتر به بخش روابط TVSeries، TVSeason و TVEpisode مراجعه کنید.

جدول مشخصات

سریال‌های تلویزیونی

ملک نوع مورد انتظار توضیحات
@context متن الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
  • که در آن "xx" زبان رشته‌های موجود در فید را نشان می‌دهد. هر زمینه موجودیت ریشه باید @language خود را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. برای مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، نام‌ها حتی اگر زبان زیرنویس/دوبله انگلیسی باشد، به زبان اسپانیایی فرض می‌شوند.
@type متن الزامی - همیشه روی TVSeries تنظیم شود.
@id آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • شناسه باید پایدار باشد و با گذشت زمان تغییر نکند (حتی اگر ویژگی url مربوط به show تغییر کند). با آن به عنوان یک رشته مبهم رفتار خواهد شد و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • دامنه‌ای که برای مقدار @id استفاده می‌شود باید متعلق به سازمان شما باشد.
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
url آدرس اینترنتی الزامی - نشانی اینترنتی متعارف محتوا، که گوگل از آن برای تطبیق محتوای فید شما با محتوای موجود در پایگاه‌های داده گوگل استفاده می‌کند.
url باید شرایط زیر را داشته باشد:
  • url باید به صورت سراسری منحصر به فرد باشد.
  • url باید حاوی یک URL کانونیکال فعال باشد که گوگل بتواند آن را کراول کند.
برای لینک عمیق پخش، به جای آن به ویژگی urlTemplate شیء هدف مراجعه کنید.
name متن الزامی - نام نمایش.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال مناطق و زبان‌های چندگانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
titleEIDR متن اکیداً توصیه می‌شود. چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلی‌ترین/انتزاعی‌ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می‌دهد.

برای مثال، titleEIDR برای سریال تلویزیونی معروف به «بازی تاج و تخت» عبارت است از «10.5240/C1B5-3BA1-8991-A571-8472-W».
potentialAction تماشا کنید در صورت لزوم - یک شیء نشانه‌گذاری اکشن که جزئیات اکشن را ارائه می‌دهد.
  • اگر محتوا از طریق ویدئوی درخواستی (VoD) در دسترس باشد، این ویژگی الزامی است؛ شیء نشانه‌گذاری اکشن باید لینک عمیق محتوا را ارائه دهد.
  • اگر محتوا در یک کانال LiveTV موجود باشد، این ویژگی اختیاری است؛ موجودیت BroadcastService مرتبط، لینک عمیق کانال را ارائه می‌دهد.
  • یک TVSeries می‌تواند هم از طریق VoD و هم از طریق LiveTV در دسترس باشد.
از یک آرایه برای مشخص کردن لینک‌های عمیق مختلف در چندین منطقه استفاده کنید. به مثال مناطق و زبان‌های متعدد مراجعه کنید.
sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ یک URL به یک صفحه وب مرجع که بتواند نمایش را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای نمایش. این باید از ویژگی url متمایز باشد.
inLanguage متن زبان اصلی سریال با فرمت BCP 47 اکیداً توصیه می‌شود .
genre متن فهرستی مرتب از تمام ژانرهای مرتبط. برای مثال: ["Action", "Fashion", "Environment", "Football"]
keywords متن کلمات کلیدی یا برچسب‌هایی که برای توصیف این محتوا استفاده می‌شوند. آرایه‌ای از کلمات کلیدی نیز مجاز است. برای مثال، ["feature, biography"] می‌تواند آرایه‌ای از کلمات کلیدی برای توصیف محتوا باشد.
releasedEvent PublicationEvent ، FeaturedEvent یا ExclusiveEvent اکیداً توصیه می‌شود چرا؟ - PublicationEvent برای مشخص کردن تاریخ انتشار اولیه (جهانی یا محلی) محتوا توسط ناشر، مانند تاریخ انتشار اولیه یک فیلم در سینما، استفاده می‌شود.

علاوه بر این، FeaturedEvent استفاده کنید تا نشان دهید که سرویس شما این محتوا را به عنوان یک محتوای اصلی، ویژه، ویژه و غیره به بازار عرضه می‌کند.

ExclusiveEvent مشخص می‌کند که سرویس شما دارای حق توزیع انحصاری است و مکان و زمان آن را نیز مشخص می‌کند.

برای جزئیات و مثال‌ها به بخش نمونه‌ها مراجعه کنید.
releasedEvent.@type متن الزامی - حتماً همیشه این ویژگی را روی یکی از موارد زیر تنظیم کنید:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location کشور الزامی - مناطقی که با این رویداد مرتبط هستند.

برای یک PublicationEvent ، این ناحیه‌ای است که محتوا در آن منتشر شده است.

برای FeaturedEvent و ExclusiveEvent ، این ناحیه‌ای است که محتوا در آن نمایش داده می‌شود یا منحصر به فرد است.

از کدهای ISO 3166 برای کشورها استفاده کنید. برای نشان دادن همه جای دنیا، روی EARTH تنظیم کنید.
releasedEvent.startDate تاریخ یا DateTime توصیه شده - الزامی برای ExclusiveEvent - تاریخ شروع انتشار موجودیت.

برای یک PublicationEvent ، این تاریخ انتشار اولیه‌ی این موجودیت را نشان می‌دهد، مانند تاریخی که یک فیلم برای اولین بار در سینماها اکران شد.

برای ExclusiveEvent و FeaturedEvent ، این تاریخ شروع زمانی را نشان می‌دهد که موجودیت انحصاری یا ویژه است.
releasedEvent.endDate تاریخ یا DateTime توصیه شده - مورد نیاز برای ExclusiveEvent - این فقط برای انواع ExclusiveEvent و FeaturedEvent قابل اجرا است.

برای ExclusiveEvent ، این تاریخ، تاریخ انقضای حقوق مربوط به محتوا را نشان می‌دهد.

برای FeaturedEvent ، این آخرین تاریخی را نشان می‌دهد که ارائه‌دهنده، موجودیت را نمایش می‌دهد.

اگر محتوا دائماً انحصاری یا ویژه است، endDate روی ۲۰ سال از تاریخ فعلی تنظیم کنید.
releasedEvent.publishedBy سازمان یا شخص اختیاری - سازمان یا شخصی که این موجودیت را منتشر کرده است.
description متن اکیداً توصیه می‌شود. چرا؟ خلاصه‌ای از سریال. خلاصه داستان به خلاصه‌های واقعی ترجیح داده می‌شود. محدودیت ۳۰۰ کاراکتری.
  • از یک آرایه برای نشانه‌گذاری توضیحات به چندین زبان استفاده کنید. به مثال « چندین منطقه و زبان» مراجعه کنید.
actor شخص یا گروه اجرایی یا نقش اجرایی اکیداً توصیه می‌شود. چرا؟ مجموعه‌ای از بازیگران سریال. راهنمای مدلینگ را اینجا ببینید.
director شخص اکیداً توصیه می‌شود. چرا؟ کارگردان(گان) نمایش.
producer سازمان یا شخص اکیداً توصیه می‌شود. چرا؟ تهیه‌کننده(گان) برنامه.
image شیء تصویر مورد نیاز برای گوگل تی‌وی - تصاویر مربوط به سریال‌های تلویزیونی. برای جزئیات بیشتر در مورد ویژگی‌های مورد نیاز و اختیاری که باید همراه image باشند، به ویژگی‌های تصویر مراجعه کنید.
trailer.description متن توضیحات تریلر. به مثال تریلر مراجعه کنید.
trailer.inLanguage متن اکیداً توصیه می‌شود. زبان تریلر با فرمت BCP 47 است.
trailer.url آدرس اینترنتی نشانی اینترنتی (URL) تریلری که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز آپلود شده است.
trailer.regionsAllowed مکان مناطقی که رسانه‌ها مجاز هستند. اگر مشخص نشده باشند، فرض بر این است که در همه جا مجاز هستند. کشورها را با فرمت ISO 3166 مشخص کنید.
identifier ارزش ملک اکیداً توصیه می‌شود. چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این موجودیت را شناسایی کند. استفاده از چندین شناسه مجاز است. برای جزئیات بیشتر به بخش ویژگی‌های شناسه مراجعه کنید.
popularityScore امتیاز محبوبیتمشخصات چرا به شدت توصیه می‌شود؟ امتیازی که گوگل به همراه سایر سیگنال‌ها، برای تعیین اینکه کدام رسانه را برای کاربران پخش کند، استفاده می‌کند. این امتیاز، محبوبیت محتوا را در مقایسه با سایر محتوای موجود در کاتالوگ شما نشان می‌دهد؛ بنابراین، مقیاس امتیاز باید در فیدهای شما، در بین تمام موجودیت‌های موجود در کاتالوگ شما، ثابت باشد. به طور پیش‌فرض، امتیاز محبوبیت یک موجودیت روی ۰ تنظیم شده است.
popularityScore.@type متن همیشه روی PopularityScoreSpecification تنظیم شود.
popularityScore.value شماره یک مقدار عددی غیر منفی که محبوبیت موجودیت را نشان می‌دهد؛ امتیاز بالاتر به معنای محبوبیت بیشتر است.
popularityScore.eligibleRegion کشور منطقه(هایی) که این امتیاز محبوبیت در آن اعمال می‌شود. اگر امتیاز محبوبیت به صورت سراسری اعمال می‌شود، روی EARTH تنظیم شود. به طور پیش‌فرض، این ویژگی روی EARTH تنظیم شده است.
Note: محبوبیت محلی بر محبوبیت جهانی (زمین) اولویت دارد
review نقد و بررسی بررسی رتبه‌بندی سریال‌های تلویزیونی
review.reviewRating رتبه‌بندی در صورت ارائه review الزامی است. این فیلد برای مشخص کردن رتبه‌بندی ارائه شده در نقد و بررسی استفاده می‌شود.
contentRating متن یا امتیاز برای محتوای بزرگسالان الزامی است، در غیر این صورت اکیداً توصیه می‌شود - رتبه‌بندی کلی محتوا. اگر رتبه‌بندی محتوا به صورت رشته متنی ارائه شود، دو نوع تغییر پذیرفته می‌شود:
  • آژانس رتبه‌بندی با یک فاصله خالی در میان، به رتبه‌بندی اضافه شده است. برای مثال، رتبه‌بندی "TV-MA" از آژانس "TVPG" در ایالات متحده باید به صورت "TVPG TV-MA" توصیف شود. به فهرست آژانس‌ها مراجعه کنید.
  • مقداری برابر با «RATING NOT KNOWN» (بدون حساسیت به حروف بزرگ و کوچک) که نشان می‌دهد شما رتبه‌بندی محتوا را نمی‌دانید.
contentRating.author سازمان در صورت استفاده از Rating contentRating الزامی است - نام آژانس رتبه‌بندی. برای مشاهده فهرست آژانس‌های رتبه‌بندی پذیرفته‌شده، به صفحه آژانس‌های رتبه‌بندی محتوا مراجعه کنید.
contentRating.ratingValue متن اگر contentRating Rating استفاده کند، الزامی است - مقدار امتیاز.
contentRating.advisoryCode متن کد توصیه‌شده برای محتوا. مقادیر پذیرفته‌شده شامل D، FV، L، S و V هستند. D = گفتگو، FV = خشونت خیالی، L = زبان، S = محتوای جنسی، V = خشونت.

قسمت تلویزیونی

ملک نوع مورد انتظار توضیحات
@context متن الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
  • که در آن "xx" زبان رشته‌های موجود در فید را نشان می‌دهد. هر زمینه موجودیت ریشه باید @language خود را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. برای مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، نام‌ها حتی اگر زبان زیرنویس/دوبله انگلیسی باشد، به زبان اسپانیایی فرض می‌شوند.
@type متن الزامی - همیشه روی TVEpisode تنظیم شود.
@id آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • شناسه باید پایدار باشد و با گذشت زمان تغییر نکند (حتی اگر ویژگی url مربوط به show تغییر کند). با آن به عنوان یک رشته مبهم رفتار خواهد شد و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • دامنه‌ای که برای مقدار @id استفاده می‌شود باید متعلق به سازمان شما باشد.
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
url آدرس اینترنتی الزامی - نشانی اینترنتی متعارف محتوا، که گوگل از آن برای تطبیق محتوای فید شما با محتوای موجود در پایگاه‌های داده گوگل استفاده می‌کند.
url باید شرایط زیر را داشته باشد:
  • url باید به صورت سراسری منحصر به فرد باشد.
  • url باید حاوی یک URL کانونیکال فعال باشد که گوگل بتواند آن را کراول کند.
برای لینک عمیق پخش، به جای آن به ویژگی urlTemplate شیء هدف مراجعه کنید.
name متن الزامی - نام قسمت.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال نمایش چندزبانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
titleEIDR متن اکیداً توصیه می‌شود. چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلی‌ترین/انتزاعی‌ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می‌دهد.

برای مثال، عنوان EIDR برای اولین قسمت از فصل اول سریال تلویزیونی «بازی تاج و تخت» به صورت «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X» است.
editEIDR متن اکیداً توصیه می‌شود. چرا؟ - شناسه EIDR (ثبت شناسه سرگرمی) که نشان‌دهنده ویرایش/نسخه خاصی از یک اثر سینمایی یا تلویزیونی است.

برای مثال، قسمت اول از فصل اول سریال تلویزیونی «بازی تاج و تخت» که عنوان EIDR آن «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X» است، یک ویرایش دارد، مثلاً «10.5240/FB97-C847-2969-D0AB-ECD1-C».

ویژگی titleEIDR هنگام ارائه editEIDR الزامی است.
inLanguage متن اکیداً توصیه می‌شود. زبان اصلی این قسمت با فرمت BCP 47 .
episodeNumber عدد صحیح الزامی - عددی که جایگاه این قسمت را در ترتیب قسمت‌های یک فصل نشان می‌دهد. episodeNumber باید برای هر فصل مجدداً شروع شود؛ یعنی اولین قسمت هر فصل باید ۱ باشد.
partOfSeason فصل تلویزیون الزامی - فصل تلویزیونی که این قسمت به آن تعلق دارد.

حتی اگر یک TVEpisode دارای TVSeason متناظر نباشد، شما همچنان باید ویژگی‌های partOfSeason.@id و partOfSeason.seasonNumber را ارائه دهید. یک راه حل این است:
  • partofSeries.@id partOfSeason.@id
  • مقدار partOfSeason.seasonNumber را روی ۱ تنظیم کنید.
partOfSeason.@type متن الزامی - همیشه روی TVSeason تنظیم شود.
partOfSeason.@id آدرس اینترنتی الزامی - @id TVSeason که این قسمت بخشی از آن است.
partOfSeason.seasonNumber عدد صحیح الزامی - عددی که جایگاه این فصل را در ترتیب فصل‌های سریال تلویزیونی نشان می‌دهد.
partOfSeries سریال‌های تلویزیونی الزامی - مجموعه تلویزیونی که این قسمت به آن تعلق دارد.
partOfSeries.@type متن الزامی - همیشه روی TVSeries تنظیم شود.
partOfSeries.@id آدرس اینترنتی الزامی - @id TVSeries که این قسمت بخشی از آن است.
partOfSeries.name متن الزامی - نام سریال تلویزیونی.
partOfSeries.sameAs متن یک URL به یک صفحه وب مرجع که می‌تواند نمایش را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای نمایش. این باید از ویژگی url متمایز باشد.
potentialAction تماشا کنید در صورت لزوم - یک شیء نشانه‌گذاری اکشن که جزئیات اکشن را ارائه می‌دهد.
  • اگر محتوا از طریق ویدئوی درخواستی (VoD) در دسترس باشد، این ویژگی الزامی است؛ شیء نشانه‌گذاری اکشن باید لینک عمیق محتوا را ارائه دهد.
  • اگر محتوا در یک کانال LiveTV موجود باشد، این ویژگی اختیاری است؛ موجودیت BroadcastService مرتبط، لینک عمیق کانال را ارائه می‌دهد.
  • یک TVEpisode می‌تواند هم از طریق VoD و هم از طریق LiveTV در دسترس باشد.
از یک آرایه برای مشخص کردن لینک‌های عمیق مختلف در چندین منطقه استفاده کنید. به مثال مناطق و زبان‌های متعدد مراجعه کنید.
sameAs چرا به شدت توصیه می‌شود ؟ یک URL به یک صفحه وب مرجع که می‌تواند قسمت را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای آن قسمت. این باید از ویژگی url متمایز باشد.
duration مدت زمان مدت زمان اجرای قسمت با فرمت ISO 8601. لطفاً از فرمت "PT00H00M" استفاده کنید.
releasedEvent PublicationEvent ، FeaturedEvent یا ExclusiveEvent اکیداً توصیه می‌شود چرا؟ - PublicationEvent برای مشخص کردن تاریخ انتشار اولیه (جهانی یا محلی) محتوا توسط ناشر، مانند تاریخ انتشار اولیه یک فیلم در سینما، استفاده می‌شود.

علاوه بر این، FeaturedEvent استفاده کنید تا نشان دهید که سرویس شما این محتوا را به عنوان یک محتوای اصلی، ویژه، ویژه و غیره به بازار عرضه می‌کند.

ExclusiveEvent مشخص می‌کند که سرویس شما دارای حق توزیع انحصاری است و مکان و زمان آن را نیز مشخص می‌کند.

برای جزئیات و مثال‌ها به بخش نمونه‌ها مراجعه کنید.
releasedEvent.@type متن الزامی - حتماً همیشه این ویژگی را روی یکی از موارد زیر تنظیم کنید:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location کشور الزامی - مناطقی که با این رویداد مرتبط هستند.

برای یک PublicationEvent ، این ناحیه‌ای است که محتوا در آن منتشر شده است.

برای FeaturedEvent و ExclusiveEvent ، این ناحیه‌ای است که محتوا در آن نمایش داده می‌شود یا منحصر به فرد است.

از کدهای ISO 3166 برای کشورها استفاده کنید. برای نشان دادن همه جای دنیا، روی EARTH تنظیم کنید.
releasedEvent.startDate تاریخ یا DateTime توصیه شده - الزامی برای ExclusiveEvent - تاریخ شروع انتشار موجودیت.

برای یک PublicationEvent ، این تاریخ انتشار اولیه‌ی این موجودیت را نشان می‌دهد، مانند تاریخی که یک فیلم برای اولین بار در سینماها اکران شد.

برای ExclusiveEvent و FeaturedEvent ، این تاریخ شروع زمانی را نشان می‌دهد که موجودیت انحصاری یا ویژه است.
releasedEvent.endDate تاریخ یا DateTime توصیه شده - مورد نیاز برای ExclusiveEvent - این فقط برای انواع ExclusiveEvent و FeaturedEvent قابل اجرا است.

برای ExclusiveEvent ، این تاریخ، تاریخ انقضای حقوق مربوط به محتوا را نشان می‌دهد.

برای FeaturedEvent ، این آخرین تاریخی را نشان می‌دهد که ارائه‌دهنده، موجودیت را نمایش می‌دهد.

اگر محتوا دائماً انحصاری یا ویژه است، endDate روی ۲۰ سال از تاریخ فعلی تنظیم کنید.
releasedEvent.publishedBy سازمان یا شخص اختیاری - سازمان یا شخصی که این موجودیت را منتشر کرده است.
description متن اکیداً توصیه می‌شود. چرا؟ خلاصه‌ای از قسمت. خلاصه‌های داستان به خلاصه‌های واقعی ترجیح داده می‌شوند. محدودیت ۳۰۰ کاراکتری.
  • از یک آرایه برای نشانه‌گذاری توضیحات به چندین زبان استفاده کنید. به مثال نمایش چندزبانه مراجعه کنید.
genre متن فهرستی مرتب از تمام ژانرهای مرتبط. برای مثال: ["Action", "Fashion", "Environment", "Football"]
keywords متن کلمات کلیدی یا برچسب‌هایی که برای توصیف این محتوا استفاده می‌شوند. آرایه‌ای از کلمات کلیدی نیز مجاز است. برای مثال، ["feature, biography"] می‌تواند آرایه‌ای از کلمات کلیدی برای توصیف محتوا باشد.
actor شخص یا گروه اجرایی یا نقش اجرایی اکیداً توصیه می‌شود. چرا؟ مجموعه‌ای از بازیگران این قسمت. راهنمای مدلینگ را اینجا ببینید.
director شخص به شدت توصیه می‌شود. چرا؟ کارگردان(گان) این قسمت.
producer سازمان یا شخص اکیداً توصیه می‌شود. چرا؟ تهیه‌کننده(گان)ی این فصل.
image شیء تصویر به شدت توصیه می‌شود چرا؟ برای گوگل تی‌وی - تصاویر مختلف مربوط به قسمت TV. برای جزئیات بیشتر در مورد ویژگی‌های مورد نیاز و اختیاری که باید همراه image باشند، به ویژگی‌های تصویر مراجعه کنید.
trailer.description متن توضیحات تریلر. به مثال تریلر مراجعه کنید.
trailer.inLanguage متن اکیداً توصیه می‌شود. زبان تریلر با فرمت BCP 47 است.
trailer.url آدرس اینترنتی نشانی اینترنتی (URL) تریلری که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز آپلود شده است.
trailer.regionsAllowed مکان مناطقی که رسانه‌ها مجاز هستند. اگر مشخص نشده باشند، فرض بر این است که در همه جا مجاز هستند. کشورها را با فرمت ISO 3166 مشخص کنید.
review نقد و بررسی رتبه‌بندی‌های مربوط به قسمت تلویزیونی را بررسی کنید
review.reviewRating رتبه‌بندی در صورت ارائه review الزامی است. این فیلد برای مشخص کردن رتبه‌بندی ارائه شده در نقد و بررسی استفاده می‌شود.
contentRating متن یا امتیاز برای محتوای بزرگسالان الزامی است، در غیر این صورت اکیداً توصیه می‌شود - رتبه‌بندی کلی محتوا. اگر رتبه‌بندی محتوا به صورت رشته متنی ارائه شود، دو نوع تغییر پذیرفته می‌شود:
  • آژانس رتبه‌بندی با یک فاصله خالی در میان، به رتبه‌بندی اضافه شده است. برای مثال، رتبه‌بندی "TV-MA" از آژانس "TVPG" در ایالات متحده باید به صورت "TVPG TV-MA" توصیف شود. به فهرست آژانس‌ها مراجعه کنید.
  • مقداری برابر با «RATING NOT KNOWN» (بدون حساسیت به حروف بزرگ و کوچک) که نشان می‌دهد شما رتبه‌بندی محتوا را نمی‌دانید.
contentRating.author سازمان در صورت استفاده از Rating contentRating الزامی است - نام آژانس رتبه‌بندی. برای مشاهده فهرست آژانس‌های رتبه‌بندی پذیرفته‌شده، به صفحه آژانس‌های رتبه‌بندی محتوا مراجعه کنید.
contentRating.ratingValue متن اگر contentRating Rating استفاده کند، الزامی است - مقدار امتیاز.
contentRating.advisoryCode متن کد توصیه‌شده برای محتوا. مقادیر پذیرفته‌شده شامل D، FV، L، S و V هستند. D = گفتگو، FV = خشونت خیالی، L = زبان، S = محتوای جنسی، V = خشونت.
identifier ارزش ملک اکیداً توصیه می‌شود. چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این موجودیت را شناسایی کند. استفاده از چندین شناسه مجاز است. برای جزئیات بیشتر به بخش ویژگی‌های شناسه مراجعه کنید.
popularityScore امتیاز محبوبیتمشخصات چرا به شدت توصیه می‌شود؟ امتیازی که گوگل به همراه سایر سیگنال‌ها، برای تعیین اینکه کدام رسانه را برای کاربران پخش کند، استفاده می‌کند. این امتیاز، محبوبیت محتوا را در مقایسه با سایر محتوای موجود در کاتالوگ شما نشان می‌دهد؛ بنابراین، مقیاس امتیاز باید در فیدهای شما، در بین تمام موجودیت‌های موجود در کاتالوگ شما، ثابت باشد. به طور پیش‌فرض، امتیاز محبوبیت یک موجودیت روی ۰ تنظیم شده است.
popularityScore.@type متن همیشه روی PopularityScoreSpecification تنظیم شود.
popularityScore.value شماره یک مقدار عددی غیر منفی که محبوبیت موجودیت را نشان می‌دهد؛ امتیاز بالاتر به معنای محبوبیت بیشتر است.
popularityScore.eligibleRegion کشور منطقه(هایی) که این امتیاز محبوبیت در آن اعمال می‌شود. اگر امتیاز محبوبیت به صورت سراسری اعمال می‌شود، روی EARTH تنظیم شود. به طور پیش‌فرض، این ویژگی روی EARTH تنظیم شده است.
Note: محبوبیت محلی بر محبوبیت جهانی (زمین) اولویت دارد

فصل تلویزیون

ملک نوع مورد انتظار توضیحات
@context متن الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
  • که در آن "xx" زبان رشته‌های موجود در فید را نشان می‌دهد. هر زمینه موجودیت ریشه باید @language خود را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. برای مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، نام‌ها حتی اگر زبان زیرنویس/دوبله انگلیسی باشد، به زبان اسپانیایی فرض می‌شوند.
@type متن الزامی - همیشه روی TVSeason تنظیم شود.
@id آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • شناسه باید پایدار باشد و با گذشت زمان تغییر نکند (حتی اگر ویژگی url مربوط به show تغییر کند). با آن به عنوان یک رشته مبهم رفتار خواهد شد و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • دامنه‌ای که برای مقدار @id استفاده می‌شود باید متعلق به سازمان شما باشد.
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
url آدرس اینترنتی الزامی - نشانی اینترنتی متعارف محتوا، که گوگل از آن برای تطبیق محتوای فید شما با محتوای موجود در پایگاه‌های داده گوگل استفاده می‌کند.
url باید شرایط زیر را داشته باشد:
  • url باید به صورت سراسری منحصر به فرد باشد.
  • url باید حاوی یک URL کانونیکال فعال باشد که گوگل بتواند آن را کراول کند.
برای لینک عمیق پخش، به جای آن به ویژگی urlTemplate شیء هدف مراجعه کنید.
name متن الزامی - نام این فصل تلویزیونی.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال نمایش چندزبانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
titleEIDR متن اکیداً توصیه می‌شود. چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلی‌ترین/انتزاعی‌ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می‌دهد.

برای مثال، titleEIDR برای فصل اول سریال تلویزیونی «بازی تاج و تخت» عبارت است از «10.5240/FD91-C72C-4161-FCBA-058B-1».
seasonNumber عدد صحیح الزامی - عددی که جایگاه این فصل را در ترتیب فصل‌های سریال تلویزیونی نشان می‌دهد.
partOfSeries سریال‌های تلویزیونی الزامی - مجموعه تلویزیونی که این فصل به آن تعلق دارد.
partOfSeries.@type متن الزامی - همیشه روی TVSeries تنظیم شود.
partOfSeries.@id آدرس اینترنتی الزامی - @id TVSeries که این فصل بخشی از آن است.
partOfSeries.name متن الزامی - نام سریال تلویزیونی.
partOfSeries.sameAs متن یک URL به یک صفحه وب مرجع که می‌تواند نمایش را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای نمایش. این باید از ویژگی url متمایز باشد.
potentialAction تماشا کنید در صورت لزوم - یک شیء نشانه‌گذاری اکشن که جزئیات اکشن را ارائه می‌دهد.
  • اگر محتوا از طریق ویدئوی درخواستی (VoD) در دسترس باشد، این ویژگی الزامی است؛ شیء نشانه‌گذاری اکشن باید لینک عمیق محتوا را ارائه دهد.
  • اگر محتوا در یک کانال LiveTV موجود باشد، این ویژگی اختیاری است؛ موجودیت BroadcastService مرتبط، لینک عمیق کانال را ارائه می‌دهد.
  • یک TVSeason می‌تواند هم در VoD و هم در LiveTV در دسترس باشد.
از یک آرایه برای مشخص کردن لینک‌های عمیق مختلف در چندین منطقه استفاده کنید. به مثال مناطق و زبان‌های متعدد مراجعه کنید.
sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ یک URL به یک صفحه وب مرجع که بتواند فصل را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای آن فصل. این باید از ویژگی url متمایز باشد.
releasedEvent PublicationEvent ، FeaturedEvent یا ExclusiveEvent اکیداً توصیه می‌شود چرا؟ - PublicationEvent برای مشخص کردن تاریخ انتشار اولیه (جهانی یا محلی) محتوا توسط ناشر، مانند تاریخ انتشار اولیه یک فیلم در سینما، استفاده می‌شود.

علاوه بر این، FeaturedEvent استفاده کنید تا نشان دهید که سرویس شما این محتوا را به عنوان یک محتوای اصلی، ویژه، ویژه و غیره به بازار عرضه می‌کند.

ExclusiveEvent مشخص می‌کند که سرویس شما دارای حق توزیع انحصاری است و مکان و زمان آن را نیز مشخص می‌کند.

برای جزئیات و مثال‌ها به بخش نمونه‌ها مراجعه کنید.
releasedEvent.@type متن الزامی - حتماً همیشه این ویژگی را روی یکی از موارد زیر تنظیم کنید:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location کشور الزامی - مناطقی که با این رویداد مرتبط هستند.

برای یک PublicationEvent ، این ناحیه‌ای است که محتوا در آن منتشر شده است.

برای FeaturedEvent و ExclusiveEvent ، این ناحیه‌ای است که محتوا در آن نمایش داده می‌شود یا منحصر به فرد است.

از کدهای ISO 3166 برای کشورها استفاده کنید. برای نشان دادن همه جای دنیا، روی EARTH تنظیم کنید.
releasedEvent.startDate تاریخ یا DateTime توصیه شده - الزامی برای ExclusiveEvent - تاریخ شروع انتشار موجودیت.

برای یک PublicationEvent ، این تاریخ انتشار اولیه‌ی این موجودیت را نشان می‌دهد، مانند تاریخی که یک فیلم برای اولین بار در سینماها اکران شد.

برای ExclusiveEvent و FeaturedEvent ، این تاریخ شروع زمانی را نشان می‌دهد که موجودیت انحصاری یا ویژه است.
releasedEvent.endDate تاریخ یا DateTime توصیه شده - مورد نیاز برای ExclusiveEvent - این فقط برای انواع ExclusiveEvent و FeaturedEvent قابل اجرا است.

برای ExclusiveEvent ، این تاریخ، تاریخ انقضای حقوق مربوط به محتوا را نشان می‌دهد.

برای FeaturedEvent ، این آخرین تاریخی را نشان می‌دهد که ارائه‌دهنده، موجودیت را نمایش می‌دهد.

اگر محتوا دائماً انحصاری یا ویژه است، endDate روی ۲۰ سال از تاریخ فعلی تنظیم کنید.
releasedEvent.publishedBy سازمان یا شخص اختیاری - سازمان یا شخصی که این موجودیت را منتشر کرده است.
description متن اکیداً توصیه می‌شود. چرا؟ خلاصه‌ای از فصل. خلاصه‌های داستانی به خلاصه‌های واقعی ترجیح داده می‌شوند. محدودیت ۳۰۰ کاراکتری.
  • از یک آرایه برای نشانه‌گذاری توضیحات به چندین زبان استفاده کنید. به مثال نمایش چندزبانه مراجعه کنید.
actor [ شخص یا گروه اجرایی یا نقش اجرایی] اکیداً توصیه می‌شود. چرا؟ مجموعه‌ای از بازیگران این فصل. راهنمای مدلینگ را اینجا ببینید.
director شخص به شدت توصیه می‌شود. چرا؟ مجموعه‌ای از کارگردانان این نمایش.
producer سازمان یا شخص اکیداً توصیه می‌شود. چرا؟ تهیه‌کننده(گان)ی این فصل.
image شیء تصویر تصاویر مربوط به فصل تلویزیون. برای جزئیات بیشتر در مورد ویژگی‌های مورد نیاز و اختیاری که باید به image اضافه شوند، به ویژگی‌های تصویر مراجعه کنید.
genre متن فهرستی مرتب از تمام ژانرهای مرتبط. برای مثال: ["Action", "Fashion", "Environment", "Football"]
keywords متن کلمات کلیدی یا برچسب‌هایی که برای توصیف این محتوا استفاده می‌شوند. آرایه‌ای از کلمات کلیدی نیز مجاز است. برای مثال، ["feature, biography"] می‌تواند آرایه‌ای از کلمات کلیدی برای توصیف محتوا باشد.
trailer.description متن توضیحات تریلر. به مثال تریلر مراجعه کنید.
trailer.inLanguage متن اکیداً توصیه می‌شود. زبان تریلر با فرمت BCP 47 است.
trailer.url آدرس اینترنتی نشانی اینترنتی (URL) تریلری که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز آپلود شده است.
trailer.regionsAllowed مکان مناطقی که رسانه‌ها مجاز هستند. اگر مشخص نشده باشند، فرض بر این است که در همه جا مجاز هستند. کشورها را با فرمت ISO 3166 مشخص کنید.
identifier ارزش ملک اکیداً توصیه می‌شود. چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این موجودیت را شناسایی کند. استفاده از چندین شناسه مجاز است. برای جزئیات بیشتر به بخش ویژگی‌های شناسه مراجعه کنید.
popularityScore امتیاز محبوبیتمشخصات چرا به شدت توصیه می‌شود؟ امتیازی که گوگل به همراه سایر سیگنال‌ها، برای تعیین اینکه کدام رسانه را برای کاربران پخش کند، استفاده می‌کند. این امتیاز، محبوبیت محتوا را در مقایسه با سایر محتوای موجود در کاتالوگ شما نشان می‌دهد؛ بنابراین، مقیاس امتیاز باید در فیدهای شما، در بین تمام موجودیت‌های موجود در کاتالوگ شما، ثابت باشد. به طور پیش‌فرض، امتیاز محبوبیت یک موجودیت روی ۰ تنظیم شده است.
popularityScore.@type متن همیشه روی PopularityScoreSpecification تنظیم شود.
popularityScore.value شماره یک مقدار عددی غیر منفی که محبوبیت موجودیت را نشان می‌دهد؛ امتیاز بالاتر به معنای محبوبیت بیشتر است.
popularityScore.eligibleRegion کشور منطقه(هایی) که این امتیاز محبوبیت در آن اعمال می‌شود. اگر امتیاز محبوبیت به صورت سراسری اعمال می‌شود، روی EARTH تنظیم شود. به طور پیش‌فرض، این ویژگی روی EARTH تنظیم شده است.
Note: محبوبیت محلی بر محبوبیت جهانی (زمین) اولویت دارد
review نقد و بررسی رتبه‌بندی‌های فصل تلویزیونی را بررسی کنید
review.reviewRating رتبه‌بندی در صورت ارائه review الزامی است. این فیلد برای مشخص کردن رتبه‌بندی ارائه شده در نقد و بررسی استفاده می‌شود.
contentRating متن یا امتیاز برای محتوای بزرگسالان الزامی است، در غیر این صورت اکیداً توصیه می‌شود - رتبه‌بندی کلی محتوا. اگر رتبه‌بندی محتوا به صورت رشته متنی ارائه شود، دو نوع تغییر پذیرفته می‌شود:
  • آژانس رتبه‌بندی با یک فاصله خالی در میان، به رتبه‌بندی اضافه شده است. برای مثال، رتبه‌بندی "TV-MA" از آژانس "TVPG" در ایالات متحده باید به صورت "TVPG TV-MA" توصیف شود. به فهرست آژانس‌ها مراجعه کنید.
  • مقداری برابر با «RATING NOT KNOWN» (بدون حساسیت به حروف بزرگ و کوچک) که نشان می‌دهد شما رتبه‌بندی محتوا را نمی‌دانید.
contentRating.author سازمان در صورت استفاده از Rating contentRating الزامی است - نام آژانس رتبه‌بندی. برای مشاهده فهرست آژانس‌های رتبه‌بندی پذیرفته‌شده، به صفحه آژانس‌های رتبه‌بندی محتوا مراجعه کنید.
contentRating.ratingValue متن اگر contentRating Rating استفاده کند، الزامی است - مقدار امتیاز.
contentRating.advisoryCode متن کد توصیه‌شده برای محتوا. مقادیر پذیرفته‌شده شامل D، FV، L، S و V هستند. D = گفتگو، FV = خشونت خیالی، L = زبان، S = محتوای جنسی، V = خشونت.

مشخصات بازیگر

ویژگی actor در انواع موجودیت TVSeries ، TVEpisode و TVSeason به شما امکان می‌دهد جزئیات بیشتری در مورد بازیگران، از جمله نام شخصیت‌های آنها و نقش‌هایی که در نمایش تلویزیونی ایفا می‌کنند، مشخص کنید. بخش(های) زیر همین موضوع را به همراه چند مثال برای روشن شدن کاربرد آن ارائه می‌دهد.

ملک نوع مورد انتظار توضیحات
actor شخص یا گروه اجرایی یا نقش اجرایی اکیداً توصیه می‌شود چرا؟ : مجموعه‌ای از بازیگران.
  • وقتی نقش بازی شده و (اختیاری) نام شخصیت عضو(ان) بازیگر مشخص است، از نوع PerformanceRole استفاده کنید. در این مورد، بازیگر Person یا PerformingGroup درون شیء PerformanceRole تعبیه شده است.
  • از نوع Person برای مشخص کردن بازیگر(ان) فردی یا PerformingGroup برای ارائه جزئیات گروه(های) اجرایی/گروه(های) گروهی، زمانی که نقش(های) ایفا شده توسط عضو(ان) بازیگر ناشناخته است، استفاده کنید.

از یک آرایه برای نمایش چندین Persons، PerformingGroups یا PerformanceRoles استفاده کنید.

استفاده از نوع‌های Person یا PerformingGroup

وقتی از نوع Person یا PerformingGroup استفاده می‌شود، ویژگی‌های زیر را ارائه دهید.

ملک نوع مورد انتظار توضیحات
@type شخص یا گروه اجرایی الزامی - همیشه روی Person یا PerformingGroup تنظیم شود
@id آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ - شناسه بازیگران یا گروه اجراکننده در قالب URI؛ برای مثال، https://example.com/actor/abc. @id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در کاتالوگ شما برای هر بازیگر/گروه اجرایی
  • شناسه باید پایدار باشد و با گذشت زمان تغییر نکند. به عنوان یک رشته مبهم در نظر گرفته می‌شود و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • سازمان شما باید مالک دامنه‌ای باشد که برای مقدار @id استفاده می‌شود.

توجه داشته باشید که @id استفاده شده در ویژگی actor باید به طور مداوم در سراسر feed استفاده شود. برای مثال، اگر دو فیلم با یک بازیگر وجود داشته باشد، مقدار @id باید در بین این دو شیء actor یکسان نگه داشته شود.

name متن الزامی - نام بازیگر/بازیگر زن/عضو گروه بازیگران/گروه اجرا.
sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ - یک URL به یک صفحه وب مرجع که بتواند بازیگر یا گروه اجراکننده را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای بازیگر. این باید از ویژگی @id متمایز باشد.

استفاده از نوع PerformanceRole

هنگام استفاده از نوع PerformanceRole، ویژگی‌های زیر را ارائه دهید.

ملک نوع مورد انتظار توضیحات
@type نقش عملکردی الزامی - همیشه روی PerformanceRole تنظیم شود
roleName متن اکیداً توصیه می‌شود. چرا؟ - نقشی که توسط یکی از بازیگران ایفا، اجرا یا تکمیل شده است. لطفاً فهرست مقادیر قابل قبول را اینجا ببینید.
characterName متن نام شخصیتی که در نقش بازیگری یا اجرا بازی می‌کند. اگر نوع بازیگر PerformingGroup است، این فیلد را تنظیم نکنید.
actor شخص یا گروه اجرایی مورد نیاز -
  • عضو(های) تبدیل‌کننده‌ی محتوا، زمانی که از نوع داده‌ی Person استفاده می‌شود.
  • گروه(های) اجرایی/باند(های) محتوایی که نوع داده PerformingGroup استفاده می‌شود.
actor.@type شخص یا گروه اجرایی الزامی - همیشه روی Person یا PerformingGroup تنظیم شود
actor.@id آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ - شناسه بازیگر یا گروه اجراکننده در قالب URI؛ برای مثال، https://example.com/actor/abc. @id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در کاتالوگ شما برای هر بازیگر/گروه اجرایی
  • شناسه باید پایدار باشد و با گذشت زمان تغییر نکند. به عنوان یک رشته مبهم در نظر گرفته می‌شود و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • سازمان شما باید مالک دامنه‌ای باشد که برای مقدار @id استفاده می‌شود.

توجه داشته باشید که @id استفاده شده در ویژگی actor باید به طور مداوم در سراسر feed استفاده شود. برای مثال، اگر دو فیلم با یک بازیگر وجود داشته باشد، مقدار @id باید در بین این دو شیء actor یکسان نگه داشته شود.

actor.name متن الزامی - نام بازیگر/بازیگر زن/عضو گروه بازیگران/گروه اجرا.
actor.sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ - یک URL به یک صفحه وب مرجع که می‌تواند بازیگر یا گروه اجراکننده را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای بازیگر. این باید از ویژگی actor.@id متمایز باشد.

نام‌های نقش قابل قبول

این مقادیر مستلزم آن هستند که actor.@type برابر با Person باشد.

مقدار roleName توضیحات
«کمئو» نقش افتخاری که به آن حضور افتخاری نیز گفته می‌شود، به حضور کوتاه یک فرد مشهور در یک اثر هنری گفته می‌شود.
«صداپیشه» اجرای صدا، اجرایی است که در آن از صدای بازیگر استفاده می‌شود اما خود بازیگر روی صفحه نمایش ظاهر نمی‌شود. این نوع اجرا بیشتر در انیمیشن دیده می‌شود، اما زمانی که صدای یک بازیگر روی صدای بازیگر دیگر دوبله می‌شود نیز اتفاق می‌افتد.
"دوبل" بدل کسی است که جایگزین بازیگر دیگری می‌شود، به طوری که چهره آن شخص نشان داده نمی‌شود.
«بازیگر موشن کپچر» یک MotionCaptureActor به شخصی اطلاق می‌شود که حرکات بازیگران انسانی را ضبط می‌کند و از آن اطلاعات برای متحرک‌سازی مدل‌های شخصیت دیجیتال در انیمیشن کامپیوتری دوبعدی یا سه‌بعدی استفاده می‌کند.

این مقادیر عموماً برای انواع Person و PerformingGroup پذیرفته می‌شوند.

مقدار roleName توضیحات
«بازیگر» بازیگر (یا هنرپیشه) کسی است که نقشی را در اجرا، چه در رسانه سنتی تئاتر و چه در رسانه‌های مدرن مانند سینما، رادیو و تلویزیون، به تصویر می‌کشد.
«ستاره مهمان» "A guest star is an actor who plays a fictional role and appears in one or a few episodes. In some cases a guest star may play an important recurring character and may appear many times in a series, despite not being a member of the main cast. Set value to "GuestStar" when the cast has a guest performance or is a guest on the show. Guest stars should only be provided at the episode level, and should not be added at the TVSeries level.
"Guest" "A guest on a talk show. Note that while "GuestStar" is a fictional role, "Guest" is a non fictional appearance.
"Announcer" An announcer is a person who delivers opening and closing spiels for the show, introduces the host, contestants and/or celebrity guests, describes the prizes available, and warms up the audience before taping and keeps them entertained during breaks.
"Commentator" A commentator provides a real-time commentary of a game or event, usually during a live broadcast.
"Impressionist" An impressionist or a mimic is a performer whose act consists of imitating sounds, voices and mannerisms of celebrities and cartoon characters.
"Host" A person who introduces, presents or hosts television programs, often serving as a mediator for the program and the audience. The "Host" is generally a non-fiction role.
"CoHost" A person who hosts an event/program jointly with another person(s).
"GuestHost" A guest host is a host, usually of a talk show, that hosts the program in lieu of the regular host when not available.
"Newscaster" A person who presents/informs the public about news and events happening on a local, national, and international scale through a TV news program.
"Correspondent" خبرنگار یا گزارشگر حاضر در محل معمولاً روزنامه‌نگار یا مفسر یک مجله یا نماینده‌ای است که از مکانی دور، اغلب دور، گزارش‌هایی را برای یک روزنامه، یا اخبار رادیو یا تلویزیون، یا نوع دیگری از شرکت‌ها تهیه می‌کند.
"ShowJudge" A judge is a person who is often considered an expert in the field of the show and is given the role of "judge" to critique contestants that audition for and enter the competition of the TV series.
"Panelist" A member of a discussion or advisory panel of a radio or television panel.
"Contestant" A contestant in a competition or game show is a person who takes part in it.
"StoryNarrator" Narrator is a person who narrates something, especially a character who recounts the events of a novel or narrative poem
"MusicalArtist" "A Musical artist can be a person or a group or a fictional character that have typically performed in front of an audience on a regular basis or have recorded musical tracks or musical albums. Composers and lyricists should only have this type if the credits of some musical work imply they also contribute as main performer. This type can be used to associate permanent Musicians or Musician Groups, and guest Musicians or Musician Groups to shows.

Differentiating between a main and supporting role of an actor

To differentiate between the main/regular and guest/supporting actors in a TV show, add the main cast on TVSeries entities only and add only the guest cast or cast with supporting roles on the TVEpisode entities. Make sure the main/regular cast is not added to the TVEpisode entities.

مثال‌ها

TVSeries , TVEpisode , and TVSeason example

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 property examples

Role of actor is unknown

When the role of an actor is unknown, our recommendation is to just provide the actor information using either the Person or PerformingGroup type

"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"
    }
  ]

Role of actor is known

When the role of an actor is known, our recommendation is to provide the actor information using the PerformanceRole type

"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"
      }
  }
]

Known roles for subset of actors

When performance role metadata is not known, our recommendation is to provide the actor information using either the Person or PerformingGroup type. For the other case where this info is known use the PerformanceRole type. These types can be added in the same array together .

"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"
  }
]

Check out the following pages for the topics related to these properties: