फ़ीड के स्ट्रक्चर की खास जानकारी

मीडिया कार्रवाइयां फ़ीड एक JSON ऑब्जेक्ट है, जिसमें इकाइयों का संग्रह होता है. इकाई एक schema.org ऑब्जेक्ट होता है, जो आपके कैटलॉग में मौजूद किसी आइटम को दिखाता है: टीवी एपिसोड, टीवी सीरीज़, फ़िल्म, गाना, एल्बम वगैरह.

फ़ीड का स्ट्रक्चर

देखने की कार्रवाइयों और सुनने की कार्रवाइयों के फ़ीड स्ट्रक्चर अलग-अलग होते हैं.

वॉच ऐक्शन का यह क्रम तय होता है: डेटा फ़ीड लिफ़ाफ़ा ऑब्जेक्ट कॉन्टेंट मार्कअप ऑब्जेक्ट कार्रवाई मार्कअप ऑब्जेक्ट टारगेट ऑब्जेक्ट कार्रवाई का ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट मीडिया की सदस्यता ऑब्जेक्ट ऑफ़र ऑब्जेक्ट

'सुनने की कार्रवाइयों' का यह क्रम है: डेटा फ़ीड लिफ़ाफ़ा ऑब्जेक्ट कॉन्टेंट मार्कअप ऑब्जेक्ट कार्रवाई मार्कअप ऑब्जेक्ट टारगेट ऑब्जेक्ट ऑफ़र ऑब्जेक्ट कॉन्टेंट मार्कअप ऑब्जेक्ट (इकाई-सीड वाली कार्रवाई)

डेटा फ़ीड लिफ़ाफ़ा

डेटा फ़ीड एन्वेलप, मीडिया ऐक्शन फ़ीड में टॉप लेवल का ऑब्जेक्ट है. ऑब्जेक्ट में कॉन्टेंट मार्कअप ऑब्जेक्ट (इकाइयों) का कलेक्शन होता है. ये आपके कैटलॉग में मौजूद सारा कॉन्टेंट दिखाते हैं.

डेटा फ़ीड लिफ़ाफ़ा इन प्रॉपर्टी के साथ काम करता है:

प्रॉपर्टी	टाइप	ब्यौरा
@context	यूआरएल	ज़रूरी है - http://schema.org पर सेट करें
@type	टेक्स्ट	ज़रूरी है - DataFeed पर सेट करें.
dateModified	DateTime	ज़रूरी है - ISO 8601 फ़ॉर्मैट (समय क्षेत्र भी शामिल है) में, फ़ीड में पिछली बार बदलाव करने की तारीख और समय.
dataFeedElement	चीज़	ज़रूरी है - आपके मीडिया कैटलॉग की इकाइयां.

डेटा फ़ीड एन्वेलप टेंप्लेट

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    { <CONTENT MARKUP OBJECT 01> },
    { <CONTENT MARKUP OBJECT 02> },
    { <CONTENT MARKUP OBJECT 03> },
    ...
  ]
}

कॉन्टेंट मार्कअप

कॉन्टेंट मार्कअप ऑब्जेक्ट, आपके कैटलॉग में मौजूद एक इकाई को दिखाता है: जैसे, कोई फ़िल्म, टीवी एपिसोड, टीवी सीरीज़, गाना, एल्बम, रेडियो स्टेशन वगैरह. ऑब्जेक्ट में कॉन्टेंट का आइडेंटिफ़ायर और कैननिकल यूआरएल होता है. इसकी मदद से, मेटाडेटा की मदद से कॉन्टेंट की जानकारी दी जाती है.

कॉन्टेंट मार्कअप टेंप्लेट

किसी कॉन्टेंट मार्कअप ऑब्जेक्ट में कार्रवाई मार्कअप ऑब्जेक्ट की कैटगरी हो सकती है. इससे कॉन्टेंट को कई कार्रवाई मार्कअप ऑब्जेक्ट के साथ जोड़ा जा सकता है. उदाहरण के लिए, कॉन्टेंट में हर क्षेत्र के हिसाब से अलग-अलग कार्रवाई मार्कअप ऑब्जेक्ट हो सकता है.

{
   "@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": [
     { <ACTION MARKUP OBJECT 01> },
     { <ACTION MARKUP OBJECT 02> }
   ],
   ...
}

कार्रवाई मार्कअप

कार्रवाई मार्कअप ऑब्जेक्ट, उपयोगकर्ताओं को कॉन्टेंट और कॉन्टेंट के लिए ज़रूरी ऐक्सेस लेवल पर ले जाने वाले डीप लिंक के बारे में बताता है. ऑब्जेक्ट, कॉन्टेंट मार्कअप ऑब्जेक्ट की प्रॉपर्टी (potentialAction) है.

ऐक्सेस से जुड़ी पाबंदियां तय करने के दो तरीके हैं:

• वॉच ऐक्शन के लिए, कार्रवाई का ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट.
• सुनने की कार्रवाइयों के लिए, किसी ऑफ़र ऑब्जेक्ट का इस्तेमाल करें.

कार्रवाई मार्कअप टेंप्लेट

अगर कॉन्टेंट में कई डीप लिंक हैं, तो ऐक्शन मार्कअप ऑब्जेक्ट में कई टारगेट ऑब्जेक्ट होते हैं. उदाहरण के लिए, iOS के लिए कॉन्टेंट का डीप लिंक, Android डीप लिंक से अलग हो सकता है. साथ ही, अगर इलाकों और समय के हिसाब से ऐक्सेस पर अलग-अलग पाबंदियां हैं, तो कार्रवाई मार्कअप ऑब्जेक्ट में कार्रवाई के ऐक्सेस से जुड़े कई ऑब्जेक्ट हो सकते हैं या ऑफ़र ऑब्जेक्ट हो सकते हैं, जैसा कि नीचे दिए गए टेंप्लेट में दिखाया गया है.

वॉच ऐक्शन के लिए ऐक्शन मार्कअप ऑब्जेक्ट टेंप्लेट:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "actionAccessibilityRequirement": [
    { <ACTION ACCESSIBILITY OBJECT 01> },
    { <ACTION ACCESSIBILITY OBJECT 02> }
  ]
}

'सुनें' कार्रवाइयों के लिए कार्रवाई मार्कअप ऑब्जेक्ट टेंप्लेट:

"potentialAction": {
  "@type": "ListenAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "expectsAcceptanceOf": [
    { <OFFER OBJECT 01> },
    { <OFFER OBJECT 02> }
  ]
}

टारगेट

टारगेट ऑब्जेक्ट, कई Google प्लैटफ़ॉर्म के लिए डीप लिंक की मैपिंग की सुविधा देता है. ऑब्जेक्ट, किसी कार्रवाई मार्कअप ऑब्जेक्ट की प्रॉपर्टी (target) है.

टारगेट का उदाहरण

अगर प्लैटफ़ॉर्म के आधार पर, कॉन्टेंट में कई डीप लिंक हैं, तो अलग-अलग मैपिंग उपलब्ध कराने के लिए, कई टारगेट ऑब्जेक्ट बनाएं. उदाहरण के लिए, Chromecast के लिए कॉन्टेंट का डीप लिंक अन्य प्लैटफ़ॉर्म से अलग हो सकता है जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है.

टारगेट ऑब्जेक्ट (बेसिक) का उदाहरण:

"target": {
  "@type": "EntryPoint",
  "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
  "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"
  ]
}

दो डीप लिंक के साथ टारगेट ऑब्जेक्ट का उदाहरण:

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/MobileWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/cast/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.googleapis.com/GoogleVideoCast"
    ]
  }
]

कार्रवाई के ऐक्सेस से जुड़ी जानकारी

कार्रवाई का ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट, देश/इलाके और समयावधि के हिसाब से कॉन्टेंट. ऑब्जेक्ट एक प्रॉपर्टी है, actionAccessibilityRequirement कार्रवाई मार्कअप ऑब्जेक्ट.

ऑब्जेक्ट का category इनमें से कोई भी हो सकता है:

• nologinrequired
• free

• subscription

  सदस्यता के बारे में जानकारी देने के लिए, मीडिया की सदस्यता का ऑब्जेक्ट. अगर आपने सामग्री को देखने के लिए सदस्यों को किसी अतिरिक्त खरीदारी की ज़रूरत होती है, तो offer ऑब्जेक्ट सबमिट करें.

• externalsubscription

  सदस्यता के बारे में जानकारी देने के लिए, मीडिया की सदस्यता का ऑब्जेक्ट. अगर आपने सामग्री को देखने के लिए सदस्यों को किसी अतिरिक्त खरीदारी की ज़रूरत होती है, तो offer ऑब्जेक्ट सबमिट करें.

• rental

  किसी offer ऑब्जेक्ट सबमिट करें.

• purchase

  किसी offer ऑब्जेक्ट सबमिट करें.

मीडिया सदस्यता

मीडिया सदस्यता ऑब्जेक्ट, ज़रूरी सदस्यता की जानकारी देता है कॉन्टेंट के लिए. ऑब्जेक्टrequiresSubscription कार्रवाई ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट. यह है अगर actionAccessibilityRequirement.category, subscription है, तो ज़रूरी है externalSubscription और आपकी सदस्यता में कई सुविधाएं शामिल हैं या ऐड-ऑन का इस्तेमाल किया जा सकता है. इसे शामिल न करें अगर आपका सदस्यता एक-टीयर होती है. इसमें आपको अपने कैटलॉग के सारे कॉन्टेंट का ऐक्सेस मिलता है.

मीडिया सदस्यता का उदाहरण

मीडिया सदस्यता ऑब्जेक्ट का उदाहरण:

"requiresSubscription": {
  "@type": "MediaSubscription",
  "@id": "http://www.example.com/premium_subscription",
  "name": "Example Premium",
  "sameAs": "http://www.example.com/premium_subscription"
}

ऑफ़र

ऑफ़र से जुड़ा ऑब्जेक्ट, कॉन्टेंट से जुड़ी कीमत के बारे में बताता है. ऑब्जेक्ट, नीचे दिए गए ऑब्जेक्ट की एक प्रॉपर्टी (expectsAcceptanceOf) है:

• वॉच ऐक्शन के लिए, कार्रवाई का ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट.
• 'सुनने की कार्रवाइयों' के लिए, एक कार्रवाई मार्कअप ऑब्जेक्ट.

ऑफ़र का उदाहरण

Watch Actions में expectsAcceptanceOf प्रॉपर्टी तय होती है कार्रवाई ऐक्सेस स्पेसिफ़िकेशन ऑब्जेक्ट:

"potentialAction":{
  "@type":"WatchAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2019-01-01T00:00Z",
    "availabilityEnds": "2019-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "My example seller"
      }
    }
  }
}

'लिसन ऐक्शन' सुविधा से, कार्रवाई मार्कअप ऑब्जेक्ट में सीधे तौर पर expectsAcceptanceOf प्रॉपर्टी के बारे में पता चलता है:

"potentialAction":{
  "@type":"ListenAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "expectsAcceptanceOf":{
    "@type": "Offer",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    },
    "category": "subscription",
    "name": "Example Music",
    "price": 9.99,
    "priceCurrency": "USD",
    "seller": {
      "@type": "Organization",
      "name": "My example seller",
      "sameAs": "http://www.example.com"
    }
  }
}

इमेज

इमेज ऑब्जेक्ट, कॉन्टेंट से जुड़ी इमेज के बारे में बताता है.

इमेज के लिए ज़रूरी शर्तें:

• वॉच ऐक्शन के लिए, 2:3 के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाली हाई-रिज़ॉल्यूशन वाली इमेज (कम से कम 140x210 पिक्सल) उपलब्ध कराएं.
  • इमेज .jpg या .png फ़ॉर्मैट में होनी चाहिए.
• 'सुनें' कार्रवाइयों के लिए, 1x1 आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) वाली हाई-रिज़ॉल्यूशन वाली इमेज (कम से कम 300x300 पिक्सल) दें.
  • हमारा सुझाव है कि आप 600x600 पिक्सल या इससे ज़्यादा का आसपेक्ट रेशियो इस्तेमाल करें.
  • इमेज .jpg, .png या .gif फ़ॉर्मैट में होनी चाहिए.
• इमेज का यूआरएल ऐसा होना चाहिए जिसे क्रॉल और इंडेक्स किया जा सके.
• आपके पास इमेज का इस्तेमाल करने और उसे Google डिवाइसों और प्रॉपर्टी पर दिखाने के अधिकार होने चाहिए.
• इमेज में ये चीज़ें शामिल नहीं होनी चाहिए:
  • धुंधली, पिक्सलेट, घुमाई गई या खराब क्वालिटी की इमेज.
  • बिना लाइसेंस या स्टॉक फ़ोटोग्राफ़ी.
  • नग्नता.
  • गैर-कानूनी कॉन्टेंट.
• MusicPlaylist को अपडेट करने पर, इसकी इमेज अपडेट करें और नया कॉन्टेंट दिखाएं.

इमेज का उदाहरण

"image": {
  "@type": "ImageObject",
  "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
  "dateModified" : "2019-01-05T22:11:33+00:00",
  "regionsAllowed" : ["US","UK","MX"]
}

फ़ीड के उदाहरण

नीचे दिए गए उदाहरण, फ़ीड स्ट्रक्चर के बीच अंतर दिखाते हैं कार्रवाइयां देखें और सुनें कार्रवाइयां.

स्मार्टवॉच की कार्रवाइयों का उदाहरण

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@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",
           "eligibleRegion": [
             {
                "@type": "Country",
                "name": "US"
             },
             {
                "@type": "Country",
                "name": "CA"
             }
           ],
        }
      },
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "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"
        }
      ]
    }
  ]
}

सुनने की कार्रवाइयों का उदाहरण

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context":"http://schema.googleapis.com/",
      "@type":"MusicGroup",
      "@id":"http://www.example.com/artist/my_favorite_artist/",
      "url":"http://www.example.com/artist/my_favorite_artist/",
      "name":"My Favorite Artist",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_artist",
      "description":"This is my favorite pop music artist.",
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          },
          "price": 8.99,
          "priceCurrency": "USD"
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
        "url":"http://www.example.com/artist_mix/my_favorite_artist/",
        "name":"My Favorite Artist Mix",
        "description":"A mix of music similar to My Favorite Artist",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }
  ]
}