این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

جدول مشخصات

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

ویژگی	نوع مورد انتظار	شرح
`@context`	متن	الزامی - همیشه روی `["http://schema.org", {"@language": "xx"}]` تنظیم شود جایی که "xx" نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید زبان @ آن را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، فرض می شود که نام ها به زبان اسپانیایی باشند، حتی اگر زبان زیرنویس/دوبله به زبان انگلیسی باشد.
`@type`	متن	مورد نیاز - همیشه روی `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` شی مورد نظر را ببینید.
`name`	متن	مورد نیاز - نام نمایش. از یک آرایه برای فهرست کردن نام ها به زبان های مختلف استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید. توجه داشته باشید که تنها یک نام در هر منطقه (جفت زبان-کشور) پشتیبانی می شود.
`titleEIDR`	متن	بسیار توصیه می شود چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلی ترین/انتزاعی ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می دهد. به عنوان مثال، عنوانEIDR برای مجموعه تلویزیونی معروف به "بازی تاج و تخت" "10.5240/C1B5-3BA1-8991-A571-8472-W" است.
`potentialAction`	WatchAction	در صورت وجود الزامی است - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. اگر محتوا در ویدیوی درخواستی (VoD) موجود باشد، این ویژگی الزامی است. شی نشانه گذاری Action باید پیوند عمیق محتوا را ارائه دهد. اگر محتوا در یک کانال LiveTV در دسترس است، این ویژگی اختیاری است. موجودیت `BroadcastService` مرتبط پیوند عمیق کانال را به جای آن فراهم می کند. یک `TVSeries` می تواند هم در VoD و هم LiveTV در دسترس باشد. از یک آرایه برای تعیین پیوندهای عمیق مختلف در چندین منطقه استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
`sameAs`	URL	بسیار توصیه می شود چرا؟ URL به یک صفحه وب مرجع که می تواند نمایش را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا نمایش. این باید از ویژگی `url` متمایز باشد.
`inLanguage`	متن	زبان اصلی سریال در قالب BCP 47 .
`genre`	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: `["Action", "Fashion", "Environment", "Football"]`
`keywords`	متن	کلمات کلیدی یا برچسب هایی که برای توصیف این محتوا استفاده می شوند. آرایه ای از کلمات کلیدی نیز مجاز است. به عنوان مثال، ["ویژگی، بیوگرافی"] می تواند مجموعه ای از کلمات کلیدی برای توصیف محتوا باشد.
`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` روی 20 سال از تاریخ فعلی تنظیم کنید.
`releasedEvent.publishedBy`	سازمان یا شخص	اختیاری - سازمان یا شخصی که این نهاد را منتشر کرده است.
`description`	متن	بسیار توصیه می شود چرا؟ خلاصه ای از نمایش. خلاصه داستان ها به خلاصه های واقعی ترجیح داده می شوند. محدودیت 300 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
`actor`	Person یا PerformingGroup یا PerformanceRole	بسیار توصیه می شود چرا؟ مجموعه ای از بازیگران سریال. راهنمای مدلسازی را اینجا ببینید.
`director`	شخص	بسیار توصیه می شود چرا؟ کارگردان (های) نمایش.
`producer`	سازمان یا شخص	بسیار توصیه می شود چرا؟ تهیه کننده(های) نمایش.
`image`	ImageObject	مورد نیاز برای Google TV - تصاویر مربوط به مجموعه تلویزیونی. برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با `image` ، به ویژگی های تصویر مراجعه کنید.
`trailer.description`	متن	توضیحات تریلر. نمونه تریلر را ببینید.
`trailer.inLanguage`	متن	زبان تریلر در قالب BCP 47 .
`trailer.url`	URL	نشانی اینترنتی یک تریلر که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز بارگذاری شده است.
`trailer.regionsAllowed`	محل	مناطقی که رسانه مجاز است. اگر مشخص نشده باشد، فرض بر این است که در همه جا مجاز است. کشورها را در قالب ISO 3166 مشخص کنید.
`identifier`	PropertyValue	بسیار توصیه می شود چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این نهاد را شناسایی می کند. چندین شناسه مجاز است. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
`popularityScore`	PopularityScoreSpecification	بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن به‌علاوه سیگنال‌های دیگر استفاده می‌کند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است.
`popularityScore.@type`	متن	همیشه روی `PopularityScoreSpecification` تنظیم شود.
`popularityScore.value`	عدد	یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است.
`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`	متن	اگر `contentRating` Rating از `Rating` استفاده می کند - ارزش رتبه بندی الزامی است .
`contentRating.advisoryCode`	متن	کد مشاوره برای محتوا. مقادیر پذیرفته شده عبارتند از D، FV، L، S، و V. D = گفتگو، FV = خشونت فانتزی، L = زبان، S = محتوای جنسی، V = خشونت.

