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

این بخش جزئیات ویژگی‌های نشانه‌گذاری محتوا را برای انواع موجودیت‌های 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 توضیحات
«بازیگر» بازیگر (یا هنرپیشه) کسی است که نقشی را در اجرا، چه در رسانه سنتی تئاتر و چه در رسانه‌های مدرن مانند سینما، رادیو و تلویزیون، به تصویر می‌کشد.
«ستاره مهمان» «ستاره مهمان بازیگری است که نقشی داستانی را بازی می‌کند و در یک یا چند قسمت ظاهر می‌شود. در برخی موارد، یک ستاره مهمان ممکن است یک شخصیت مهم و تکرارشونده را بازی کند و با وجود اینکه عضوی از بازیگران اصلی نیست، بارها در یک سریال ظاهر شود. وقتی بازیگر نقش مهمان دارد یا مهمان نمایش است، مقدار را روی «ستاره مهمان» تنظیم کنید. ستاره‌های مهمان فقط باید در سطح قسمت ارائه شوند و نباید در سطح سریال تلویزیونی اضافه شوند.»
«مهمان» «مهمان یک برنامه گفتگو محور. توجه داشته باشید که در حالی که «ستاره مهمان» یک نقش داستانی است، «مهمان» یک حضور غیرداستانی است.»
«گوینده» گوینده کسی است که سخنرانی‌های آغازین و پایانی برنامه را ارائه می‌دهد، مجری، شرکت‌کنندگان و/یا مهمانان مشهور را معرفی می‌کند، جوایز موجود را شرح می‌دهد و قبل از ضبط، حضار را گرم می‌کند و در زمان استراحت آنها را سرگرم نگه می‌دارد.
«مفسر» مفسر، معمولاً در طول پخش زنده، تفسیری از یک بازی یا رویداد را در لحظه ارائه می‌دهد.
«امپرسیونیست» امپرسیونیست یا مقلد، هنرمندی است که کارش تقلید صدا، آوا و رفتار افراد مشهور و شخصیت‌های کارتونی است.
«میزبان» شخصی که برنامه‌های تلویزیونی را معرفی، ارائه یا میزبانی می‌کند و اغلب به عنوان واسطه بین برنامه و مخاطب عمل می‌کند. «مجری» عموماً نقشی غیرداستانی است.
"هم‌میزبان" شخصی که به طور مشترک با شخص/اشخاص دیگر میزبان یک رویداد/برنامه است.
"میزبان مهمان" مجری مهمان، معمولاً در یک برنامه گفتگومحور، به عنوان مجری برنامه حضور دارد که در صورت عدم دسترسی، به جای مجری اصلی، برنامه را اجرا می‌کند.
«گوینده خبر» شخصی که از طریق یک برنامه خبری تلویزیونی، اخبار و رویدادهایی را که در مقیاس محلی، ملی و بین‌المللی اتفاق می‌افتد، به اطلاع عموم می‌رساند/اطلاع‌رسانی می‌کند.
«خبرنگار» خبرنگار یا گزارشگر حاضر در محل معمولاً روزنامه‌نگار یا مفسر یک مجله یا نماینده‌ای است که از مکانی دور، اغلب دور، گزارش‌هایی را برای یک روزنامه، یا اخبار رادیو یا تلویزیون، یا نوع دیگری از شرکت‌ها تهیه می‌کند.
«قاضی نمایش» داور شخصی است که اغلب در حوزه برنامه به عنوان متخصص در نظر گرفته می‌شود و نقش «داور» را برای نقد شرکت‌کنندگانی که برای شرکت در آزمون ورودی و ورود به رقابت‌های سریال تلویزیونی انتخاب می‌شوند، به او می‌دهند.
«نماینده میزگرد» عضوی از یک هیئت بحث یا مشورتی در یک میزگرد رادیویی یا تلویزیونی.
«شرکت‌کننده» شرکت‌کننده در یک مسابقه یا نمایش بازی، شخصی است که در آن شرکت می‌کند.
«راوی داستان» راوی کسی است که چیزی را روایت می‌کند، به خصوص شخصیتی که وقایع یک رمان یا شعر روایی را بازگو می‌کند.
"هنرمند موسیقی" «یک هنرمند موسیقی می‌تواند یک شخص یا یک گروه یا یک شخصیت داستانی باشد که معمولاً به طور منظم در مقابل تماشاگران اجرا داشته یا قطعات موسیقی یا آلبوم‌های موسیقی ضبط کرده است. آهنگسازان و ترانه‌سرایان فقط در صورتی باید این نوع را داشته باشند که در اعتبار برخی از آثار موسیقیایی، آنها به عنوان نوازنده اصلی نیز مشارکت داشته باشند. این نوع می‌تواند برای مرتبط کردن نوازندگان یا گروه‌های موسیقی دائمی و نوازندگان یا گروه‌های موسیقی مهمان با نمایش‌ها استفاده شود.»

تفاوت قائل شدن بین نقش اصلی و فرعی یک بازیگر

برای تمایز قائل شدن بین بازیگران اصلی/معمولی و مهمان/فرعی در یک برنامه تلویزیونی، بازیگران اصلی را فقط در موجودیت‌های TVSeries اضافه کنید و فقط بازیگران مهمان یا بازیگرانی که نقش‌های فرعی دارند را در موجودیت‌های TVEpisode اضافه کنید. مطمئن شوید که بازیگران اصلی/معمولی به موجودیت‌های TVEpisode اضافه نشده باشند.

مثال‌ها

مثال‌های TVSeries ، TVEpisode و TVSeason

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

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

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

{
  "@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"
   }
}

فصل تلویزیون

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

برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید: