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