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

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

स्पेसिफ़िकेशन टेबल

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

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

उदाहरण के लिए, "Ghostbusters" नाम की मोशन पिक्चर, जिसका शीर्षकEIDR "10.5240/7EC7-228A-510A-053E-C"8-4", "3-3"-""-3-3-3"-" से 3-5-3" "4 से 3-4" बदलाव करने के लिए EIDR दिए जाने पर,

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

PublicationEvent के लिए, यह इकाई के रिलीज़ होने की शुरुआती तारीख बताती है, जैसे कि थिएटर में पहली बार फ़िल्म रिलीज़ होने की तारीख.

ExclusiveEvent और FeaturedEvent के लिए, वह तारीख जब इकाई को खास तौर पर दिखाया जाता है या उसे दिखाया जाता है.
releasedEvent.endDate तारीख या तारीख और समय सुझाया गया - 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 रेटिंग अगर समीक्षा की गई है, तो कार्रवाई करना ज़रूरी है. इसका इस्तेमाल समीक्षा में दी गई रेटिंग बताने के लिए किया जाता है.
contentRating टेक्स्ट या रेटिंग वयस्कों के लिए बने कॉन्टेंट के लिए ज़रूरी है, नहीं तो क्यों? - कुल कॉन्टेंट रेटिंग. अगर कॉन्टेंट रेटिंग किसी टेक्स्ट स्ट्रिंग के रूप में दी गई है, तो दो वैरिएशन स्वीकार किए जाते हैं:
  • रेटिंग एजेंसी ने रेटिंग से पहले, बीच में एक खाली सफ़ेद जगह जोड़ी है. उदाहरण के लिए, अमेरिका में "MPAA" एजेंसी की "PG-13" रेटिंग "MPAA PG-13" के रूप में बताई जानी चाहिए. एजेंसी की सूची देखें.
  • यह बताने के लिए कि आपको फ़िल्म की रेटिंग नहीं पता है, "रेटिंग नहीं पता" (केस-इनसेंसिटिव) की वैल्यू.
contentRating.author टेक्स्ट या संगठन अगर contentRating Rating का इस्तेमाल करता है, तो यह ज़रूरी है - रेटिंग एजेंसी का नाम.
contentRating.ratingValue टेक्स्ट contentRating के Rating इस्तेमाल करने पर ज़रूरी है - रेटिंग की वैल्यू.
contentRating.advisoryCode टेक्स्ट कॉन्टेंट के लिए सलाह वाला कोड. स्वीकार की गई वैल्यू में D, FV, L, S, और V. D = Dialogue, FV = फ़ैंटेसी हिंसा , L = भाषा, S = सेक्शुअल कॉन्टेंट, V = हिंसा शामिल है.
popularityScore लोकप्रियता स्कोर का स्पेसिफ़िकेशन का सुझाव दिया जाता है कि क्यों? स्कोर, जिसका इस्तेमाल करके Google यह तय करता है कि उपयोगकर्ताओं के लिए कौनसा मीडिया चलाया जाए. यह स्कोर आपके कैटलॉग में मौजूद अन्य कॉन्टेंट की तुलना में कॉन्टेंट की लोकप्रियता दिखाता है. इसलिए, आपके कैटलॉग में मौजूद सभी इकाइयों के साथ स्कोर का स्केल एक जैसा होना चाहिए. डिफ़ॉल्ट रूप से, किसी इकाई का लोकप्रियता स्कोर 0 पर सेट होता है.
popularityScore.@type टेक्स्ट हमेशा PopularityScoreSpecification पर सेट रखें.
popularityScore.value Number इकाई की लोकप्रियता बताने वाला नॉन-नेगेटिव न्यूमेरिक वैल्यू, ज़्यादा स्कोर है.
popularityScore.eligibleRegion देश वे क्षेत्र(इलाके), जहां यह लोकप्रियता स्कोर लागू होता है. अगर लोकप्रियता का स्कोर दुनिया भर में लागू होता है, तो EARTH पर सेट करें. डिफ़ॉल्ट रूप से, यह प्रॉपर्टी EARTH पर सेट होती है.
Note: दुनिया भर में, लोकप्रियता की तुलना में स्थानीय भाषा की लोकप्रियता को प्राथमिकता दी जाती है
category टेक्स्ट लागू होने पर ज़रूरी - अगर इकाई कोई Movie वैरिएंट है, तो इस प्रॉपर्टी को पॉप्युलेट करें. इनमें से किसी एक पर category सेट करें:
  • Home Release: ऐसा वर्शन जिसे घर में देखने के लिए बेचा या किराये पर लिया गया है.
  • Theatrical Releaseथिएटर में रिलीज़ किया गया वर्शन.
  • International Release ऐसा वर्शन जिसमें अंतरराष्ट्रीय रिलीज़ के लिए बदलाव किए गए हैं.
  • Remastered: ऐसा वर्शन जिसकी इमेज, आवाज़ या दोनों को अप-टू-डेट स्टैंडर्ड में सुधारा जाता है.
  • Unrated: ऐसा वर्शन जिसे एमपीएए या इससे मिलती-जुलती कोई एजेंसी स्क्रीन नहीं करती है.
  • 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: ऐसा वर्शन जिसे एमपीएए या इससे मिलती-जुलती कोई एजेंसी स्क्रीन नहीं करती है.
  • 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"
}

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