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

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

جدول مشخصات

ویژگی	نوع مورد انتظار	شرح
@context	متن	الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود جایی که "xx" نشان دهنده زبان رشته ها در فید است. هر زمینه موجودیت ریشه باید زبان @ خود را روی کد زبان مناسب در قالب BCP 47 تنظیم کند. به عنوان مثال، اگر زبان روی اسپانیایی تنظیم شده باشد، فرض می شود که نام ها به زبان اسپانیایی باشند، حتی اگر زبان زیرنویس/دوبله به زبان انگلیسی باشد.
@type	متن	مورد نیاز - همیشه روی Movie برای فیلم تنظیم شده است.
@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/7EC7-228A-510A-053E-CBB8-J" است.
editEIDR	متن	بسیار توصیه می شود چرا؟ - یک شناسه EIDR (ثبت شناسه سرگرمی) که نشان دهنده یک ویرایش / ویرایش خاص برای یک اثر سینمایی یا تلویزیونی است. برای مثال، فیلمی که با نام «شکارچیان ارواح» شناخته می‌شود و عنوان EIDR آن «10.5240/7EC7-228A-510A-053E-CBB8-J» است، چندین ویرایش دارد، به‌عنوان مثال «10.5240/1F2A-E1C5-680A-14C6-I» و E76 "10.5240/8A35-3BEE-6497-5D12-9E4F-3". هنگامی که editEIDR ارائه می شود، ویژگی titleEIDR مورد نیاز است.
potentialAction	WatchAction	در صورت وجود الزامی است - یک شی نشانه گذاری Action که جزئیات عمل را ارائه می دهد. اگر محتوا در ویدیوی درخواستی (VoD) موجود باشد، این ویژگی الزامی است. شی نشانه گذاری Action باید پیوند عمیق محتوا را ارائه دهد. اگر محتوا در یک کانال LiveTV در دسترس است، این ویژگی اختیاری است. موجودیت BroadcastService مرتبط پیوند عمیق کانال را به جای آن فراهم می کند. یک Movie می تواند هم در VoD و هم LiveTV در دسترس باشد. از یک آرایه برای تعیین پیوندهای عمیق مختلف در چندین منطقه استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
sameAs	URL	بسیار توصیه می شود چرا؟ URL به یک صفحه وب مرجع که می تواند فیلم را شناسایی کند. به عنوان مثال، صفحه ویکی پدیا فیلم. این باید از ویژگی url متمایز باشد.
inLanguage	متن	زبان اصلی فیلم با فرمت BCP 47 .
genre	متن	فهرستی مرتب شده از همه ژانرهای مرتبط. به عنوان مثال: ["عمل"، "مد"، "محیط زیست"، "فوتبال"]
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 کاراکتر از یک آرایه برای علامت گذاری توضیحات در چندین زبان استفاده کنید. به مثال چندین منطقه و زبان مراجعه کنید.
duration	مدت زمان	زمان پخش فیلم با فرمت ISO 8601 . لطفا از قالب استفاده کنید: "PT00H00M".
director	شخص	بسیار توصیه می شود چرا؟ کارگردان(های) فیلم.
actor	شخص	بسیار توصیه می شود چرا؟ بازیگران فیلم.
producer	سازمان یا شخص	بسیار توصیه می شود چرا؟ تهیه کننده (های) فیلم.
image	ImageObject	مورد نیاز برای Google TV - تصاویر مربوط به فیلم. برای جزئیات بیشتر در مورد ویژگی های مورد نیاز و اختیاری برای گنجاندن با image ، به ویژگی های تصویر مراجعه کنید.
trailer.description	متن	توضیحات تریلر. نمونه تریلر را ببینید.
trailer.inLanguage	متن	زبان تریلر در قالب BCP 47 .
trailer.url	URL	نشانی اینترنتی یک تریلر که به صورت عمومی میزبانی شده و توسط استودیوهای تولید مربوطه یا منابع مجاز بارگذاری شده است.
trailer.regionsAllowed	محل	مناطقی که رسانه مجاز است. اگر مشخص نشده باشد، فرض بر این است که در همه جا مجاز است. کشورها را در قالب ISO 3166 مشخص کنید.
identifier	PropertyValue	بسیار توصیه می شود چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این نهاد را شناسایی می کند. چندین شناسه مجاز است. برای جزئیات بیشتر به بخش خصوصیات شناسه مراجعه کنید.
review	مرور	بررسی رتبه بندی برای فیلم
review.reviewRating	رتبه بندی	در صورت ارائه بررسی الزامی است. این برای مشخص کردن امتیاز داده شده در بررسی استفاده می شود.
contentRating	متن یا رتبه	برای محتوای بزرگسالان مورد نیاز است، به شدت توصیه می شود در غیر این صورت چرا؟ - رتبه بندی کلی محتوا. اگر رتبه بندی محتوا در قالب یک رشته متن داده شود، دو تغییر پذیرفته می شود: آژانس رتبه‌بندی با یک فضای خالی در بین آن رتبه‌بندی را نشان می‌دهد. به عنوان مثال، رتبه بندی "PG-13" از آژانس "MPAA" در ایالات متحده باید به عنوان "MPAA PG-13" توصیف شود. لیست نمایندگی ها را ببینید. مقدار "RATING NOT KNOWN" (بدون حساس به حروف بزرگ) که نشان می دهد رتبه بندی فیلم را نمی دانید.
contentRating.author	سازمان	اگر contentRating از Rating استفاده می کند - نام آژانس رتبه بندی الزامی است .
contentRating.ratingValue	متن	اگر contentRating از Rating استفاده می کند - ارزش رتبه بندی الزامی است .
contentRating.advisoryCode	متن	کد مشاوره برای محتوا. مقادیر پذیرفته شده عبارتند از D، FV، L، S، و V. D = گفتگو، FV = خشونت فانتزی، L = زبان، S = محتوای جنسی، V = خشونت.
popularityScore	PopularityScoreSpecification	بسیار توصیه می شود چرا؟ امتیازی که گوگل از آن به‌علاوه سیگنال‌های دیگر استفاده می‌کند تا مشخص کند کدام رسانه برای کاربران پخش شود. این امتیاز نشان دهنده محبوبیت محتوا در رابطه با محتوای دیگر در کاتالوگ شما است. بنابراین، مقیاس امتیاز باید در میان فیدهای شما، در میان تمام موجودات موجود در کاتالوگ شما، سازگار باشد. به طور پیش فرض، امتیاز محبوبیت یک موجودیت روی 0 تنظیم شده است.
popularityScore.@type	متن	همیشه روی PopularityScoreSpecification تنظیم شود.
popularityScore.value	عدد	یک مقدار عددی غیر منفی که نشان دهنده محبوبیت موجودیت است. نمره بالاتر به معنای محبوبیت بالاتر است.
popularityScore.eligibleRegion	کشور	منطقه(های) جایی که این امتیاز محبوبیت قابل استفاده است. اگر امتیاز محبوبیت در سطح جهانی قابل اجرا است، روی EARTH تنظیم کنید. به طور پیش فرض، این ویژگی روی EARTH تنظیم شده است. Note: محبوبیت خاص محلی بر محبوبیت جهانی (EARTH) اولویت دارد
category	متن	در صورت وجود الزامی است - اگر موجودیت یک نوع Movie است، این ویژگی را پر کنید. category روی یکی از موارد زیر تنظیم کنید: Home Release : نسخه فروخته یا اجاره شده برای مشاهده در خانه. Theatrical Release : نسخه ای که در سینماها منتشر شد. International Release : نسخه ای ویرایش شده تا در سطح بین المللی منتشر شود. Remastered : نسخه ای که تصاویر، صدا، یا هر دو به استانداردهای به روزتری ارتقا یافته است. Unrated : نسخه ای که توسط MPAA یا آژانس های مشابه غربالگری نشده است. Director Cut : نسخه ای که نشان دهنده ویرایش تایید شده خود کارگردان است. Extended Cut : نسخه‌ای که طولانی‌تر از نسخه نمایشی آن است.
workExample	فیلم سینما	انواع فیلم را مشخص می کند. این ویژگی را در موجودیت اصلی Movie قرار دهید، نه موجودیت‌های Movie را برای نسخه‌های مختلف.
workExample.@id	URL	برای انواع Movie ، این ویژگی @id موجودیت Movie را ارائه می‌کند که این یک نوع آن است.
workExample.@type	متن	مورد نیاز - همیشه روی Movie تنظیم شود. این را می توان به عنوان یک آرایه برای یک Movie با انواع مختلف نشان داد.
workExample.@id	URL	مورد نیاز - @id نوع Movie .
workExample.name	متن	مورد نیاز - نام نوع Movie .
workExample.category	متن	مورد نیاز - نوع نوع فیلم یک نسخه خاص. دسته را روی یکی از موارد زیر تنظیم کنید: Home Release : نسخه فروخته یا اجاره شده برای مشاهده در خانه. Theatrical Release : نسخه ای که در سینماها منتشر شد. International Release : نسخه ای ویرایش شده تا در سطح بین المللی منتشر شود. Remastered : نسخه ای که تصاویر، صدا، یا هر دو به استانداردهای به روزتری ارتقا یافته است. Unrated : نسخه ای که توسط MPAA یا آژانس های مشابه غربالگری نشده است. Director Cut : نسخه ای که نشان دهنده ویرایش تایید شده خود کارگردان است. Extended Cut : نسخه‌ای که طولانی‌تر از نسخه نمایشی آن است.

مثال

فیلم اصلی

فیلمی با کات اکستنشن.

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

صفحات مرتبط

برای موضوعات مرتبط با این خواص، صفحات زیر را بررسی کنید:

• انواع موجودیت محتوای خود را شناسایی کنید
• شناسه، URL و نام محتوای خود را جمع آوری کنید
• ابرداده های محتوای خود را جمع آوری کنید