تی وی اپیزود

ویژگی	نوع مورد انتظار	شرح
`@context`	متن	الزامی - همیشه روی `["http://schema.org", {"@language": "xx"}]` تنظیم شود جایی که "xx" نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید زبان @ آن را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، فرض می شود که نام ها به زبان اسپانیایی باشند، حتی اگر زبان زیرنویس/دوبله به زبان انگلیسی باشد.
`@type`	متن	مورد نیاز - همیشه روی `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` شی مورد نظر را ببینید.
`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". هنگامی که editEIDR ارائه می شود، ویژگی `titleEIDR` مورد نیاز است.
`inLanguage`	متن	زبان اصلی سریال در قالب BCP 47 .
`episodeNumber`	عدد صحیح	مورد نیاز - عددی که موقعیت این قسمت را به ترتیب قسمت‌های یک فصل نشان می‌دهد. `episodeNumber` باید برای هر فصل دوباره شروع شود. یعنی اولین قسمت هر فصل باید 1 باشد.
`partOfSeason`	TV Season	مورد نیاز - فصل تلویزیونی که این قسمت متعلق به آن است. حتی اگر `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`	متن	مورد نیاز - همیشه روی `TVSeason` تنظیم شده است.
`partOfSeason.@id`	URL	الزامی - `@id` `TVSeason` که این قسمت بخشی از آن است.
`partOfSeason.seasonNumber`	عدد صحیح	مورد نیاز - عددی که موقعیت این فصل را به ترتیب فصل ها در سریال تلویزیونی نشان می دهد.
`partOfSeries`	سریال تلویزیونی	مورد نیاز - سریال تلویزیونی که این قسمت متعلق به آن است.
`partOfSeries.@type`	متن	مورد نیاز - همیشه روی `TVSeries` تنظیم شود.
`partOfSeries.@id`	URL	الزامی - `@id` `TVSeries` که این قسمت بخشی از آن است.
`partOfSeries.name`	متن	الزامی - نام سریال تلویزیونی.
`partOfSeries.sameAs`	متن	URL به یک صفحه وب مرجع که می تواند نمایش را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا نمایش. این باید از ویژگی `url` متمایز باشد.
`potentialAction`	WatchAction	در صورت وجود الزامی است - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. اگر محتوا در ویدیوی درخواستی (VoD) موجود باشد، این ویژگی الزامی است. شی نشانه گذاری Action باید پیوند عمیق محتوا را ارائه دهد. اگر محتوا در یک کانال LiveTV در دسترس است، این ویژگی اختیاری است. موجودیت `BroadcastService` مرتبط پیوند عمیق کانال را به جای آن فراهم می کند. `TVEpisode` می تواند در هر دو VoD و LiveTV در دسترس باشد. از یک آرایه برای تعیین پیوندهای عمیق مختلف در چندین منطقه استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
`sameAs`	بسیار توصیه می شود چرا؟ URL	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` روی 20 سال از تاریخ فعلی تنظیم کنید.
`releasedEvent.publishedBy`	سازمان یا شخص	اختیاری - سازمان یا شخصی که این نهاد را منتشر کرده است.
`description`	متن	بسیار توصیه می شود چرا؟ خلاصه ای از اپیزود. خلاصه داستان ها به خلاصه های واقعی ترجیح داده می شوند. محدودیت 300 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. مثال نمایش چند زبانه را ببینید.
`genre`	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: `["Action", "Fashion", "Environment", "Football"]`
`keywords`	متن	کلمات کلیدی یا برچسب هایی که برای توصیف این محتوا استفاده می شوند. آرایه ای از کلمات کلیدی نیز مجاز است. به عنوان مثال، ["ویژگی، بیوگرافی"] می تواند مجموعه ای از کلمات کلیدی برای توصیف محتوا باشد.
`actor`	Person یا PerformingGroup یا PerformanceRole	بسیار توصیه می شود چرا؟ مجموعه ای از بازیگران این قسمت. راهنمای مدلسازی را اینجا ببینید.
`director`	شخص	بسیار توصیه می شود چرا؟ کارگردان (های) قسمت.
`producer`	سازمان یا شخص	بسیار توصیه می شود چرا؟ تهیه کننده(های) فصل.
`image`	ImageObject	بسیار توصیه می شود چرا؟ برای Google TV - تصاویر مختلف مربوط به TVEpisode. برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با `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`	متن یا سازمان	اگر `contentRating` از `Rating` استفاده می کند - نام آژانس رتبه بندی الزامی است . برای مشاهده لیستی از آژانس های رتبه بندی پذیرفته شده به صفحه آژانس های رتبه بندی محتوا مراجعه کنید
`contentRating.ratingValue`	متن	اگر `contentRating` Rating از `Rating` استفاده می کند - ارزش رتبه بندی الزامی است .
`contentRating.advisoryCode`	متن	کد مشاوره برای محتوا. مقادیر پذیرفته شده عبارتند از D، FV، L، S، و V. D = گفتگو، FV = خشونت فانتزی، L = زبان، S = محتوای جنسی، V = خشونت.
`identifier`	PropertyValue	بسیار توصیه می شود چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این نهاد را شناسایی می کند. چندین شناسه مجاز است. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
`popularityScore`	PopularityScoreSpecification	بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن به‌علاوه سیگنال‌های دیگر استفاده می‌کند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است.
`popularityScore.@type`	متن	همیشه روی `PopularityScoreSpecification` تنظیم شود.
`popularityScore.value`	عدد	یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است.
`popularityScore.eligibleRegion`	کشور	منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی `EARTH` تنظیم کنید. به طور پیش فرض، این ویژگی روی `EARTH` تنظیم شده است. `Note:` محبوبیت خاص محلی بر محبوبیت جهانی (EARTH) اولویت دارد

