फ़िल्मों की कॉन्टेंट मार्कअप प्रॉपर्टी

इस सेक्शन में, Movie इकाई के टाइप के लिए कॉन्टेंट मार्कअप प्रॉपर्टी के बारे में जानकारी दी गई है.

खास जानकारी वाली टेबल

प्रॉपर्टी अनुमानित टाइप ब्यौरा
@context टेक्स्ट ज़रूरी है - हमेशा ["http://schema.org", {"@language": "xx"}]
पर सेट करें
  • कहां" एक्सएक्स" फ़ीड में स्ट्रिंग की भाषा को दिखाता है. हर रूट इकाई के कॉन्टेक्स्ट के लिए, BCP 47 फ़ॉर्मैट फ़ॉर्मैट में उसकी @languages सही भाषा कोड पर सेट होनी चाहिए. उदाहरण के लिए, अगर भाषा को स्पैनिश पर सेट किया गया है, तो नाम को स्पैनिश में माना जाएगा. भले ही, सबटाइटल की भाषा अंग्रेज़ी हो.
@type टेक्स्ट ज़रूरी है - फ़िल्मों के लिए हमेशा Movie पर सेट करें.
@id यूआरएल ज़रूरी है - यूआरआई फ़ॉर्मैट में कॉन्टेंट का आइडेंटिफ़ायर; उदाहरण के लिए, https://example.com/1234abc.
@id को ये ज़रूरी शर्तें पूरी करनी होंगी:
  • आपके कैटलॉग में दुनिया भर में यूनीक है
  • स्थिर; यह आईडी एक जैसा होना चाहिए और समय के साथ नहीं बदलना चाहिए. भले ही, शो की यूआरएल प्रॉपर्टी बदल जाए. इसे एक ओपेक स्ट्रिंग के रूप में देखा जाएगा और इसका कोई सक्रिय लिंक होना ज़रूरी नहीं है.
  • यूनिफ़ाइड रिसॉर्स आइडेंटिफ़ायर (यूआरआई) के तौर पर
  • @id वैल्यू के लिए इस्तेमाल किए गए डोमेन का मालिकाना हक आपके संगठन के पास होना चाहिए.
किसी इकाई का url, आइडेंटिफ़ायर के तौर पर सभी ज़रूरी शर्तों को पूरा करता है. इसलिए, हमारा सुझाव है कि आप इकाई के url को @id के तौर पर इस्तेमाल करें. ज़्यादा जानकारी के लिए, आइडेंटिफ़ायर सेक्शन देखें.
url यूआरएल ज़रूरी है - कॉन्टेंट का कैननिकल यूआरएल, जिसका इस्तेमाल Google आपके फ़ीड में मौजूद कॉन्टेंट को Google के डेटाबेस में मौजूद कॉन्टेंट से मैच करने के लिए करता है.
url को ये ज़रूरी शर्तें पूरी करनी होंगी:
  • url, दुनिया भर में यूनीक होना चाहिए
  • url में ऐसा कैननिकल यूआरएल शामिल होना चाहिए जो काम करता हो और जिसे Google क्रॉल कर सके.
प्लेबैक के डीप लिंक के लिए, टारगेट ऑब्जेक्ट की urlTemplate प्रॉपर्टी देखें.
name टेक्स्ट ज़रूरी है - मूवी का नाम.
  • अलग-अलग भाषाओं में नामों को लिस्ट करने के लिए, कलेक्शन का इस्तेमाल करें. एक से ज़्यादा इलाके और भाषाएं वाला उदाहरण देखें.
  • ध्यान दें कि हर स्थान-भाषा (भाषा और देश का जोड़ा) के लिए, सिर्फ़ एक नाम का इस्तेमाल किया जा सकता है.
titleEIDR टेक्स्ट इसका सुझाव दिया जाता है क्यों? - EIDR (एंटरटेनमेंट आइडेंटिफ़ायर रजिस्ट्री) आइडेंटिफ़ायर, जो फ़िल्म या टेलीविज़न के किसी कॉन्टेंट को सामान्य/पूरी जानकारी देने के लिए इस्तेमाल किया जाता है.

