यह ट्यूटोरियल इन्हें पूरा करता है:
- उपयोगकर्ता को उपलब्धता की जानकारी कैसे दिखाई जाती है और इसमें किस तरह का डेटा ज़रूरी होता है, इसके बारे में पूरी जानकारी दी जाती है
- अपने फ़ीड में, उपलब्धता डेटा को
action_linkके कोड में बदलने का तरीका - अगर दिन भर उपलब्धता में बदलाव होता रहता है, तो इसे अपडेट करने के निर्देश
- उपलब्धता की सही जानकारी के अनुमान
उपलब्धता मेटाडेटा के साथ, यह भी उम्मीद की जाती है कि आप डिलीवरी या पिक अप से जुड़े शुल्क के बारे में मेटाडेटा देंगे. साथ ही, यह भी बताएं कि ऑर्डर की कम से कम कितनी कीमत होगी. उपलब्धता के इस्तेमाल की जानकारी के साथ-साथ शुल्क और कम से कम ऑर्डर दिखाने वाले फ़ीड के पूरे सैंपल के लिए, खुदरा ऑर्डर की v1 फ़ीड का सैंपल देखें.
उपलब्धता से जुड़ी कौनसी जानकारी ज़रूरी है
इस अनुभव के लिए उपलब्ध रीटेल ऑर्डर को, दिन के लेवल पर ब्यौरे के हिसाब से इकट्ठा किया जाता है. उपलब्धता की यह जानकारी, उपयोगकर्ताओं को शुल्क और कम से कम कितने ऑर्डर के साथ दिखाई जाती है. इसके लिए, यह "आज उपलब्ध है", "कल उपलब्ध होगा" या "DD या MM पर उपलब्ध है" जैसे मैसेज के साथ दिखाया जाता है.
फ़ीड में यह डेटा सबमिट करते समय, आपको आने वाले समय में इन तारीखों के साथ उपलब्धता की जानकारी भेजी जाएगी. साथ ही, यह भी बताया जाएगा कि किस तारीख को उपयोगकर्ता ऑर्डर कर सकता है. साथ ही, हर तारीख के लिए पिक अप या डिलीवरी की तारीख भी सेट की जा सकती है. ऑर्डर पूरा करने की तारीख और ऑर्डर देने की आखिरी तारीख, ये दो जानकारी होती हैं.
उदाहरण के लिए: अगर आज की तारीख 23 मार्च, 2021 है और आज 4:00 बजे तक उपयोगकर्ता के ऑर्डर करने की सुविधा उपलब्ध है, तो आपको खरीदारी के लिए उपलब्धता की जानकारी देनी होगी:
- पूरा होने की तारीख: 24/03/2021
- पिछली बार ऑर्डर करने की तारीख: 2021/03/23: 4:00PM
ऑर्डर देने की आखिरी तारीख शामिल होने के बाद, Google फ़्रंट-एंड, आखिरी बार ऑर्डर होने की तारीख के बाद उपलब्ध होने की तारीख पर अपने-आप अपडेट हो जाएगा.
हर दिन, एक नया व्यापारी फ़ीड अपलोड करते समय, नया उपलब्धता डेटा शामिल किया जाना चाहिए. फ़्रंट एंड सिर्फ़ मौजूदा उपलब्धता को दिखाता है, इसलिए किसी दी गई जगह के लिए, उपलब्धता की अगली तीन से पांच तारीखें देना ज़रूरी है. इससे फ़्रंट एंड मौजूदा उपलब्धता को दिखा सकता है. साथ ही, यह अगली उपलब्धता के आखिरी समय के बाद दिखने वाली अगली उपलब्धता को भी दिखा सकता है.
फ़ीड के ज़रिए उपलब्धता के बारे में बताना
order_online_metadata फ़ीड के हिस्से के तौर पर, कार्रवाई फ़ीड के लिए उपलब्धता, action_link फ़ीड में शामिल होती है. हर व्यापारी/कंपनी और ऑर्डर पूरा करने के हर विकल्प के लिए, पाथ पर
AvailableDay मैसेज की सूची होती है
Merchant.action_link.order_online_metadata.fulfillment_option.available_day
मैसेज इस फ़ॉर्मैट में होने चाहिए:
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
},
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
}
इस फ़ॉर्मैट में, fulfillment_date वह साल, महीना, और दिन है जब उसकी उपलब्धता है. यह तारीख, इस व्यापारी/कंपनी की बताई गई जगह के हिसाब से होनी चाहिए.
last_ordering_time सेकंड में एक यूनिक्स टाइमस्टैंप है. यह
समय-क्षेत्र अलग होती है और यह उस आखिरी समय को बताती है जब व्यापारी
fulfillment_date में दी गई तारीख के लिए ऑर्डर ले सकता है. आखिरी
ऑर्डर का समय, सामान भेजने से पहले या ऑर्डर पूरा होने की तारीख के बीच का
हो सकता है. पिछली बार ऑर्डर मिलने की तारीख बीत जाने के बाद,
Google को सामान भेजने की तय तारीख के लिए उपलब्धता की जानकारी अपने-आप दिखना बंद हो जाएगी. साथ ही, ऑर्डर पूरा होने की अगली तारीख के आधार पर, Google
उससे उपलब्धता दिखाना शुरू कर देगा.
order_online_metadata की पहचान की परिभाषा के लिए, Merchant फ़ीड का रेफ़रंस देखें. JSON फ़ॉर्मैट में उपलब्धता वाले
फ़ीड सैंपल के लिए, फ़ीड के सैंपल के लिए रीटेल ऑर्डर + मेटाडेटा देखें.
रीयल-टाइम अपडेट की मदद से, ऐप्लिकेशन की उपलब्धता अपडेट करना
अगर आपके रोज़ के फ़ीड भेजने के समय के बीच, डिलीवरी या पिक अप की जगह की उपलब्धता बदल जाती है, तो रीयल-टाइम अपडेट REST API का इस्तेमाल उपयोगकर्ताओं को दिखाई जाने वाली उपलब्धता को अपडेट करने के लिए किया जा सकता है.
एक बार में सिर्फ़ एक व्यापारी/कंपनी को अपडेट किए जाते हैं. कोई अपडेट करते समय, आपको व्यापारी/कंपनी की जानकारी अपडेट करनी होगी. साथ ही, वे फ़ील्ड भी डालने होंगे जिन्हें एपीआई एंडपॉइंट के हिस्से के तौर पर अपडेट किया जाना चाहिए. इसके बाद, अनुरोध के मुख्य हिस्से में, आपको उन फ़ील्ड के लिए नया डेटा शामिल करना होगा. अपडेट किए जा रहे फ़ील्ड को दी गई जानकारी से बदल दिया जाएगा.
उपलब्धता की जानकारी अपडेट करने के लिए, आपको नीचे दिए गए एंडपॉइंट पर पैच का अनुरोध करना होगा:
PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link
इसके बाद, अनुरोध का मुख्य हिस्सा, action_link ऑब्जेक्ट वाला एक व्यापारी ऑब्जेक्ट होगा (क्योंकि हमने updateMask को सिर्फ़ action_link को शामिल करने के लिए सेट किया है):
{
"action_link": [
..., // all required action_link fields here
"order_online_metadata": {
"fulfillment_option": [
"fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
"available_day": [ // Include the updated availability here
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
}
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
},
... // Other updated availability_days
]
]
}
]
}
अगर एपीआई अनुरोध पूरा हो जाता है, तो रिस्पॉन्स में वह नया ऑब्जेक्ट शामिल किया जाएगा जिसमें नया डेटा जोड़ा गया है.
व्यापारी/कंपनी के अपडेट के तरीके की पूरी जानकारी के लिए, यहां देखें: मैथड: इन्वेंट्री.partners.merchants.patch.
उपलब्धता की सटीक जानकारी
Reserve with Google समझता है कि उपलब्धता की अलग-अलग जानकारी कई बातों पर निर्भर करती है. इनमें ये फ़ैक्टर शामिल हैं:
- ऑर्डर के साइज़ के आधार पर, उपलब्धता में बदलाव
- उपलब्धता की वजह से, ऑर्डर पूरा होने और चेकआउट करने के समय में हुए बदलाव
- उपलब्धता में बदलाव, फ़ीड या रीयल-टाइम अपडेट के ज़रिए अपडेट किए जाने के बीच इंतज़ार का समय
इनमें से किसी भी स्थिति की वजह से, उपयोगकर्ताओं को चेकआउट के समय उपलब्धता की जो जानकारी दिखेगी, वह असल में उपयोगकर्ता के लिए उपलब्ध नहीं होती है. खरीदारी के लिए उपलब्धता की सुविधा को लागू करने का मकसद, इन सुविधाओं को पूरी तरह से बंद करना नहीं है, बल्कि उपयोगकर्ताओं को इनके बारे में साफ़ तौर पर जानकारी देना है.
पार्टनर से एक ऐसी प्रक्रिया लागू करने की उम्मीद की जाती है जिससे उपयोगकर्ताओं को जितनी बार हो सके, उतनी बार सही तरीके से दिखाया जा सके. इसके अलावा, अगर ऑर्डर की जानकारी की वजह से उपलब्धता में कोई बदलाव होता है, तो यह जानकारी उपयोगकर्ताओं को साफ़ तौर पर दिखनी चाहिए. अगर आपको इस बारे में पक्के तौर पर नहीं पता कि आपके मामले में क्या ज़रूरी है, तो Reserve with Google की सहायता टीम से संपर्क करें.