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

आपके डेटा फ़ीड आपको आपके रेस्टोरेंट, सेवाओं, और मेन्यू को सीधे खाना ऑर्डर करने की सुविधा में उपलब्ध कराया जाता है.

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

डेटा फ़ीड एनवायरमेंट

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

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

डेटा फ़ीड होस्ट करना

शुरू से आखिर तक ऑर्डर करने के लिए, बैच के हिसाब से सैंडबॉक्स और प्रोडक्शन डेटा फ़ीड को प्रोसेस करने के लिए डेटा डालने के लिए, आपको अपने डेटा फ़ीड की फ़ाइलों को 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 फ़ाइलें जनरेट करें. हर एक फ़ाइल के लिए अलग फ़ाइल कारोबारी या कंपनी की जगह की जानकारी की मदद से, आपके लिए इंटिग्रेशन को डीबग और सहायता करना आसान हो जाता है.

एक होस्टिंग समाधान चुनें

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

	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 से पढ़ने की अनुमतियों के साथ IAM ऐक्सेस कुंजी आईडी डालें संसाधन.
   • ऐक्सेस कुंजी: S3 से पढ़ने की अनुमतियों के साथ IAM सीक्रेट ऐक्सेस कुंजी डालें संसाधन.
3. सबमिट करें पर क्लिक करें.
4. एक से दो घंटे बाद, देखें कि बैच में डेटा डालने की सुविधा आपकी फ़ीड फ़ाइलों को फ़ेच करती है या नहीं.

अगर Google Cloud Storage की मदद से डेटा फ़ीड होस्ट किए जाते हैं, तो

1. कार्रवाई केंद्र में, कॉन्फ़िगरेशन > पर जाएं फ़ीड.

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

   • फ़ीड डिलीवरी का तरीका: Google Cloud Storage पर सेट करें.
   • मार्कर फ़ाइल: marker.txt फ़ाइल का यूआरएल दें.
   • डेटा फ़ाइलें: उस GCS बकेट को यूआरएल दें जिसमें डेटा फ़ीड है.
3. सबमिट करें पर क्लिक करें.
4. आपके GCS बकेट को ऐक्सेस करने के लिए, एक सेवा खाता बनाया जाता है. खाते का नाम यहां देखा जा सकता है: शामिल होने के टास्क के बाद कॉन्फ़िगरेशन > फ़ीड पूर्ण हैं. इस सेवा खाते के लिए, “स्टोरेज लेगसी ऑब्जेक्ट रीडर” रोल की ज़रूरत होती है. यह भूमिका ये काम कर सकती है Google Cloud Console के IAM पेज में सेवा खाते में दी जाएगी.
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 फ़ाइल दी गई है, जिसमें डेटा फ़ीड फ़ाइलें दिखाई जाती हैं:

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

XML

<?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>

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

XML

<?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>

ध्यान दें: सीधे अनुवाद वाले साइटमैप के लिए सिर्फ़ यह ज़रूरी फ़ील्ड है loc.

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

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

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

बैच फ़ीड का डेटा डाला जा रहा है.

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

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

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