उदाहरण के लिए, "घोस्टबस्टर्स" नाम की मोशन पिक्चर के लिए titleEIDR "10.5240/7EC7-228A-510A-053E-CBB8-J" है.
editEIDR टेक्स्ट इसका सुझाव दिया जाता है क्यों? - EIDR (एंटरटेनमेंट आइडेंटिफ़ायर रजिस्ट्री) आइडेंटिफ़ायर, जो फ़िल्म या टेलीविज़न के किसी कॉन्टेंट के एडिट / संस्करण की जानकारी देता है.

उदाहरण के लिए, "घोस्टबस्टर्स" नाम की मोशन पिक्चर जिसका titleEIDR "10.5240/7EC7-228A-510A-053E-CBB8-J" है, जिसमें कई बदलाव किए गए हैं, जैसे कि "10.5240/1F2A-E1C5-680A-14C6-E76B-I" और "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

editEIDR दिए जाने पर, titleEIDR प्रॉपर्टी ज़रूरी है.
potentialAction WatchAction लागू होने पर ज़रूरी है - एक कार्रवाई मार्कअप ऑब्जेक्ट जो कार्रवाई की जानकारी देता है.
  • अगर कॉन्टेंट, वीडियो ऑन डिमांड (वीओडी) पर उपलब्ध है, तो इस प्रॉपर्टी की ज़रूरत होगी; कार्रवाई मार्कअप ऑब्जेक्ट को कॉन्टेंट का डीप लिंक देना ज़रूरी है.
  • अगर कॉन्टेंट किसी LiveTV चैनल पर उपलब्ध है, तो इस प्रॉपर्टी का इस्तेमाल करना ज़रूरी नहीं है; इससे जुड़ी BroadcastService इकाई, चैनल का डीप लिंक देती है.
  • Movie, VoD और LiveTV, दोनों पर उपलब्ध हो सकता है.
कई क्षेत्रों में अलग-अलग डीप लिंक तय करने के लिए, कलेक्शन का इस्तेमाल करें. एक से ज़्यादा इलाके और भाषाएं वाला उदाहरण देखें.
sameAs यूआरएल इसका सुझाव दिया जाता है क्यों? रेफ़रंस वाले वेब पेज का यूआरएल, जो फ़िल्म की पहचान कर सकता है; उदाहरण के लिए, फ़िल्म के Wikipedia पेज पर. यह 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 Date या DateTime सुझाया गया - ExclusiveEvent के लिए ज़रूरी है - इकाई के प्रकाशन की शुरू होने की तारीख.

PublicationEvent के लिए, यह इस इकाई के रिलीज़ होने की तारीख दिखाता है, जैसे कि वह तारीख जब किसी फ़िल्म को पहली बार सिनेमाघरों में रिलीज़ किया गया था.

ExclusiveEvent और FeaturedEvent के लिए, यह इकाई के खास होने या दिखाने के शुरू होने की तारीख दिखाता है.
releasedEvent.endDate Date या DateTime सुझाया गया - ExclusiveEvent के लिए ज़रूरी है - यह सिर्फ़ ExclusiveEvent और FeaturedEvent टाइप के लिए लागू होता है.

ExclusiveEvent के लिए, यह उस तारीख को दिखाता है जब कॉन्टेंट के अधिकार खत्म हो जाते हैं.

FeaturedEvent के लिए, यह उस आखिरी तारीख को दिखाता है जब कंपनी ने इकाई को दिखाया था.

