बैच में डेटा डालना

डेटा फ़ीड की मदद से आप अपने रेस्टोरेंट, सेवाओं, और मेन्यू को Order with Google में उपलब्ध करा सकते हैं.

इस दस्तावेज़ में, सैंडबॉक्स और प्रोडक्शन इन्वेंट्री को होस्ट करने का तरीका बताया गया है. साथ ही, Order with Google में मौजूद अपनी इन्वेंट्री को अपडेट करने के लिए, बैच में डेटा डालने की सुविधा का इस्तेमाल किया जा सकता है.

डेटा फ़ीड परिवेश

आपके इंटिग्रेशन डेवलपमेंट के लिए, तीन डेटा फ़ीड उपलब्ध हैं:

फ़ीड एनवायरमेंट	जानकारी	बैच में डेटा डालना
Sandbox	आपके फ़ीड डेवलपमेंट के लिए टेस्ट एनवायरमेंट.	ज़रूरी है
प्रोडक्शन	आपकी इन्वेंट्री के लिए प्रोडक्शन एनवायरमेंट, जिसे आपको लॉन्च करना है.	ज़रूरी है

होस्टिंग डेटा फ़ीड

Order with Google आपके सैंडबॉक्स और प्रोडक्शन डेटा फ़ीड को बैच में डेटा जोड़कर प्रोसेस कर सके, इसके लिए आपको Google Cloud Storage, Amazon S3 या एचटीटीपीएस में अपनी डेटा फ़ीड फ़ाइलों को साइटमैप के साथ होस्ट करना होगा.

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

उदाहरण के लिए, अगर आप Google Cloud Storage का इस्तेमाल होस्टिंग के विकल्प के तौर पर करते हैं, तो आपके पास ये पाथ होंगे:

• सैंडबॉक्स फ़ीड: gs://foorestaurant-google-feed-sandbox/
• प्रोडक्शन फ़ीड: gs://foorestaurant-google-feed-prod/

अपनी इन्वेंट्री होस्ट करने के लिए, ये काम करें:

1. अपने डेटा फ़ीड की फ़ाइलें जनरेट करें.
2. कोई होस्टिंग समाधान चुनें.
3. अपने डेटा फ़ीड होस्ट करें.
4. पक्का करें कि आपकी डेटा फ़ीड फ़ाइलें नियमित रूप से अपडेट की जाती हैं. प्रोडक्शन डेटा फ़ीड को रोज़ अपडेट करना चाहिए.

इन्वेंट्री फ़ीड बनाने से जुड़ी जानकारी पाने के लिए, Restaurant, Service, और Menu इकाइयों के साथ-साथ डेटा फ़ीड बनाएं सेक्शन से जुड़े दस्तावेज़ देखें.

डेटा फ़ीड फ़ाइलों के लिए दिशा-निर्देश

हर फ़ाइल, जिसमें कई इकाइयां शामिल हो सकती हैं उसका साइज़ 200 एमबी से ज़्यादा नहीं होना चाहिए. टॉप लेवल की इकाइयों Restaurant, Service, और Menu के साथ-साथ उनकी चाइल्ड इकाइयां भी, एक साथ चार एमबी से ज़्यादा नहीं होनी चाहिए.

ध्यान दें: हमारा सुझाव है कि आप व्यापारी या कंपनी की हर जगह के लिए, एक जैसी डेटा फ़ीड फ़ाइल में मौजूद सभी मिलते-जुलते रेस्टोरेंट, सेवा, और मेन्यू की इकाइयों को एक साथ रखें. उदाहरण के लिए, अगर आपके पास व्यापारी/कंपनी की 8,000 जगहें हैं, तो 8,000 फ़ाइलें जनरेट करें. हर जगह की जानकारी के लिए अलग से फ़ाइल देने से, आप इंटिग्रेशन को डीबग और सपोर्ट कर सकते हैं.

होस्टिंग के लिए कोई विकल्प चुनें

नीचे दी गई टेबल में आपके डेटा फ़ीड होस्ट करने के विकल्प दिए गए हैं. साथ ही, यह भी बताया गया है कि वे होस्ट, Google के साथ किए गए ऑर्डर के साथ कैसे काम करते हैं:

	Amazon S3	Google Cloud Storage	साइटमैप वाला एचटीटीपीएस
क्रेडेंशियल और ऐक्सेस	Google को यह जानकारी दें: ऐक्सेस कुंजी आईडी सीक्रेट ऐक्सेस कुंजी आपके प्रोडक्शन और सैंडबॉक्स S3 डायरेक्ट्री और marker.txt फ़ाइल के पाथ. पाथ s3:// से शुरू होना चाहिए. S3 बकेट में यह जानकारी होनी चाहिए: अपनी इन्वेंट्री के लिए फ़ीड फ़ाइलें. marker.txt, जिसमें फ़ेच करने के लिए इस्तेमाल किया गया टाइमस्टैंप शामिल है. marker.txt फ़ाइल का उदाहरण: 2018-12-03T08:30:42.694Z	Google को अपनी प्रोडक्शन और सैंडबॉक्स बकेट डायरेक्ट्री और marker.txt फ़ाइल के पाथ बताएं. पाथ की शुरुआत gs:// से होनी चाहिए. उस सेवा खाते को जोड़ें जिसे आपके Google सलाहकार ने Google Cloud Storage बकेट के रीडर के तौर पर दिया है. Google Cloud Storage (GCS) का ऐक्सेस कंट्रोल करने के बारे में ज़्यादा जानने के लिए, Google Cloud Platform Console: बकेट की अनुमतियां सेट करना देखें. GCS बकेट में यह जानकारी होनी चाहिए: अपनी इन्वेंट्री के लिए फ़ीड फ़ाइलें. marker.txt, जिसमें फ़ेच करने के लिए इस्तेमाल किया गया टाइमस्टैंप शामिल है. marker.txt फ़ाइल का उदाहरण: 2018-12-03T08:30:42.694Z	Google को यह जानकारी दें: आपके बुनियादी क्रेडेंशियल में क्रेडेंशियल. आपके प्रोडक्शन और सैंडबॉक्स साइटमैप के पाथ. पाथ https:// से शुरू होना चाहिए. प्रोटोकॉल: आपको अपनी फ़ीड फ़ाइलों को एचटीटीपीएस के ज़रिए उपलब्ध कराना होगा, न कि एचटीटीपी के ज़रिए. सुरक्षा: Google आपको सुझाव देता है कि आप होस्ट की गई फ़ीड फ़ाइलों को बुनियादी पुष्टि करने के ज़रिए सुरक्षित रखें.
Google को कैसे पता चलता है कि किन फ़ाइलों को फ़ेच करना है	बकेट में सभी फ़ाइलों की निर्देशिका लिस्टिंग.	बकेट में सभी फ़ाइलों की निर्देशिका लिस्टिंग.	साइटमैप में दी गई फ़ाइलों के अलग-अलग यूआरएल.
Google को कैसे पता चलता है कि फ़ाइलें फ़ेच की जा सकती हैं	डेटा फ़ीड जनरेट करने के बाद, नए टाइमस्टैंप की मदद से marker.txt फ़ाइल को अपडेट करें.	डेटा फ़ीड जनरेट करने के बाद, नए टाइमस्टैंप की मदद से marker.txt फ़ाइल को अपडेट करें.	डेटा फ़ीड जनरेट करने के बाद, अपने sitemap.xml के रिस्पॉन्स हेडर last-modified को नए टाइमस्टैंप के साथ अपडेट करें.
फ़ाइल की सीमाएं	फ़ाइलों की ज़्यादा से ज़्यादा संख्या: 1,00,000. आपके Amazon S3 बकेट में कुल 1,00,000 से कम फ़ाइलें होनी चाहिए.	फ़ाइलों की ज़्यादा से ज़्यादा संख्या: 1,00,000. आपके Google Cloud Storage बकेट में कुल 1,00,000 से कम फ़ाइलें होनी चाहिए.	फ़ाइलों की ज़्यादा से ज़्यादा संख्या: 1,00,000. आपकी साइटमैप एक्सएमएल फ़ाइल में मौजूद फ़ाइल पाथ की संख्या 1,00,000 से कम होनी चाहिए.

बैच में डेटा डालने के लिए, अपने डेटा फ़ीड को कनेक्ट करना

अपने फ़ीड होस्ट करने के बाद, आपको उन्हें पार्टनर पोर्टल पर अपने प्रोजेक्ट से कनेक्ट करना होगा. प्रोडक्शन फ़ीड का शुरुआती कॉन्फ़िगरेशन, शामिल होने के टास्क वाले पेज पर किया जाता है. बाद में, प्रोडक्शन और सैंडबॉक्स फ़ीड के कॉन्फ़िगरेशन को कॉन्फ़िगरेशन > फ़ीड पेज से, किसी भी समय पोर्टल के ज़रिए अपडेट किया जा सकता है. ऐसा पोर्टल के उपयोगकर्ताओं की मदद से किया जा सकता है. सैंडबॉक्स एनवायरमेंट का इस्तेमाल, डेवलपमेंट और टेस्टिंग के लिए किया जाता है, जबकि प्रोडक्शन फ़ीड को उपयोगकर्ताओं को दिखाया जाता है.

अगर आप अपने डेटा फ़ीड को Amazon S3 के साथ होस्ट करते हैं

1. पार्टनर पोर्टल में, कॉन्फ़िगरेशन > फ़ीड पर जाएं.

2. बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:

   • फ़ीड डिलीवरी का तरीका: Amazon S3 पर सेट करें.
   • मार्कर फ़ाइल: marker.txt फ़ाइल का यूआरएल दें.
   • डेटा फ़ाइलें: उस S3 बकेट का यूआरएल दें जिसमें डेटा फ़ीड हैं.
   • ऐक्सेस आईडी: S3 संसाधनों से पढ़ने के लिए अनुमतियों के साथ आईएएम ऐक्सेस कुंजी आईडी डालें.
   • ऐक्सेस कुंजी: S3 संसाधनों से पढ़ने के लिए अनुमतियों के साथ IAM सीक्रेट ऐक्सेस कुंजी डालें.
3. इसके बाद, सबमिट करें पर क्लिक करें.
4. एक से दो घंटे बाद देखें कि बैच में डेटा डालने पर, आपकी फ़ीड फ़ाइलें फ़ेच होती हैं या नहीं.

अगर आप Google Cloud Storage के साथ डेटा फ़ीड होस्ट करते हैं

1. पार्टनर पोर्टल में, कॉन्फ़िगरेशन > फ़ीड पर जाएं.

2. बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:

   • फ़ीड डिलीवरी का तरीका: Google Cloud Storage पर सेट करें.
   • मार्कर फ़ाइल: marker.txt फ़ाइल का यूआरएल दें.
   • डेटा फ़ाइलें: जीसीएस बकेट में यूआरएल डालें, जिसमें डेटा फ़ीड हों.
3. इसके बाद, सबमिट करें पर क्लिक करें.
4. एक सेवा खाता बनाया गया है, ताकि जीसीएस बकेट को ऐक्सेस किया जा सके. शामिल होने के टास्क पूरे होने के बाद, कॉन्फ़िगरेशन > फ़ीड में खाते का नाम देखा जा सकता है. इस सेवा खाते को "स्टोरेज लेगसी ऑब्जेक्ट रीडर" भूमिका की ज़रूरत है. यह भूमिका, Google Cloud Console के आईएएम पेज में, सेवा खाते को दी जा सकती है.
5. एक से दो घंटे बाद देखें कि बैच में डेटा डालने पर, आपकी फ़ीड फ़ाइलें फ़ेच होती हैं या नहीं.

अगर आप अपने डेटा फ़ीड को एचटीटीपीएस के साथ होस्ट करते हैं

1. पार्टनर पोर्टल में, कॉन्फ़िगरेशन > फ़ीड पर जाएं.

2. बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:

   • फ़ीड डिलीवरी का तरीका: एचटीटीपीएस पर सेट करें.
   • साइटमैप फ़ाइल: sitemap.xml फ़ाइल का यूआरएल दें.
   • उपयोगकर्ता नाम: एचटीटीपीएस सर्वर को ऐक्सेस करने के लिए, उपयोगकर्ता नाम वाले क्रेडेंशियल डालें.
   • पासवर्ड: एचटीटीपीएस सर्वर को ऐक्सेस करने के लिए पासवर्ड डालें.
3. इसके बाद, सबमिट करें पर क्लिक करें.
4. एक से दो घंटे बाद देखें कि बैच में डेटा डालने पर, आपकी फ़ीड फ़ाइलें फ़ेच होती हैं या नहीं.

पाथ के उदाहरण

नीचे दिए गए टेबल में, होस्टिंग के हर विकल्प के लिए पाथ के उदाहरण दिए गए हैं:

	Amazon S3	Google Cloud Storage	साइटमैप वाला एचटीटीपीएस
पाथ	s3://foorestaurant-google-feed-sandbox/	gs://foorestaurant-google-feed-sandbox/	https://sandbox-foorestaurant.com/sitemap.xml
मार्कर फ़ाइल	s3://foorestaurant-google-feed-sandbox/marker.txt	gs://foorestaurant-google-feed-sandbox/marker.txt	लागू नहीं

एचटीटीपीएस होस्टिंग के लिए साइटमैप

साइटमैप तय करते समय इन दिशा-निर्देशों का पालन करें:

• आपके साइटमैप में दिए गए लिंक पर क्लिक करने से, फ़ाइलें खुद लिंक होनी चाहिए.
• अगर आपके साइटमैप में क्लाउड सेवा देने वाली कंपनी के बारे में जानकारी देने के बजाय, आपके डोमेन नेम का इस्तेमाल किया गया है, तो पक्का करें कि यूआरएल की शुरुआत में बदलाव किया जा रहा हो. जैसे, https://www.yourcloudprovider.com/your_id. इन फ़ाइलों में, आपके बैच के काम एक जैसे होते हैं.
• आंशिक साइटमैप अपलोड न करें (जैसे कि आंशिक डेटा अपलोड होने की स्थिति में). ऐसा करने से, Google सिर्फ़ साइटमैप में मौजूद फ़ाइलों को डाल देता है. इस वजह से आपकी इन्वेंट्री के लेवल में कमी आ सकती है. इस वजह से, आपके फ़ीड में डेटा जोड़ने पर रोक लगाई जा सकती है.
• पक्का करें कि साइटमैप में दी गई फ़ाइलों के पाथ में बदलाव न हो. उदाहरण के लिए, आज अपने साइटमैप के बारे में https://www.yourcloudprovider.com/your_id/10000.json न बताएं, लेकिन कल https://www.yourcloudprovider.com/your_id/20000.json का रेफ़रंस लें.

साइटमैप का उदाहरण

डेटा फ़ाइल को पेश करने वाली sitemap.xml फ़ाइल का उदाहरण यहां दिया गया है:

उदाहरण 1: व्यापारियों/कंपनियों के हिसाब से ग्रुप की गई इकाइयां (सुझाई गई).

एक्सएमएल

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

उदाहरण 2: टाइप के हिसाब से ग्रुप की गई इकाइयां.

एक्सएमएल

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

ध्यान दें: ऑर्डर वाले Google साइटमैप में सिर्फ़ loc का इस्तेमाल करना चाहिए.

अपने डेटा फ़ीड अपडेट करें

डेटा फ़ीड कनेक्ट होने के बाद, Google हर घंटे अपडेट का पता लगाता है. हालांकि, हम सारे डेटा फ़ीड तब ही डालते हैं, जब marker.txt या sitemap.xml की फ़ाइलों में बदलाव किए गए हों. पुरानी इन्वेंट्री को रोकने के लिए, हम आपको दिन में एक बार डेटा फ़ीड अपडेट करने की उम्मीद करते हैं.

यह बताने के लिए कि डेटा फ़ीड में बदलाव किया गया है और बैच में डेटा डालने के लिए तैयार हैं, marker.txt फ़ाइल के last-modified ऑब्जेक्ट मेटाडेटा फ़ील्ड या sitemap.xml फ़ाइल के लिए, last-modified रिस्पॉन्स हेडर या last-modified रिस्पॉन्स हेडर के last-modified को अपडेट करें. Google इन वैल्यू का इस्तेमाल करके यह तय करता है कि डेटा फ़ीड कितना नया है.

बैच में फ़ीड का डेटा डाला जा रहा है, इसलिए

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

टाइमस्टैंप या last-modified रिस्पॉन्स हेडर को सिर्फ़ तब अपडेट किया जाना चाहिए, जब डेटा फ़ीड की सभी फ़ाइलें जनरेट और अपडेट की गई हों. उन बैच जॉब को सीमित करें जो आपके डेटा फ़ीड को दिन में सिर्फ़ एक बार चलने के लिए अपडेट करते हैं. इसके अलावा, हर बैच के काम के बीच कम से कम तीन घंटे का अंतर रखें. अगर आप यह तरीका नहीं अपनाते हैं, तो Google पुरानी फ़ाइलों को फ़ेच कर सकता है.

ध्यान दें: last-modified, इकाई के वर्शन से अलग है. last-modified बैच के पिक अप होने पर यह ट्रिगर होता है, और इसका इकाई और वर्शन के वर्शन पर कोई असर नहीं पड़ता है.