मीडिया फ़ीड एक JSON ऑब्जेक्ट है, जिसमें आपके कैटलॉग में मौजूद मीडिया कॉन्टेंट, जैसे कि टीवी सीरीज़, फ़िल्मों, गानों, एल्बम वगैरह का कलेक्शन होता है. फ़ीड में शामिल करने की प्रोसेस का पहला चरण अपने फ़ीड को डेवलप करना है. फ़ाइलें तैयार होने के बाद, आपको फ़ीड होस्ट करने के लिए इनमें से किसी एक तरीके का इस्तेमाल करना होगा. फ़ीड को होस्ट करना होगा. इससे, Google नियमित तौर पर फ़ीड को फ़ेच कर सकेगा.
फ़ीड की फ़ाइल के फ़ॉर्मैट की ज़रूरी शर्तें
फ़ीड फ़ाइल(फ़ाइलों) के लिए ज़रूरी शर्तें:
- फ़ीड की फ़ाइल में
.json
फ़ाइल एक्सटेंशन का एक्सटेंशन होना ज़रूरी है. - फ़ीड फ़ाइल को एन्क्रिप्ट (सुरक्षित) न करें.
UTF-8 में अपने फ़ीड की फ़ाइल को कोड में बदलें. (फ़ाइल एडिटर की सेटिंग देखें).
अगर आपकी फ़ीड फ़ाइल 1 जीबी से बड़ी है (बिना कंप्रेस की हुई), तो फ़ाइल को कई फ़ाइलों में बांटें.
हमारा सुझाव है कि आप इकाई प्रकार के हिसाब से एक फ़ाइल बनाएं (उदाहरण के लिए,
tvseries.json
,tvseasons.json
,tvepisodes.json
,movies.json
वगैरह).- अगर इनमें से कोई भी फ़ाइल 1 जीबी से ज़्यादा है, तो इकाइयों को कई फ़ाइलों (जैसे कि
tvepisodes_01.json
,tvepisodes_02.json
वगैरह) में बांट दें. - अगर फ़ाइल का साइज़ 1 जीबी से कम है, तो इस बात पर कोई पाबंदी नहीं है कि एक फ़ाइल में कितनी इकाइयां शामिल की जा सकती हैं.
- अगर इनमें से कोई भी फ़ाइल 1 जीबी से ज़्यादा है, तो इकाइयों को कई फ़ाइलों (जैसे कि
पक्का करें कि फ़ाइल को JSON की खास बातों के मुताबिक, बिना बीओएम के कोड में बदला गया हो. Linux OS की जांच करने के लिए,
hexdump file.json | head -n 1
कोBBEF
से शुरू नहीं होना चाहिए. पते 0x00 पर होने चाहिए.
फ़ीड के प्रकार
प्रोडक्शन फ़ीड
- यह JSON फ़ीड फ़ाइल(फ़ाइलों) के उस सेट को दिखाता है जो उन सभी कैटलॉग को एक साथ दिखाता है जिन्हें आपको Google पर लॉन्च करना है. नीचे दिए गए सेक्शन में, फ़ीड बनाने का तरीका बताया गया है.
- अगर Google को पहली बार जोड़ा जा रहा है, तो आपको सिर्फ़ इस फ़ीड की ज़रूरत होगी.
- जब Google को यह फ़ीड सबमिट कर दिया जाता है, तो इस डेटा का गहराई से विश्लेषण किया जाता है.ऐसा कई बार किया जाता है, ताकि कैप्चर किए गए डेटा की मात्रा के बारे में बेहतर क्वालिटी हासिल की जा सके.साथ ही, डेटा को शामिल करने और लॉन्च करने से पहले उसकी सही जानकारी भी दी जा सके.
स्टेज फ़ीड
- इस्तेमाल के कुछ उदाहरणों में प्रोडक्शन फ़ीड का दायरा बढ़ाना ज़रूरी है. ऐसे मामलों के कुछ उदाहरण:
- नए इकाई टाइप शामिल करने के लिए, फ़ीड का एक्सपैंशन, जिसे पहले लॉन्च नहीं किया गया था.
- नए स्थान-भाषा में बड़ी संख्या में नई इकाइयां/मेटाडेटा शामिल करने के लिए, फ़ीड का विस्तार.
- नए प्लैटफ़ॉर्म टाइप के लिए, फ़ीड का विस्तार. उदाहरण के लिए, जब प्रोडक्शन फ़ीड सिर्फ़ Google Search पर लॉन्च किया जाता है और अब आपको इसे Google TV पर उपलब्ध कराना है.
- ऐसे मामलों में, स्टेजिंग फ़ीड की ज़रूरत होती है. यह फ़ीड, प्रोडक्शन फ़ीड की एक कॉपी होती है. हालांकि, इसमें अन्य मेटाडेटा की जानकारी होती है. जैसे, नए प्लैटफ़ॉर्म के लिए डीप लिंक, नई जगह के लिए मेटाडेटा वगैरह.
- प्रोडक्शन फ़ीड की तरह ही, कई बार इसका अच्छी तरह से विश्लेषण किया जाएगा और दोहराया जाएगा. ऐसा करने से, कैप्चर किए जाने वाली जानकारी और उसके सटीक होने की क्वालिटी को बेहतर बनाया जा सकेगा. क्वालिटी बार मिल जाने के बाद, यह फ़ीड मौजूदा प्रोडक्शन फ़ीड की जगह, नया प्रोडक्शन फ़ीड बन जाता है.
- इस फ़ीड की मदद से, हम शुरुआती लॉन्च को बाकी लॉन्च से अलग कर सकते हैं. साथ ही, प्रोडक्शन फ़ीड पर असर डाले बिना, सभी ज़रूरी टेस्टिंग कर सकते हैं. इससे, असली उपयोगकर्ता अनुभव पर कोई असर नहीं पड़ता.
ऊपर पूछे गए सवालों के जवाब पाने के लिए, अपने Google प्रतिनिधि से संपर्क करें.
फ़ीड फ़ाइल बनाना
फ़ीड बनाते समय इन सबसे सही तरीकों का पालन करें:
इकाइयों के छोटे सेट का इस्तेमाल करके सैंपल फ़ीड बनाना
हमारा सुझाव है कि आप एक ऐसा फ़ीड बनाएं जिसमें आपके कैटलॉग का पूरा कॉन्टेंट शामिल हो. इसके बाद, एक सैंपल फ़ीड बनाएं जिसमें इकाइयों का सिर्फ़ एक छोटा सा सेट हो. फ़ीड पर काम करते समय, आपको समस्याएं हो सकती हैं. इकाइयों के समूह के आकार को सीमित करके, आप इन गड़बड़ियों और चेतावनियों को ज़्यादा आसानी से डीबग कर पाएंगे.
-
हम ऐसे टूल उपलब्ध कराते हैं जो यह पक्का करते हैं कि आपका फ़ीड, खास जानकारी का पालन करता है. हम सुझाव देते हैं कि आप अपने नमूना फ़ीड में मिली सभी गड़बड़ियों और चेतावनियों को ठीक करने के लिए इन टूल का इस्तेमाल करें.
-
यह पुष्टि करने के बाद कि आपकी इकाइयों के छोटे सेट के लिए आपके पास एक अच्छा स्ट्रक्चर है, अपने पूरे कैटलॉग के लिए एक फ़ीड डेवलप करें.
सैंपल फ़ीड बनाना
- अपने कैटलॉग से एक प्रतिनिधि इकाई चुनें. उचित रूप से जटिल संरचना वाली इकाई चुनें, लेकिन कैटलॉग में मौजूद इकाई के लिए यह अब भी सामान्य है.
- सिंटैक्स की गड़बड़ियों और ज़रूरी प्रॉपर्टी की जांच करने के लिए, डेटा फ़ीड की पुष्टि करने वाले टूल का इस्तेमाल करें. (ज़्यादा जानकारी के लिए अगला सेक्शन देखें.)
एक
Movie
इकाई वाले फ़ीड का उदाहरण{ "@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", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "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" } ] } ] }
सैंपल फ़ीड की पुष्टि करना
मीडिया फ़ीड के लिए, Google के स्ट्रक्चर्ड डेटा की खास बातों के साथ, सैंपल फ़ीड की पुष्टि करने में मदद करने के लिए, ये टूल उपलब्ध हैं.
डेटा फ़ीड की पुष्टि करने वाला टूल
डेटा फ़ीड की पुष्टि करने वाला टूल, एक बार में एक ही इकाई की पुष्टि कर सकता है. स्ट्रक्चर्ड डेटा के इस्तेमाल से जुड़ी गड़बड़ियों और कॉन्टेंट से जुड़ी सामान्य गड़बड़ियों के लिए, इस टूल का इस्तेमाल करके अपने कैटलॉग से सैंपल इकाई की पुष्टि करें. टूल के बारे में ज़्यादा जानकारी के लिए, यहां जाएं.
JSON स्कीमा की पुष्टि करने वाला टूल
JSON स्कीमा की पुष्टि करने वाले टूल से, फ़ीड में मौजूद सभी फ़ाइलों की पुष्टि की जा सकती है. फ़ीड के डेवलपमेंट के दौरान इस टूल का इस्तेमाल करें, ताकि स्ट्रक्चर से जुड़ी सामान्य गड़बड़ियों से बचा जा सके. आपको टूल के बारे में ज़्यादा जानकारी यहां मिल सकती है.
प्रोडक्शन फ़ीड बनाना
- सैंपल फ़ीड में मौजूद सभी गड़बड़ियों और चेतावनियों को ठीक करने के बाद, फ़ीड को बड़ा करें. इससे, आपके कैटलॉग में मौजूद सभी इकाइयां शामिल हो जाएंगी.
- डेटा फ़ीड की पुष्टि करने वाले टूल का इस्तेमाल करके, एक बार में अपनी फ़ीड में मौजूद इकाइयों की एक छोटी संख्या की पुष्टि करें. टूल पर बहुत ज़्यादा इकाइयां चिपकाने से वेब ब्राउज़र फ़्रीज़ हो सकता है. पुष्टि करें कि आपके फ़ीड में सभी इकाइयों को शामिल किया गया है. इसके लिए, अपने फ़ीड में मौजूद इकाइयों की संख्या की तुलना, अपने कैटलॉग में मौजूद आइटम की संख्या से करें.