अगर कॉन्टेंट हमेशा के लिए खास है या चुनिंदा है, तो endDate की मौजूदा तारीख से 20 साल बाद की तारीख सेट करें.
releasedEvent.publishedBy संगठन या व्यक्ति ज़रूरी नहीं - इस इकाई को पब्लिश करने वाला संगठन या व्यक्ति.
description टेक्स्ट इसका सुझाव दिया जाता है क्यों? फ़िल्म का सारांश. तथ्यों पर आधारित जवाब के बजाय, प्लॉट के सारांश को प्राथमिकता दी जाती है. 300 वर्ण की सीमा.
duration कुल समय ISO 8601 फ़ॉर्मैट में फ़िल्म का रनटाइम. कृपया इस फ़ॉर्मैट का इस्तेमाल करें: "PT00H00M".
director Person इसका सुझाव दिया जाता है क्यों? फ़िल्म के निर्देशक.
actor Person इसका सुझाव दिया जाता है क्यों? फ़िल्म के कलाकार(के) सदस्य.
producer संगठन या व्यक्ति इसका सुझाव दिया जाता है क्यों? फ़िल्म के निर्माता.
image ImageObject Google TV के लिए ज़रूरी है - फ़िल्म से जुड़ी इमेज. image के साथ शामिल की जाने वाली ज़रूरी और वैकल्पिक प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, इमेज प्रॉपर्टी देखें.
trailer.description टेक्स्ट ट्रेलर के बारे में जानकारी. ट्रेलर का उदाहरण देखें.
trailer.inLanguage टेक्स्ट BCP 47 फ़ॉर्मैट में ट्रेलर की भाषा.
trailer.url यूआरएल सार्वजनिक तौर पर होस्ट किए गए ट्रेलर का यूआरएल जिसे प्रोडक्शन स्टूडियो या अनुमति वाले सोर्स ने अपलोड किया हो.
trailer.regionsAllowed जगह वे इलाके जहां मीडिया चलाने की अनुमति है. अगर नीति के बारे में नहीं बताया गया है, तो माना जाता है कि इसे हर जगह इस्तेमाल करने की अनुमति है. ISO 3166 फ़ॉर्मैट में देश के नाम डालें.
identifier PropertyValue इसका सुझाव दिया जाता है क्यों? - बाहरी या अन्य आईडी, जो साफ़ तौर पर इस इकाई की पहचान करता है. एक से ज़्यादा आइडेंटिफ़ायर इस्तेमाल करने की अनुमति है. ज़्यादा जानकारी के लिए, आइडेंटिफ़ायर प्रॉपर्टी सेक्शन देखें.
review समीक्षा फ़िल्म की रेटिंग की समीक्षा करें
review.reviewRating Rating अगर समीक्षा की गई है, तो इसे भरना ज़रूरी है. इसका इस्तेमाल, समीक्षा में दी गई रेटिंग के बारे में बताने के लिए किया जाता है.
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 इसका सुझाव दिया जाता है क्यों? वह स्कोर जिसका इस्तेमाल Google करता है. इसमें दूसरे सिग्नल भी शामिल होते हैं. इससे यह तय किया जाता है कि लोगों के लिए कौनसा मीडिया चलाया जाए. इस स्कोर से यह पता चलता है कि आपके कैटलॉग में मौजूद दूसरे कॉन्टेंट के मुकाबले, कॉन्टेंट की लोकप्रियता कितनी है; इसलिए, आपके फ़ीड में और आपके कैटलॉग में मौजूद सभी इकाइयों के लिए, स्कोर का स्केल एक जैसा होना चाहिए. डिफ़ॉल्ट रूप से, किसी इकाई की लोकप्रियता का स्कोर 0 पर सेट होता है.
popularityScore.@type टेक्स्ट हमेशा PopularityScoreSpecification पर सेट करें.
popularityScore.value Number एक गैर-ऋणात्मक संख्यात्मक मान जो इकाई की लोकप्रियता को दिखाता है; ज़्यादा स्कोर का मतलब है ज़्यादा लोकप्रियता.
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 यूआरएल Movie वैरिएंट के लिए, यह प्रॉपर्टी उस Movie इकाई का @id उपलब्ध कराती है जिसका यह वैरिएंट है.
workExample.@type टेक्स्ट ज़रूरी है - हमेशा Movie पर सेट करें. इसे कई वैरिएंट वाले Movie के लिए कलेक्शन के तौर पर दिखाया जा सकता है.
workExample.@id यूआरएल ज़रूरी है - Movie वैरिएंट का @id.
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"
}

इन प्रॉपर्टी से जुड़े विषयों की जानकारी के लिए, इन पेजों पर जाएं: