आपके डेटा फ़ीड आपको आपके रेस्टोरेंट, सेवाओं, और मेन्यू को सीधे खाना ऑर्डर करने की सुविधा में उपलब्ध कराया जाता है.
इस दस्तावेज़ में अपने सैंडबॉक्स और प्रोडक्शन इन्वेंट्री को होस्ट करने और बैच में डेटा डालने की सुविधा का इस्तेमाल करने के तरीके के बारे में बताया गया है पर क्लिक करें.
डेटा फ़ीड एनवायरमेंट
आपके इंटिग्रेशन डेवलपमेंट के लिए तीन डेटा फ़ीड एनवायरमेंट उपलब्ध हैं:
फ़ीड एनवायरमेंट | ब्यौरा | बैच में डेटा डालना |
---|---|---|
Sandbox | आपके फ़ीड डेवलपमेंट के लिए टेस्ट एनवायरमेंट. | ज़रूरी है |
प्रोडक्शन | आपकी इन्वेंट्री के लिए प्रोडक्शन एनवायरमेंट, जिसे आपको लॉन्च करना है. | ज़रूरी है |
डेटा फ़ीड होस्ट करना
शुरू से आखिर तक ऑर्डर करने के लिए, बैच के हिसाब से सैंडबॉक्स और प्रोडक्शन डेटा फ़ीड को प्रोसेस करने के लिए डेटा डालने के लिए, आपको अपने डेटा फ़ीड की फ़ाइलों को Google Cloud Storage, Amazon S3 या एचटीटीपीएस में होस्ट करना होगा. इसके लिए, साइटमैप.
हमारा सुझाव है कि आप अपने सैंडबॉक्स और प्रोडक्शन एनवायरमेंट के लिए डेटा फ़ीड होस्ट करें अलग करना होगा. इस तरीके से, आपको सैंडबॉक्स फ़ीड एनवायरमेंट में डेवलपमेंट और टेस्ट करने में मदद मिलती है इससे पहले कि आप बदलावों को प्रोडक्शन में लागू करें.
उदाहरण के लिए, अगर Google Cloud Storage का इस्तेमाल होस्टिंग के विकल्प के तौर पर किया जाता है, तो आपके पास ये होंगे पाथ:
- सैंडबॉक्स फ़ीड:
gs://foorestaurant-google-feed-sandbox/
- प्रोडक्शन फ़ीड:
gs://foorestaurant-google-feed-prod/
अपनी इन्वेंट्री होस्ट करने के लिए, यह तरीका अपनाएं:
- अपने डेटा फ़ीड की फ़ाइलें जनरेट करें.
- कोई होस्टिंग समाधान चुनें.
- अपने डेटा फ़ीड होस्ट करें.
- पक्का करें कि आपकी डेटा फ़ीड फ़ाइलें नियमित रूप से अपडेट की जाती हैं. प्रोडक्शन डेटा फ़ीड को अपडेट करना ज़रूरी है रोज़ाना.
इन्वेंट्री फ़ीड बनाने के तरीके के बारे में जानने के लिए, यहां दिए गए दस्तावेज़ देखें
Restaurant
Service
,
और Menu
इकाइयों और साथ ही
डेटा फ़ीड बनाएं
सेक्शन में जाएं.
डेटा फ़ीड फ़ाइलों के लिए दिशा-निर्देश
कई इकाइयों वाली हर फ़ाइल का साइज़ 200 एमबी से ज़्यादा नहीं होना चाहिए. टॉप-लेवल
Restaurant
, Service
, और Menu
इकाइयां
चाइल्ड इकाइयां, कुल मिलाकर चार एमबी से ज़्यादा नहीं होनी चाहिए.
एक होस्टिंग समाधान चुनें
नीचे दी गई टेबल में, डेटा फ़ीड को होस्ट करने के विकल्पों की जानकारी दी गई है. साथ ही, यह भी बताया गया है कि वे होस्ट कैसे काम करते हैं सीधे खाना ऑर्डर करने की सुविधा:
Amazon S3 | Google Cloud Storage | साइटमैप के साथ एचटीटीपीएस | |
---|---|---|---|
क्रेडेंशियल और ऐक्सेस |
Google को यह जानकारी दें:
S3 बकेट में यह जानकारी शामिल होनी चाहिए:
|
Google को अपनी प्रोडक्शन और सैंडबॉक्स बकेट डायरेक्ट्री का पाथ दें और
आपके Google सलाहकार ने जो सेवा खाता दिया है उसे Google खाते में रीडर के तौर पर जोड़ें Cloud Storage बकेट. Google Cloud Storage (GCS) का ऐक्सेस कंट्रोल करने के तरीके के बारे में ज़्यादा जानकारी के लिए, देखें Google Cloud Platform Console: बकेट की अनुमतियां सेट करना. GCS बकेट में यह जानकारी शामिल होनी चाहिए:
|
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 का इस्तेमाल करके डेटा फ़ीड होस्ट करने पर क्या होगा
- कार्रवाई केंद्र में, कॉन्फ़िगरेशन > पर जाएं फ़ीड.
-
बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:
- फ़ीड डिलीवरी का तरीका: Amazon S3 पर सेट करें.
- मार्कर फ़ाइल:
marker.txt
फ़ाइल का यूआरएल दें. - डेटा फ़ाइलें: उस S3 बकेट का यूआरएल दें जिसमें डेटा फ़ीड हैं.
- ऐक्सेस आईडी: S3 से पढ़ने की अनुमतियों के साथ IAM ऐक्सेस कुंजी आईडी डालें संसाधन.
- ऐक्सेस कुंजी: S3 से पढ़ने की अनुमतियों के साथ IAM सीक्रेट ऐक्सेस कुंजी डालें संसाधन.
- सबमिट करें पर क्लिक करें.
- एक से दो घंटे बाद, देखें कि बैच में डेटा डालने की सुविधा आपकी फ़ीड फ़ाइलों को फ़ेच करती है या नहीं.
अगर Google Cloud Storage की मदद से डेटा फ़ीड होस्ट किए जाते हैं, तो
- कार्रवाई केंद्र में, कॉन्फ़िगरेशन > पर जाएं फ़ीड.
-
बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:
- फ़ीड डिलीवरी का तरीका: Google Cloud Storage पर सेट करें.
- मार्कर फ़ाइल:
marker.txt
फ़ाइल का यूआरएल दें. - डेटा फ़ाइलें: उस GCS बकेट को यूआरएल दें जिसमें डेटा फ़ीड है.
- सबमिट करें पर क्लिक करें.
- आपके GCS बकेट को ऐक्सेस करने के लिए, एक सेवा खाता बनाया जाता है. खाते का नाम यहां देखा जा सकता है: शामिल होने के टास्क के बाद कॉन्फ़िगरेशन > फ़ीड पूर्ण हैं. इस सेवा खाते के लिए, “स्टोरेज लेगसी ऑब्जेक्ट रीडर” रोल की ज़रूरत होती है. यह भूमिका ये काम कर सकती है Google Cloud Console के IAM पेज में सेवा खाते में दी जाएगी.
- एक से दो घंटे बाद, देखें कि बैच में डेटा डालने की सुविधा आपकी फ़ीड फ़ाइलों को फ़ेच करती है या नहीं.
अगर एचटीटीपीएस का इस्तेमाल करके डेटा फ़ीड होस्ट किए जाते हैं, तो
- कार्रवाई केंद्र में, कॉन्फ़िगरेशन > पर जाएं फ़ीड.
-
बदलाव करें पर क्लिक करें और फ़ीड अपडेट करें फ़ॉर्म भरें:
- फ़ीड की डिलीवरी का तरीका: एचटीटीपीएस पर सेट करें.
- साइटमैप फ़ाइल:
sitemap.xml
फ़ाइल का यूआरएल दें. - उपयोगकर्ता नाम: एचटीटीपीएस सर्वर को ऐक्सेस करने के लिए, उपयोगकर्ता नाम के क्रेडेंशियल डालें.
- पासवर्ड: एचटीटीपीएस सर्वर ऐक्सेस करने के लिए पासवर्ड डालें.
- सबमिट करें पर क्लिक करें.
- एक से दो घंटे बाद, देखें कि बैच में डेटा डालने की सुविधा आपकी फ़ीड फ़ाइलों को फ़ेच करती है या नहीं.
पाथ के उदाहरण
यहां दी गई टेबल में, होस्टिंग के हर विकल्प के लिए, उदाहरण के पाथ दिए गए हैं:
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>
डेटा फ़ीड अपडेट करना
डेटा फ़ीड कनेक्ट हो जाने के बाद, Google हर घंटे में एक बार अपडेट की जांच करता है. हालांकि, हम डेटा फ़ीड का डेटा ही अपलोड करते हैं
सभी डेटा फ़ीड, जब marker.txt
या sitemap.xml
फ़ाइलें
संशोधित. हम उम्मीद करते हैं कि पुरानी इन्वेंट्री से बचने के लिए, आप अपने डेटा फ़ीड को दिन में एक बार अपडेट करें.
यह बताने के लिए कि डेटा फ़ीड में बदलाव किया गया है और वह बैच में डेटा डालने के लिए तैयार है, अपडेट करें
marker.txt
फ़ाइल का last-modified
ऑब्जेक्ट मेटाडेटा फ़ील्ड (जीसीपी और
S3) या sitemap.xml
फ़ाइल का last-modified
रिस्पॉन्स हेडर. Google
इन वैल्यू का इस्तेमाल यह तय करने के लिए करता है कि डेटा फ़ीड कितना नया है.
बैच फ़ीड का डेटा डाला जा रहा है.
- ऐसी नई इकाइयां जो आपकी मौजूदा ऑर्डर की एंड-टू-एंड इन्वेंट्री में मौजूद नहीं हैं और जिनके पास गड़बड़ियां शामिल कर दी जाएंगी.
-
इन्वेंट्री में पहले से मौजूद ऐसी इकाइयां जिनमें कोई गड़बड़ी नहीं है
डेटा डालने के साथ-साथ आपके पास उससे ज़्यादा हाल का
dateModified
भी हो मौजूदा एंट्री याdateModified
न होने के मामले में फ़ीड में डेटा डालने का शुरू होने का समय, मौजूदा एंट्री के समय से ज़्यादा नया है उसे अपडेट नहीं किया जाएगा, नहीं तो उन्हें पुरानी के रूप में चिह्नित किया जाएगा. - ऐसी इकाइयां जो किसी पिछले फ़ीड का हिस्सा थीं और जो अब इसमें शामिल नहीं हैं प्रोसेस किया जा रहा बैच फ़ीड मिटा दिया जाएगा, बशर्ते कोई फ़ाइल न हो स्तर की गड़बड़ियां ठीक करने का तरीका खोज रहे हैं.
पूरे डेटा के बाद ही टाइमस्टैंप या last-modified
रिस्पॉन्स हेडर को अपडेट किया जाना चाहिए
फ़ीड फ़ाइलें बनाई और अपडेट की जाती हैं. अपने डेटा फ़ीड को अपडेट करने वाले बैच जॉब को सिर्फ़ चलाने के लिए सीमित करें
दिन में एक बार. वैकल्पिक तौर पर, हर बैच जॉब के बीच कम से कम तीन घंटे का अंतर रखें. अगर आपको
यह तरीका अपनाएं, तो Google पुरानी फ़ाइलों को फ़ेच कर सकता है.