फ़ीड, Actions Center को आपकी इन्वेंट्री का डेटा उपलब्ध कराते हैं. हर दिन सिक्योर फ़ाइल ट्रांसफ़र प्रोटोकॉल (एसएफ़टीपी) का इस्तेमाल करके अपलोड किए जाने वाले इस डेटा से, सभी कारोबारियों या कंपनियों, सेवाओं, और बुकिंग के लिए उपलब्ध स्लॉट के डेटा को अपडेट किया जाता है. फ़ीड से यह पता चलता है कि किन कारोबारियों या कंपनियों के साथ काम किया जाता है, उनके प्रॉडक्ट की उपलब्धता क्या है, और Google को यह पुष्टि करने के लिए कौनसी खास सुविधाओं की ज़रूरत है कि वह आपकी इन्वेंट्री को सही तरीके से दिखा रहा है. फ़ीड, उन एसएफ़टीपी ड्रॉपबॉक्स पर अपलोड किए जाते हैं जिन्हें सेटअप में एसएसएच कुंजी देते समय कॉन्फ़िगर किया जाता है.
बुकिंग सर्वर पर जाने से पहले, आपको 'फ़ीड तैयार हैं' सेक्शन में दिए गए ये टास्क पूरे करने होंगे:
फ़ीड अपलोड करने के बाद, टास्क पूरे हो जाएंगे और हरे रंग के हो जाएंगे. लिंक किए गए दस्तावेज़ पढ़ें, ताकि हर माइलस्टोन टास्क को पूरा किया जा सके.
डाइनिंग की बुकिंग के लिए एंड-टू-एंड इंटिग्रेशन की सुविधा ठीक से काम करे, इसके लिए आपको हर दिन कारोबारी या कंपनी का फ़ीड, सेवाओं का फ़ीड, और उपलब्धता का फ़ीड अपने-आप अपलोड करना होगा. ऑटोमेटेड फ़ीड के इन्फ़्रास्ट्रक्चर में, आपकी पूरी इन्वेंट्री शामिल होनी चाहिए.
फ़ीड के टाइप
सीधे बुकिंग करने की सुविधा वाले डाइनिंग इंटिग्रेशन के लिए, यहां दिए गए फ़ीड और उन्हें अपलोड करने की फ़्रीक्वेंसी की ज़रूरत होती है:
| फ़ीड | ब्यौरा | फ़्रीक्वेंसी | नमूना |
|---|---|---|---|
| कारोबारी या कंपनी | इससे आपके कारोबारियों या कंपनियों के बारे में पता चलता है. | हर 24 घंटे में एक बार | कारोबारी या कंपनी के फ़ीड का सैंपल |
| सेवाएं | कारोबारियों या कंपनियों की सेवाओं के बारे में बताएं. | हर 24 घंटे में एक बार | सेवाओं के फ़ीड का सैंपल |
| उपलब्धता | इससे कारोबारियों या कंपनियों की सेवाओं के लिए उपलब्ध स्लॉट के बारे में पता चलता है. कम से कम 30 दिनों के लिए कवरेज देना ज़रूरी है. कवरेज को 90 दिनों तक बढ़ाने के लिए, Actions Center के संपर्क फ़ॉर्म के ज़रिए Google की सहायता टीम से संपर्क करें. | हर 24 घंटे में एक बार | उपलब्धता फ़ीड का सैंपल |
फ़ीड फ़ॉर्मैट के बारे में प्रोटोकॉल बफ़र 3 सिंटैक्स का इस्तेमाल करके बताया गया है. हालांकि, अपने फ़ीड को उससे जुड़े JSON फ़ॉर्मैट के हिसाब से अपलोड किया जा सकता है. JSON फ़ॉर्मैट के लिए, फ़ीड के सैंपल देखें. हमारा सुझाव है कि आप फ़ीड को JSON फ़ॉर्मैट में अपलोड करें.
नेमिंग कन्वेंशन और मेटाडेटा
फ़ाइलों के नाम
अगर शार्डिंग का इस्तेमाल किया जाता है, तो अपलोड किए जाने वाले फ़ीड के नाम अलग-अलग होने चाहिए. साथ ही, उनमें फ़ीड टाइप और संख्या की जानकारी होनी चाहिए. फ़ीड जनरेट करने के टाइमस्टैंप से, फ़ीड फ़ाइल के नाम की ज़रूरी शर्त पूरी होती है.
स्ट्रक्चर: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
उदाहरण: availability_feed_1574117613_001_of_002.json.gz
आईडी तय करना
जब आपको कारोबारियों या आईडी की ज़रूरत वाले अन्य एट्रिब्यूट के लिए आईडी तय करने हों, तो हमारा सुझाव है कि आप यूआईडी या यूयूआईडी का इस्तेमाल करें. आपके पास अपना अल्फ़ान्यूमेरिक सलूशन देने का विकल्प होता है. हालांकि, यह ज़रूरी है कि आपके प्लैटफ़ॉर्म पर आईडी अलग-अलग हों.
मेटाडेटा
फ़ीड बनाते समय, generation_timestamp एट्रिब्यूट की वैल्यू में वह समय दिखना चाहिए जब डेटाबेस से डेटा लिया गया था. इस वैल्यू का इस्तेमाल अलग-अलग फ़ीड में करने से, प्रोसेसिंग से जुड़ी गड़बड़ियां हो सकती हैं.
नॉनस वैल्यू, रैंडम या दोहराई न जाने वाली संख्याएं होती हैं. ये सभी फ़ीड टाइप के लिए यूनीक होनी चाहिए. इनका दोबारा इस्तेमाल नहीं किया जा सकता. शार्ड किए गए किसी फ़ीड की सभी फ़ाइलों के लिए, वैल्यू एक जैसी होनी चाहिए.
फ़ीड फ़ाइल का साइज़
फ़ीड फ़ाइलों को शार्ड करना
आपकी इन्वेंट्री के आधार पर, फ़ीड को कई फ़ाइलों में बांटना ज़रूरी हो सकता है. इन स्थितियों में, आपको अपने फ़ीड को कई हिस्सों में बांटना पड़ सकता है:
- कंप्रेस किए गए gzip फ़ीड की किसी फ़ाइल का साइज़ 200 एमबी से ज़्यादा है.
- उदाहरण: जनरेट किया गया उपलब्धता फ़ीड 1 जीबी का है. इसे पांच या उससे ज़्यादा अलग-अलग शार्ड में बांटा जाना चाहिए.
- पार्टनर की इन्वेंट्री को अलग-अलग सिस्टम या इलाकों में बांटा जाता है. इस वजह से, इन्वेंट्री का मिलान करने में मुश्किल होती है.
- उदाहरण: पार्टनर के पास अमेरिका और ईयू की इन्वेंट्री है, जो अलग-अलग सिस्टम में मौजूद है.
ऐसा हो सकता है कि फ़ीड को दो शार्ड के साथ जनरेट किया गया हो. एक अमेरिका के लिए और दूसरा ईयू के लिए. दोनों में एक ही नॉनस और
generation_timestampका इस्तेमाल किया गया हो.
- उदाहरण: पार्टनर के पास अमेरिका और ईयू की इन्वेंट्री है, जो अलग-अलग सिस्टम में मौजूद है.
ऐसा हो सकता है कि फ़ीड को दो शार्ड के साथ जनरेट किया गया हो. एक अमेरिका के लिए और दूसरा ईयू के लिए. दोनों में एक ही नॉनस और
ज़्यादा जानकारी के लिए, शार्ड किए गए फ़ीड फ़ाइलों के ट्यूटोरियल और सबसे सही तरीके देखें.
किसी फ़ीड में कई फ़ाइलें हो सकती हैं. इन्हें शार्ड कहा जाता है. फ़ीड का साइज़ तय करने के लिए, इन दिशा-निर्देशों का पालन करें:
- फ़ीड शार्डिंग का सुझाव:
- कारोबारी या कंपनी का फ़ीड: एक शार्ड.
- सेवाओं का फ़ीड: एक शार्ड.
- उपलब्धता फ़ीड: 20 से कम शार्ड. अगर आपके पास कारोबार से जुड़ा कोई ऐसा तर्क है जिसके लिए तय की गई सीमा से ज़्यादा रकम की ज़रूरत है, तो सहायता टीम से संपर्क करें.
- फ़ीड फ़ाइलों का साइज़ और शार्डिंग:
- कंप्रेस करने के बाद, शार्ड फ़ाइल का साइज़ 200 एमबी से कम रखें. ज़रूरत पड़ने पर, एक से ज़्यादा शार्ड का इस्तेमाल करें.
- एक शार्ड में भेजे गए अलग-अलग रिकॉर्ड को, आने वाले समय में फ़ीड के उसी शार्ड में भेजने की ज़रूरत नहीं होती.
- बेहतर परफ़ॉर्मेंस के लिए, डेटा को सभी शार्ड में बराबर बांटें, ताकि सभी शार्ड फ़ाइलें एक जैसी साइज़ की हों.
- अगर ज़रूरी हो, तो हर फ़ीड शार्ड के लिए, सादे टेक्स्ट वाले JSON फ़ीड को कंप्रेस करने के लिए gzip का इस्तेमाल करें.
फ़ीड की फ़ाइलों को कंप्रेस करना
अपलोड करने से पहले, किसी भी JSON या PB3 फ़ाइल को gzip का इस्तेमाल करके कंप्रेस किया जा सकता है. इससे, रोज़ाना के फ़ीड के बाइट साइज़ में काफ़ी कमी आ सकती है.
हर शार्ड फ़ाइल को gzip फ़ॉर्मैट में कंप्रेस किया जाना चाहिए. साथ ही, उन्हें अलग-अलग अपलोड किया जाना चाहिए. जैसे, gzip*.json. कंप्रेस किए गए फ़ीड शार्ड के आखिर में .json.gz या .pb3.gz होना चाहिए.
अपने एसएफ़टीपी ड्रॉपबॉक्स में फ़ीड अपलोड करना
कारोबारी या कंपनी,
सेवा, और उपलब्धता फ़ीड जनरेट करने के बाद, एसएफ़टीपी ड्रॉपबॉक्स के ज़रिए अपने फ़ीड को सैंडबॉक्स या प्रोडक्शन एनवायरमेंट में अपलोड किया जा सकता है. एसएफ़टीपी ड्रॉपबॉक्स तब कॉन्फ़िगर किया जाता है, जब सेटअप के दौरान एसएसएच कुंजी दी जाती है.
Google का एसएफ़टीपी सर्वर, पोर्ट 19321 पर sftp://partnerupload.google.com पर उपलब्ध है.
Google, SFTP ड्रॉपबॉक्स में फ़ीड फ़ाइलें अपलोड होते ही उनकी समीक्षा करता है और उनकी पुष्टि करता है. अगर फ़ीड को कई फ़ाइलों में बांटा गया है, तो आखिरी फ़ाइल अपलोड करने के बाद उन्हें प्रोसेस किया जाता है. अगर आपके फ़ीड में गड़बड़ियां हैं, तो आपको फ़ीड में हुई गड़बड़ियों के कोड के साथ एक ईमेल भेजा जाता है. गड़बड़ियों की वजह से, कारोबारियों, सेवाओं या उपलब्धता की जानकारी को शामिल नहीं किया जा सकता. फ़ीड की पुष्टि हो जाने के बाद, उन्हें फ़्रंटएंड पर दिखने में 24 घंटे लग सकते हैं.