این بخش جزئیات ویژگیهای نشانهگذاری محتوا را برای نوع موجودیت Movie ارائه میدهد.
جدول مشخصات
| ملک | نوع مورد انتظار | توضیحات |
|---|---|---|
@context | متن | الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
|
@type | متن | الزامی - برای فیلمها، همیشه روی Movie تنظیم شود. |
@id | آدرس اینترنتی | الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .@id باید شرایط زیر را داشته باشد:
url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده میکند، توصیه میکنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید. |
url | آدرس اینترنتی | الزامی - نشانی اینترنتی متعارف محتوا، که گوگل از آن برای تطبیق محتوای فید شما با محتوای موجود در پایگاههای داده گوگل استفاده میکند.url باید شرایط زیر را داشته باشد:
urlTemplate شیء هدف مراجعه کنید. |
name | متن | الزامی - نام فیلم.
|
titleEIDR | متن | اکیداً توصیه میشود. چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که در کلیترین/انتزاعیترین سطح، یک اثر سینمایی یا تلویزیونی را نشان میدهد. برای مثال، عنوان EIDR برای فیلم سینمایی «شکارچیان ارواح» به صورت «10.5240/7EC7-228A-510A-053E-CBB8-J» است. |
editEIDR | متن | اکیداً توصیه میشود. چرا؟ - شناسه EIDR (ثبت شناسه سرگرمی) که نشاندهنده ویرایش/نسخه خاصی از یک اثر سینمایی یا تلویزیونی است. برای مثال، فیلم سینمایی معروف به «شکارچیان ارواح» که عنوان EIDR آن «10.5240/7EC7-228A-510A-053E-CBB8-J» است، ویرایشهای مختلفی دارد، مثلاً «10.5240/1F2A-E1C5-680A-14C6-E76B-I» و «10.5240/8A35-3BEE-6497-5D12-9E4F-3». ویژگی titleEIDR هنگام ارائه editEIDR الزامی است. |
potentialAction | تماشا کنید | در صورت لزوم - یک شیء نشانهگذاری اکشن که جزئیات اکشن را ارائه میدهد.
|
sameAs | آدرس اینترنتی | اکیداً توصیه میشود. چرا؟ یک URL به یک صفحه وب مرجع که بتواند فیلم را شناسایی کند؛ برای مثال، صفحه ویکیپدیای فیلم. این باید از ویژگی url متمایز باشد. |
inLanguage | متن | زبان اصلی فیلم با فرمت BCP 47 اکیداً توصیه میشود . |
genre | متن | فهرستی مرتب از تمام ژانرهای مرتبط. برای مثال: ["اکشن"، "مد"، "محیط زیست"، "فوتبال"] |
keywords | متن | کلمات کلیدی یا برچسبهایی که برای توصیف این محتوا استفاده میشوند. آرایهای از کلمات کلیدی نیز مجاز است. برای مثال، ["feature, biography"] میتواند آرایهای از کلمات کلیدی برای توصیف محتوا باشد. |
releasedEvent | PublicationEvent ، FeaturedEvent یا ExclusiveEvent | اکیداً توصیه میشود چرا؟ - PublicationEvent برای مشخص کردن تاریخ انتشار اولیه (جهانی یا محلی) محتوا توسط ناشر، مانند تاریخ انتشار اولیه یک فیلم در سینما، استفاده میشود.علاوه بر این، FeaturedEvent استفاده کنید تا نشان دهید که سرویس شما این محتوا را به عنوان یک محتوای اصلی، ویژه، ویژه و غیره به بازار عرضه میکند.ExclusiveEvent مشخص میکند که سرویس شما دارای حق توزیع انحصاری است و مکان و زمان آن را نیز مشخص میکند.برای جزئیات و مثالها به بخش نمونهها مراجعه کنید. |
releasedEvent.@type | متن | الزامی - حتماً همیشه این ویژگی را روی یکی از موارد زیر تنظیم کنید:
|
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 | متن | اکیداً توصیه میشود. چرا؟ خلاصهای از فیلم. خلاصه داستان به خلاصههای واقعی ترجیح داده میشود. محدودیت ۳۰۰ کاراکتری.
|
duration | مدت زمان | زمان اجرای فیلم با فرمت ISO 8601. لطفاً از فرمت "PT00H00M" استفاده کنید. |
director | شخص | به شدت توصیه میشود. چرا؟ کارگردان(گان) فیلم. |
actor | شخص | به شدت توصیه میشود. چرا؟ بازیگران فیلم. |
producer | سازمان یا شخص | اکیداً توصیه میشود. چرا؟ تهیهکننده(گان) فیلم. |
image | شیء تصویر | مورد نیاز برای گوگل تیوی - تصاویر مربوط به فیلم. برای جزئیات بیشتر در مورد ویژگیهای مورد نیاز و اختیاری که باید همراه image باشند، به ویژگیهای تصویر مراجعه کنید. |
trailer.description | متن | توضیحات تریلر. به مثال تریلر مراجعه کنید. |
trailer.inLanguage | متن | اکیداً توصیه میشود. زبان تریلر با فرمت BCP 47 است. |
trailer.url | آدرس اینترنتی | نشانی اینترنتی (URL) تریلری که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز آپلود شده است. |
trailer.regionsAllowed | مکان | مناطقی که رسانهها مجاز هستند. اگر مشخص نشده باشند، فرض بر این است که در همه جا مجاز هستند. کشورها را با فرمت ISO 3166 مشخص کنید. |
identifier | ارزش ملک | اکیداً توصیه میشود. چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این موجودیت را شناسایی کند. استفاده از چندین شناسه مجاز است. برای جزئیات بیشتر به بخش ویژگیهای شناسه مراجعه کنید. |
review | نقد و بررسی | امتیازدهی به فیلم |
review.reviewRating | رتبهبندی | در صورت ارائه نقد و بررسی، الزامی است. این برای مشخص کردن رتبهبندی ارائه شده در نقد و بررسی استفاده میشود. |
contentRating | متن یا امتیاز | برای محتوای بزرگسالان الزامی است، در غیر این صورت اکیداً توصیه میشود . چرا؟ - رتبهبندی کلی محتوا. اگر رتبهبندی محتوا به صورت رشته متنی ارائه شود، دو نوع مختلف آن پذیرفته میشود:
|
contentRating.author | سازمان | در صورتی که contentRating Rating استفاده کند، الزامی است - نام آژانس رتبهبندی. |
contentRating.ratingValue | متن | اگر contentRating Rating استفاده کند، الزامی است - مقدار امتیاز. |
contentRating.advisoryCode | متن | کد توصیهشده برای محتوا. مقادیر پذیرفتهشده شامل D، FV، L، S و V هستند. D = گفتگو، FV = خشونت خیالی، L = زبان، S = محتوای جنسی، V = خشونت. |
popularityScore | امتیاز محبوبیتمشخصات | چرا به شدت توصیه میشود؟ امتیازی که گوگل به همراه سایر سیگنالها، برای تعیین اینکه کدام رسانه را برای کاربران پخش کند، استفاده میکند. این امتیاز، محبوبیت محتوا را در مقایسه با سایر محتوای موجود در کاتالوگ شما نشان میدهد؛ بنابراین، مقیاس امتیاز باید در فیدهای شما، در بین تمام موجودیتهای موجود در کاتالوگ شما، ثابت باشد. به طور پیشفرض، امتیاز محبوبیت یک موجودیت روی ۰ تنظیم شده است. |
popularityScore.@type | متن | همیشه روی PopularityScoreSpecification تنظیم شود. |
popularityScore.value | شماره | یک مقدار عددی غیر منفی که محبوبیت موجودیت را نشان میدهد؛ امتیاز بالاتر به معنای محبوبیت بیشتر است. |
popularityScore.eligibleRegion | کشور | منطقه(هایی) که این امتیاز محبوبیت در آن اعمال میشود. اگر امتیاز محبوبیت به صورت سراسری اعمال میشود، روی EARTH تنظیم شود. به طور پیشفرض، این ویژگی روی EARTH تنظیم شده است.Note: محبوبیت محلی بر محبوبیت جهانی (زمین) اولویت دارد |
category | متن | در صورت لزوم الزامی است - اگر موجودیت از نوع Movie است، این ویژگی را پر کنید. category روی یکی از موارد زیر تنظیم کنید:
|
workExample | فیلم | انواع فیلم را مشخص میکند. این ویژگی را در موجودیت اصلی Movie قرار دهید، نه در موجودیتهای Movie برای نسخههای مختلف. |
workExample.@id | آدرس اینترنتی | برای گونههای Movie ، این ویژگی @id موجودیت Movie را که این گونه از آن است، ارائه میدهد. |
workExample.@type | متن | الزامی - همیشه روی Movie تنظیم شود. این میتواند به عنوان یک آرایه برای یک Movie با چندین نوع نمایش داده شود. |
workExample.@id | آدرس اینترنتی | الزامی - @id مربوط به گونهی Movie . |
workExample.name | متن | الزامی - نام گونهی Movie . |
workExample.category | متن | الزامی - نوع فیلم از یک نسخه خاص. دستهبندی را روی یکی از موارد زیر تنظیم کنید:
|
مثال
فیلم اصلی
فیلمی با نسخهٔ کات گسترده.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
نوع برش طولانی
نسخهٔ کامل و فشردهشدهٔ فیلم اصلی.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
صفحات مرتبط
برای مباحث مربوط به این املاک، صفحات زیر را بررسی کنید: