फ़ीड बनाना

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

फ़ीड फ़ाइल के फ़ॉर्मैट से जुड़ी ज़रूरी शर्तें

फ़ीड फ़ाइलों के लिए ये ज़रूरी शर्तें हैं:

• फ़ीड फ़ाइल के नाम का एक्सटेंशन .json होना चाहिए.
• अपनी फ़ीड फ़ाइल को एन्क्रिप्ट (सुरक्षित) न करें.

• अपनी फ़ीड फ़ाइल को UTF-8 में कोड में बदलें. इसके लिए, अपने फ़ाइल एडिटर की सेटिंग देखें.

  

• अगर आपकी फ़ीड फ़ाइल का साइज़ एक जीबी से ज़्यादा है, तो उसे कई फ़ाइलों में बांट लें.

• हमारा सुझाव है कि आप हर तरह की इकाई के लिए एक फ़ाइल बनाएं. उदाहरण के लिए, tvseries.json, tvseasons.json, tvepisodes.json, movies.json वगैरह.

  • अगर इनमें से किसी भी फ़ाइल का साइज़ 1 जीबी से ज़्यादा है, तो उसकी इकाइयों को कई फ़ाइलों में बांटें. उदाहरण के लिए, tvepisodes_01.json, tvepisodes_02.json वगैरह.
  • अगर फ़ाइल का साइज़ 1 जीबी से कम है, तो एक फ़ाइल में कितनी भी इकाइयां शामिल की जा सकती हैं.

• पक्का करें कि फ़ाइल को JSON स्पेसिफ़िकेशन के मुताबिक, बीओएम के बिना एन्कोड किया गया हो. Linux ओएस पर जांच करने के लिए, hexdump file.json | head -n 1 को 0x00 पते पर BBEF से शुरू नहीं होना चाहिए.

फ़ीड के प्रकार

प्रोडक्शन फ़ीड

• यह JSON फ़ीड फ़ाइलों का सेट होता है. इसमें आपके पूरे कैटलॉग की जानकारी होती है, जिसे आपको Google पर लॉन्च करना है. फ़ीड बनाने का तरीका जानने के लिए, यहां दिया गया सेक्शन देखें.
• अगर Google के साथ पहली बार इंटिग्रेट किया जा रहा है, तो आपको सिर्फ़ इस फ़ीड की ज़रूरत होगी.
• Google को यह फ़ीड सबमिट करने के बाद, इसका बारीकी से विश्लेषण किया जाएगा.साथ ही, इसमें मौजूद जानकारी की क्वालिटी और उसकी सटीकता को बेहतर बनाने के लिए, कुछ बार इसकी समीक्षा की जाएगी.इसके बाद ही, इसे फ़ाइनल करके लॉन्च किया जाएगा.

स्टेजिंग फ़ीड

• कुछ मामलों में, प्रोडक्शन फ़ीड को बढ़ाने की ज़रूरत होती है. इस तरह की स्थितियों के कुछ उदाहरण यहां दिए गए हैं:
  • फ़ीड में नई तरह की इकाइयां शामिल की गई हैं, जो पहले उपलब्ध नहीं थीं.
  • फ़ीड में बड़ी संख्या में नई इकाइयां/मेटाडेटा शामिल करना, ताकि नए देशों/इलाकों में लॉन्च किया जा सके.
  • फ़ीड को नए प्लैटफ़ॉर्म टाइप पर उपलब्ध कराना. उदाहरण के लिए, जब प्रॉडक्ट फ़ीड को सिर्फ़ Google Search पर लॉन्च किया गया हो और अब आपको इसे Google TV पर भी लॉन्च करना हो.
• ऐसे मामलों में, स्टेजिंग फ़ीड की ज़रूरत होती है. यह फ़ीड, प्रोडक्शन फ़ीड की कॉपी होता है. हालांकि, इसमें अतिरिक्त मेटाडेटा होता है. जैसे, नए प्लैटफ़ॉर्म के लिए डीप लिंक, नई जगह के लिए मेटाडेटा वगैरह.
• प्रोडक्शन फ़ीड की तरह ही, इसका भी बारीकी से विश्लेषण किया जाएगा. साथ ही, इसे कुछ बार दोहराया जाएगा, ताकि कैप्चर की जा रही जानकारी की मात्रा और उसकी सटीकता के हिसाब से, क्वालिटी को बेहतर बनाया जा सके. क्वालिटी बार हासिल करने के बाद, यह फ़ीड मौजूदा प्रोडक्शन फ़ीड की जगह ले लेता है और नया प्रोडक्शन फ़ीड बन जाता है.
• इस फ़ीड की मदद से, हम शुरुआती लॉन्च को अन्य लॉन्च से अलग कर सकते हैं. साथ ही, प्रोडक्शन फ़ीड पर असर डाले बिना, सभी ज़रूरी टेस्ट कर सकते हैं. इससे यह पक्का होता है कि असली उपयोगकर्ता के अनुभव में कोई रुकावट न आए.

अगर ऊपर दी गई जानकारी के बारे में आपका कोई सवाल है, तो अपने Google प्रतिनिधि से संपर्क करें.

फ़ीड फ़ाइल बनाना

फ़ीड बनाते समय, इन सबसे सही तरीकों को अपनाएं:

1. इकाइयों के छोटे सेट का इस्तेमाल करके सैंपल फ़ीड बनाना

   अपने कैटलॉग में मौजूद सभी कॉन्टेंट वाला फ़ीड बनाने से पहले, हमारा सुझाव है कि आप सिर्फ़ कुछ इकाइयों वाला सैंपल फ़ीड बनाएं. अपने फ़ीड पर काम करते समय, आपको समस्याएं आ सकती हैं. इकाइयों के सेट का साइज़ सीमित करके, इन गड़बड़ियों और चेतावनियों को आसानी से डीबग किया जा सकेगा.

2. सैंपल फ़ीड की पुष्टि करना

   हम ऐसे टूल उपलब्ध कराते हैं जिनसे यह पक्का किया जा सके कि आपका फ़ीड, ज़रूरी शर्तों के मुताबिक है. हमारा सुझाव है कि आप अपने सैंपल फ़ीड में मिली सभी गड़बड़ियों और चेतावनियों को ठीक करने के लिए, इन टूल का इस्तेमाल करें.

3. प्रॉडक्शन फ़ीड बनाना

   यह पुष्टि करने के बाद कि आपकी इकाइयों के छोटे सेट के लिए आपके पास एक अच्छा स्ट्रक्चर है, अपने पूरे कैटलॉग के लिए एक फ़ीड बनाएं.

सैंपल फ़ीड बनाना

1. अपने कैटलॉग से कोई एक प्रतिनिधि इकाई चुनें. ऐसी इकाई चुनें जिसका स्ट्रक्चर थोड़ा जटिल हो, लेकिन वह कैटलॉग में मौजूद किसी इकाई के लिए सामान्य हो.
2. सिंटैक्स की गड़बड़ियों और ज़रूरी प्रॉपर्टी मौजूद न होने की जांच करने के लिए, JSON स्कीमा की पुष्टि करने वाले टूल का इस्तेमाल करें. (ज़्यादा जानकारी के लिए, अगला सेक्शन देखें.)

   एक 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 स्कीमा की पुष्टि करने वाला टूल, फ़ीड में मौजूद सभी फ़ाइलों को अपलोड करने से पहले, उनकी पुष्टि करता है. फ़ीड डेवलप करते समय इस टूल का इस्तेमाल करें, ताकि स्ट्रक्चर और टाइप से जुड़ी सामान्य गड़बड़ियों से बचा जा सके. इस टूल के बारे में ज़्यादा जानकारी यहां दी गई है.

• Search Console पर कैटलॉग प्रॉपर्टी

  जब Google प्रतिनिधि, Search Console में आपकी कैटलॉग प्रॉपर्टी को चालू कर दे और आपके सैंपल या स्टेजिंग फ़ीड को शामिल कर लिया जाए, तो Search Console में कैटलॉग प्रॉपर्टी का इस्तेमाल करें. इससे इकाई के लेवल पर पुष्टि करने से जुड़ी गड़बड़ियों, चेतावनियों, और डेटा शामिल करने से जुड़ी गड़बड़ियों का पता लगाया जा सकता है.

प्रोडक्शन फ़ीड बनाना

1. सैंपल फ़ीड में मौजूद स्ट्रक्चर से जुड़ी सभी गड़बड़ियों और चेतावनियों को ठीक करने के बाद, फ़ीड को बड़ा करें, ताकि आपके कैटलॉग की सभी इकाइयां शामिल की जा सकें.
2. अपनी एक्सपैंडेड फ़ीड फ़ाइलों पर JSON स्कीमा की पुष्टि करने वाला टूल चलाएं. साथ ही, अपलोड करने के बाद Search Console पर कैटलॉग प्रॉपर्टी की समीक्षा करें, ताकि यह पुष्टि की जा सके कि पुष्टि करने से जुड़ी कोई गड़बड़ी नहीं है. पक्का करें कि आपके फ़ीड में, आपके कैटलॉग की सभी इकाइयां शामिल हों. इसके लिए, अपने फ़ीड में मौजूद इकाइयों की संख्या की तुलना, अपने कैटलॉग में मौजूद आइटम की संख्या से करें.