मीडिया फ़ीड एक JSON ऑब्जेक्ट है. इसमें इकाइयों का एक कलेक्शन होता है, जो आपके कैटलॉग में मौजूद मीडिया कॉन्टेंट को दिखाता है. जैसे, टीवी सीरीज़, फ़िल्में, गाने, एल्बम वगैरह. शामिल होने की प्रोसेस का पहला चरण, अपने फ़ीड बनाना है. फ़ाइलें तैयार होने के बाद, आपको फ़ीड को होस्ट करना होगा. इसके लिए, होस्ट करने के किसी ऐसे तरीके का इस्तेमाल करें जिसका इस्तेमाल Google नियमित तौर पर करता हो.
फ़ीड फ़ाइल फ़ॉर्मैट से जुड़ी ज़रूरी शर्तें
फ़ीड फ़ाइल के लिए ये ज़रूरी शर्तें हैं:
- फ़ीड फ़ाइल में
.jsonफ़ाइल नाम वाला एक्सटेंशन होना चाहिए. - अपनी फ़ीड फ़ाइल को एन्क्रिप्ट (सुरक्षित) न करें.
अपनी फ़ीड फ़ाइल को UTF-8 में एन्कोड करें (अपनी फ़ाइल एडिटर सेटिंग देखें).
अगर आपकी फ़ीड फ़ाइल का साइज़ 1 जीबी (बिना कंप्रेस की गई) से ज़्यादा है, तो फ़ाइल को कई फ़ाइलों में बांटें.
हमारा सुझाव है कि आप हर इकाई टाइप के लिए एक फ़ाइल बनाएं. जैसे,
tvseries.json,tvseasons.json,tvepisodes.json,movies.jsonवगैरह.- अगर इनमें से कोई भी फ़ाइल एक जीबी से ज़्यादा है, तो उसकी इकाइयों को कई फ़ाइलों (उदाहरण के लिए,
tvepisodes_01.json,tvepisodes_02.jsonवगैरह) में बांटें. - फ़ाइल का साइज़ एक जीबी से कम होने पर, एक फ़ाइल में कितनी इकाइयां शामिल की जा सकती हैं, इस पर कोई पाबंदी नहीं है.
- अगर इनमें से कोई भी फ़ाइल एक जीबी से ज़्यादा है, तो उसकी इकाइयों को कई फ़ाइलों (उदाहरण के लिए,
पक्का करें कि फ़ाइल को JSON स्पेसिफ़िकेशन के मुताबिक, BOM के बिना एन्कोड किया गया हो. Linux OS पर यह जांचने के लिए कि
hexdump file.json | head -n 1, पते 0x00 परBBEFसे शुरू नहीं होता है, यह ज़रूरी है किhexdump file.json | head -n 1, पते 0x00 परBBEFसे शुरू न हो.
फ़ीड के प्रकार
प्रोडक्शन फ़ीड
- यह 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 स्कीमा की पुष्टि करने वाला टूल, फ़ीड में मौजूद सभी फ़ाइलों की पुष्टि कर सकता है. फ़ीड के डेवलपमेंट के दौरान, इस टूल का इस्तेमाल करें, ताकि स्ट्रक्चर से जुड़ी सामान्य गड़बड़ियों से बचा जा सके. टूल के बारे में ज़्यादा जानकारी यहां दी गई है.
प्रोडक्शन फ़ीड बनाना
- सैंपल फ़ीड में मौजूद सभी गड़बड़ियों और चेतावनियों को ठीक करने के बाद, अपने कैटलॉग की सभी इकाइयों को शामिल करने के लिए फ़ीड को बड़ा करें.
- एक बार में अपने फ़ीड में मौजूद कुछ इकाइयों की पुष्टि करने के लिए, डेटा फ़ीड की पुष्टि करने वाले टूल का बार-बार इस्तेमाल करें. टूल पर बड़ी संख्या में इकाइयां चिपकाने से, वेब ब्राउज़र फ़्रीज़ हो सकता है. अपने फ़ीड में मौजूद इकाइयों की संख्या की तुलना, अपने कैटलॉग में मौजूद सामान की संख्या से करके पुष्टि करें कि आपके फ़ीड में आपके कैटलॉग की सभी इकाइयां शामिल हैं.