TV Season

ویژگی	نوع مورد انتظار	شرح
`@context`	متن	الزامی - همیشه روی `["http://schema.org", {"@language": "xx"}]` تنظیم شود جایی که "xx" نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید زبان @ آن را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، فرض می شود که نام ها به زبان اسپانیایی باشند، حتی اگر زبان زیرنویس/دوبله به زبان انگلیسی باشد.
`@type`	متن	مورد نیاز - همیشه روی `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` شی مورد نظر را ببینید.
`name`	متن	مورد نیاز - نام این فصل تلویزیونی. از یک آرایه برای فهرست کردن نام ها به زبان های مختلف استفاده کنید. مثال نمایش چند زبانه را ببینید. توجه داشته باشید که تنها یک نام در هر منطقه (جفت زبان-کشور) پشتیبانی می شود.
`titleEIDR`	متن	بسیار توصیه می شود چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلی ترین/انتزاعی ترین سطح، یک اثر سینمایی یا تلویزیونی را نشان می دهد. به عنوان مثال، عنوانEIDR برای فصل اول سریال تلویزیونی معروف به "بازی تاج و تخت" "10.5240/FD91-C72C-4161-FCBA-058B-1" است.
`seasonNumber`	عدد صحیح	مورد نیاز - عددی که موقعیت این فصل را به ترتیب فصل ها در سریال تلویزیونی نشان می دهد.
`partOfSeries`	سریال تلویزیونی	مورد نیاز - سریال تلویزیونی که این فصل متعلق به آن است.
`partOfSeries.@type`	متن	مورد نیاز - همیشه روی `TVSeries` تنظیم شود.
`partOfSeries.@id`	URL	الزامی - `@id` `TVSeries` که این فصل بخشی از آن است.
`partOfSeries.name`	متن	الزامی - نام سریال تلویزیونی.
`partOfSeries.sameAs`	متن	URL به یک صفحه وب مرجع که می تواند نمایش را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا نمایش. این باید از ویژگی `url` متمایز باشد.
`potentialAction`	WatchAction	در صورت وجود الزامی است - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. اگر محتوا در ویدیوی درخواستی (VoD) موجود باشد، این ویژگی الزامی است. شی نشانه گذاری Action باید پیوند عمیق محتوا را ارائه دهد. اگر محتوا در یک کانال LiveTV در دسترس است، این ویژگی اختیاری است. موجودیت `BroadcastService` مرتبط پیوند عمیق کانال را به جای آن فراهم می کند. `TVSeason` می تواند هم در VoD و هم LiveTV در دسترس باشد. از یک آرایه برای تعیین پیوندهای عمیق مختلف در چندین منطقه استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
`sameAs`	URL	بسیار توصیه می شود چرا؟ 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` روی 20 سال از تاریخ فعلی تنظیم کنید.
`releasedEvent.publishedBy`	سازمان یا شخص	اختیاری - سازمان یا شخصی که این نهاد را منتشر کرده است.
`description`	متن	بسیار توصیه می شود چرا؟ خلاصه ای از فصل. خلاصه داستان ها به خلاصه های واقعی ترجیح داده می شوند. محدودیت 300 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. مثال نمایش چند زبانه را ببینید.
`actor`	[ Person or PerformingGroup or PerformanceRole	بسیار توصیه می شود چرا؟ مجموعه ای از بازیگران این فصل. راهنمای مدلسازی را اینجا ببینید.
`director`	شخص	بسیار توصیه می شود چرا؟ مجموعه ای از کارگردانان نمایش.
`producer`	سازمان یا شخص	بسیار توصیه می شود چرا؟ تهیه کننده(های) فصل.
`image`	ImageObject	تصاویر مربوط به TVSeason. برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با `image` ، به ویژگی های تصویر مراجعه کنید.
`genre`	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: `["Action", "Fashion", "Environment", "Football"]`
`keywords`	متن	کلمات کلیدی یا برچسب هایی که برای توصیف این محتوا استفاده می شوند. آرایه ای از کلمات کلیدی نیز مجاز است. به عنوان مثال، ["ویژگی، بیوگرافی"] می تواند مجموعه ای از کلمات کلیدی برای توصیف محتوا باشد.
`trailer.description`	متن	توضیحات تریلر. نمونه تریلر را ببینید.
`trailer.inLanguage`	متن	زبان تریلر در قالب BCP 47 .
`trailer.url`	URL	نشانی اینترنتی یک تریلر که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز بارگذاری شده است.
`trailer.regionsAllowed`	محل	مناطقی که رسانه مجاز است. اگر مشخص نشده باشد، فرض بر این است که در همه جا مجاز است. کشورها را در قالب ISO 3166 مشخص کنید.
`identifier`	PropertyValue	بسیار توصیه می شود چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این نهاد را شناسایی می کند. چندین شناسه مجاز است. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
`popularityScore`	PopularityScoreSpecification	بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن به‌علاوه سیگنال‌های دیگر استفاده می‌کند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است.
`popularityScore.@type`	متن	همیشه روی `PopularityScoreSpecification` تنظیم شود.
`popularityScore.value`	عدد	یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است.
`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`	متن	اگر `contentRating` Rating از `Rating` استفاده می کند - ارزش رتبه بندی الزامی است .
`contentRating.advisoryCode`	متن	کد مشاوره برای محتوا. مقادیر پذیرفته شده عبارتند از D، FV، L، S، و V. D = گفتگو، FV = خشونت فانتزی، L = زبان، S = محتوای جنسی، V = خشونت.

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

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

ویژگی نوع مورد انتظار شرح

ویژگی	نوع مورد انتظار	شرح
`actor`	Person یا PerformingGroup یا PerformanceRole	بسیار توصیه می شود چرا؟ : آرایه ای از بازیگران. زمانی که نقش بازی شده و (به صورت اختیاری) نام کاراکتر بازیگر(ها) مشخص است از نوع PerformanceRole استفاده کنید. Actor Person یا PerformingGroup در داخل شی PerformanceRole در این مورد تعبیه شده است. از نوع Person برای نشان دادن بازیگر(های) منفرد یا PerformingGroup برای ارائه جزئیات گروه(ها)/باند(های) اجرا کننده زمانی که نقش(های) ایفای نقش توسط اعضای بازیگر ناشناخته است استفاده کنید. از یک آرایه برای نمایش چندین شخص، PerformingGroups یا PerformanceRoles استفاده کنید.

actor

Person یا PerformingGroup یا PerformanceRole

بسیار توصیه می شود چرا؟ : آرایه ای از بازیگران.

زمانی که نقش بازی شده و (به صورت اختیاری) نام کاراکتر بازیگر(ها) مشخص است از نوع PerformanceRole استفاده کنید. Actor Person یا PerformingGroup در داخل شی PerformanceRole در این مورد تعبیه شده است.
از نوع Person برای نشان دادن بازیگر(های) منفرد یا PerformingGroup برای ارائه جزئیات گروه(ها)/باند(های) اجرا کننده زمانی که نقش(های) ایفای نقش توسط اعضای بازیگر ناشناخته است استفاده کنید.

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

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

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

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

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

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

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

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

برای این مقادیر actor.@type باید Person باشد.

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

این مقادیر به طور کلی برای انواع Person و PerformingGroup پذیرفته شده است.

مقدار `roleName`	شرح
"بازیگر"	An actor or actress is a person who portrays a character in a performance in the traditional medium of the theater or in modern media such as film, radio, and television.
"GuestStar"	"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"	A correspondent or on-the-scene reporter is usually a journalist or commentator for a magazine, or an agent who contributes reports to a newspaper, or radio or television news, or another type of company, from a remote, often distant, location.
"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.

Examples

`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: