- संसाधन: खरीदारी के लिए उपलब्धता
- संसाधन
- बार-बार होने वाली समस्या
- ScheduleException
- ऐडवांस पेमेंट
- PriceInfo
- PriceRange
- DurationRequirement
- SchedulingRuleOverrides
- ConfirmationMode
- LinkoutRequiredReason
- तरीके
संसाधन: उपलब्धता
कारोबारी या कंपनी की सेवा के लिए उपलब्ध स्लॉट. इसमें समय और स्पॉट की संख्या के बारे में जानकारी होती है.
| JSON के काेड में दिखाना |
|---|
{ "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
| फ़ील्ड | |
|---|---|
startTime |
अपॉइंटमेंट स्लॉट के शुरू होने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
duration |
अपॉइंटमेंट स्लॉट की अवधि यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में ' |
spotsTotal |
इस उपलब्धता के लिए कुल और उपलब्ध स्लॉट की संख्या. उदाहरण:
ध्यान दें: अगर नीचे दिए गए 'उपलब्धता कंप्रेस करने का फ़ॉर्मैट' का इस्तेमाल करके अनुरोध भेजे जाते हैं, तो इन दोनों फ़ील्ड की जानकारी अपने-आप भर जाएगी.
|
spotsOpen |
उपलब्ध स्लॉट की संख्या. |
availabilityTag |
उपलब्धता के इस स्लॉट की पहचान करने के लिए, ओपेक स्ट्रिंग. हालांकि, ऐसा करना ज़रूरी नहीं है. अगर यह सेट है, तो इसे अपॉइंटमेंट बुक करने, अपडेट करने या रद्द करने के अनुरोधों में शामिल किया जाएगा. |
resources |
ये ऐसे संसाधन होते हैं जिनका इस्तेमाल करना ज़रूरी नहीं है. इनका इस्तेमाल, उपलब्धता के इस स्लॉट को अन्य स्लॉट से अलग करने के लिए किया जाता है. ऐसा तब किया जाता है, जब सेवा में अलग-अलग स्टाफ़ सदस्य या कमरे शामिल हों. उदाहरण के लिए, दो प्रशिक्षकों के साथ एक ही योग क्लास: |
paymentOptionId[] |
पेमेंट के उन विकल्पों के आईडी की सूची जिनसे इस स्लॉट के लिए पेमेंट किया जा सकता है. पेमेंट के असल विकल्पों को कारोबारी या कंपनी के लेवल पर तय किया जाता है. साथ ही, इन्हें कई कारोबारियों या कंपनियों के साथ शेयर भी किया जा सकता है. यह फ़ील्ड, सेवा से जुड़े मैसेज में बताए गए किसी भी payment_option_ids को बदल देता है. इसी तरह, यहां दिए गए payment_option_ids, सेवा से जुड़े मैसेज में मौजूद नहीं होने चाहिए. हालांकि, इन्हें कारोबारी या कंपनी के लेवल पर तय किया जाना चाहिए. |
recurrence |
उपलब्धता की बार-बार होने वाली जानकारी, जिसमें एक से ज़्यादा शुरू होने का समय शामिल होता है. एक बार-बार होने वाली बुकिंग में, एक कामकाजी दिन के लिए अपॉइंटमेंट होने चाहिए. |
scheduleException[] |
वे समय जब इस सेवा को शेड्यूल नहीं किया जा सकता. scheduleException मैसेज की संख्या कम करने के लिए, आस-पास के अपवादों को एक साथ जोड़ें. |
deposit |
इस उपलब्धता के लिए, वैकल्पिक तौर पर जमा की जाने वाली रकम. अगर सेवा के लिए कोई डिपॉज़िट तय किया गया है, तो यह उसे ओवरराइड कर देता है. |
noShowFee |
इस उपलब्धता के लिए, बिना दिखाए बुकिंग रद्द करने पर लगने वाला शुल्क. यह जानकारी देना ज़रूरी नहीं है. अगर सेवा के लिए खरीदार के मौजूद न रहने पर लगने वाला शुल्क तय किया गया है, तो यह विकल्प उसे बदल देता है. |
prepayment |
ज़रूरी नहीं. उपलब्धता के इस विकल्प के लिए, पहले से पेमेंट करने के बारे में जानकारी. यह जानकारी देना ज़रूरी नहीं है. |
requireCreditCard |
इससे पता चलता है कि बुकिंग के लिए, उपयोगकर्ता को क्रेडिट कार्ड की जानकारी देनी होगी या नहीं. अगर वैल्यू सेट नहीं की गई है, तो इसे सेवा के लेवल से इनहेरिट किया जाता है. हालांकि, ऐसा तब होता है, जब इसे सेवा के लेवल पर सेट किया गया हो. (ज़रूरी नहीं) |
ticketTypeId[] |
इससे, उपलब्धता के इस स्लॉट के लिए, टिकट के टाइप की सूची मिलती है. अगर इसे सेट नहीं किया जाता है, तो पैरंट सेवा में मौजूद सभी तरह के टिकट, इस स्लॉट के लिए उपलब्ध होते हैं. ध्यान दें कि इस फ़ील्ड की वैल्यू, पैरंट सेवा में तय की जानी चाहिए. उदाहरण:
सोमवार से शुक्रवार तक इन्वेंट्री दिखाने के लिए:
यह बताने के लिए कि इस टाइम स्लॉट के लिए, तीनों तरह के टिकट उपलब्ध हैं, (ज़रूरी नहीं) |
durationRequirement |
स्लॉट की अवधि और/या खत्म होने का समय दिखाने की ज़रूरत. अगर स्लॉट उपलब्ध नहीं है, तो इस फ़ील्ड को अनदेखा कर दिया जाएगा. इसका इस्तेमाल 'करने के लिए चीज़ें' वर्टिकल में नहीं किया जाता. (ज़रूरी नहीं) |
schedulingRuleOverrides |
उपलब्धता शेड्यूल करने के नियम. अगर फ़ील्ड में वैल्यू मौजूद हैं, तो वे सेवा-स्तर पर SchedulingRules में मौजूद, शेड्यूल करने के नियमों को बदल देंगी. |
confirmationMode |
पुष्टि करने का वह मोड जिसका इस्तेमाल, उपलब्धता बुक करते समय किया जाएगा. CONFIRMATION_MODE_SYNCHRONOUS वाले बुकिंग मोड के लिए, बुकिंग करने के अनुरोध को तुरंत स्वीकार या अस्वीकार किया जाना चाहिए. CONFIRMATION_MODE_ASYNCHRONOUS के कन्फ़र्मेशन मोड के साथ उपलब्धता के लिए बुकिंग बनाने के अनुरोध को तुरंत अस्वीकार कर दिया जाना चाहिए या PENDING स्टेटस के साथ बनाया जाना चाहिए. |
linkoutRequiredReason |
ज़रूरी नहीं. इस स्लॉट के लिए लिंकआउट की ज़रूरत क्यों है. अगर यह फ़ील्ड सेट है, तो इस स्लॉट के लिए कारोबारी के संसाधन में मान्य LinkoutTemplate होना चाहिए. (ज़रूरी नहीं) |
संसाधन
अगर सेवा में अलग-अलग स्टाफ़ सदस्य या कमरे शामिल हैं, तो एक संसाधन का इस्तेमाल, उपलब्धता के स्लॉट को एक-दूसरे से अलग करने के लिए किया जाता है. एक ही सेवा और समय अंतराल के लिए, एक से ज़्यादा स्लॉट तब मौजूद हो सकते हैं, जब उनके संसाधन अलग-अलग हों.
| JSON के काेड में दिखाना |
|---|
{
"staffId": string,
"staffName": string,
"roomId": string,
"roomName": string,
"partySize": integer,
"roomDescription": {
object ( |
| फ़ील्ड | |
|---|---|
staffId |
सेवा देने वाले स्टाफ़ सदस्य के लिए वैकल्पिक आईडी. इस फ़ील्ड से, सभी कारोबारियों या कंपनियों, सेवाओं, और उपलब्धता के रिकॉर्ड में स्टाफ़ मेंबर की पहचान होती है. साथ ही, यह समय के साथ स्थिर होना चाहिए, ताकि इसे पिछली बुकिंग से जोड़ा जा सके. अगर staffName मौजूद है, तो यह फ़ील्ड मौजूद होना चाहिए. |
staffName |
सेवा देने वाले स्टाफ़ सदस्य का नाम. यह जानकारी देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले लोगों को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे लोग आसानी से समझ सकें. यह ओपेक आइडेंटिफ़ायर नहीं होना चाहिए. अगर staffId मौजूद है, तो यह फ़ील्ड मौजूद होना चाहिए. |
roomId |
यह उस कमरे का आईडी है जहां सेवा उपलब्ध है. यह आईडी देना ज़रूरी नहीं है. इस फ़ील्ड से, सभी कारोबारियों या कंपनियों, सेवाओं, और उपलब्धता के रिकॉर्ड में कमरे की पहचान की जाती है. साथ ही, यह समय के साथ स्थिर होना चाहिए, ताकि इसे पिछली बुकिंग से जोड़ा जा सके. अगर roomName मौजूद है, तो यह फ़ील्ड मौजूद होना चाहिए. |
roomName |
यह उस कमरे का नाम है जहां सेवा उपलब्ध है. यह जानकारी देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले लोगों को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे लोग आसानी से समझ सकें. यह ओपेक आइडेंटिफ़ायर नहीं होना चाहिए. (ज़रूरी नहीं, लेकिन अगर roomId मौजूद है, तो ज़रूरी है) डाइनिंग की सुविधा के लिए, कमरे का नाम सिर्फ़ बैठने की जगहों के लिए इस्तेमाल किया जाना चाहिए. जैसे, बार या आँगन. इसका इस्तेमाल तय कीमत वाले मेन्यू, खास गतिविधियों या कमरे के अलावा किसी अन्य वैल्यू (जैसे, रिज़र्वेशन या डिनर) के लिए नहीं किया जाना चाहिए. हमारा सुझाव है कि डिफ़ॉल्ट सीटिंग एरिया से कोई कमरा जुड़ा हुआ न हो. |
partySize |
यह सिर्फ़ डाइनिंग के लिए लागू होता है: इस टाइम स्लॉट में, पार्टी में शामिल होने वाले लोगों की संख्या. किसी रेस्टोरेंट को एक ही समय के लिए कई स्लॉट से जोड़ा जा सकता है. हर स्लॉट में, पार्टी में शामिल लोगों की संख्या अलग-अलग हो सकती है. उदाहरण के लिए, अगर बुकिंग के साथ दो, तीन या चार लोगों को बैठाया जा सकता है. |
roomDescription |
ज़रूरी नहीं. चैट रूम की जानकारी, स्थानीय भाषा में. अगर यह विकल्प सेट किया जाता है, तो डिफ़ॉल्ट वैल्यू देना ज़रूरी है. कारोबारी या कंपनी के इलाके के हिसाब से, आम तौर पर इस्तेमाल होने वाली भाषाएं भी उपलब्ध कराएं. (ज़रूरी नहीं) |
बार-बार होने वाला
बार-बार होने वाले इवेंट के मैसेज भेजना ज़रूरी नहीं है. हालांकि, इससे उपलब्धता के स्लॉट को बार-बार दिखाने के बजाय, एक ही बार में दिखाया जा सकता है. ये आम तौर पर, एक दिन के वर्किंग शेड्यूल को दिखाते हैं. इसके बाद, ScheduleException मैसेज का इस्तेमाल, कामकाजी दिन के दौरान बुक की गई/उपलब्ध नहीं है, यह दिखाने के लिए किया जाता है.
ज़रूरतें:
- उपलब्धता स्लॉट या बार-बार होने वाली बुकिंग को बढ़ाने से, एक जैसे स्लॉट नहीं बनने चाहिए. अगर आईडी, startTime, अवधि, और संसाधन मेल खाते हैं, तो स्लॉट को एक जैसा माना जाता है.
- एक ही सेवा के स्लॉट में, उपलब्धता के स्टैंडर्ड फ़ॉर्मैट और बार-बार होने वाले स्लॉट को आपस में न मिलाएं. बार-बार होने वाली बुकिंग की सुविधा, उन कारोबारियों/सेवाओं के लिए फ़ायदेमंद होती है जो अपॉइंटमेंट की सुविधा देती हैं. स्टैंडर्ड फ़ॉर्मैट, उन कारोबारियों/सेवाओं के लिए बनाया गया है जो नियमित रूप से क्लास शेड्यूल करते हैं.
- दोहराए जाने वाले इवेंट की अवधि 24 घंटे से ज़्यादा नहीं होनी चाहिए.
| JSON के काेड में दिखाना |
|---|
{ "repeatUntil": string, "repeatEvery": string } |
| फ़ील्ड | |
|---|---|
repeatUntil |
यह यूटीसी टाइमस्टैंप, उपलब्धता के दोहराए जाने की आखिरी तारीख दिखाता है. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
repeatEvery |
इससे बुकिंग के लिए उपलब्ध लगातार दो टाइम स्लॉट के बीच का समय तय होता है. उदाहरण: अगर किसी उपलब्धता की अवधि 20 मिनट है, हर 30 मिनट में दोहराई जाती है, सुबह 9:00 बजे से शुरू होती है, और सुबह 11:00 बजे तक दोहराई जाती है, तो स्लॉट सुबह 9 से 9:20 बजे, सुबह 9:30 से 9:50 बजे, सुबह 10 से 10:20 बजे, सुबह 10:30 से 10:50 बजे, और सुबह 11 से 11:20 बजे तक उपलब्ध होंगे. (ज़रूरी) यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में ' |
ScheduleException
ScheduleException मैसेज, कामकाजी दिन के दौरान बुक की गई/उपलब्ध नहीं है, इस तरह की समय अवधि को दिखाते हैं. ये ऊपर बताई गई बार-बार होने वाली बुकिंग के अपवाद हैं. टाइम स्लॉट बुक होने पर, अपवादों की सूची को अपडेट किया जाना चाहिए, ताकि उसमें वे नई समयावधियां दिखें जिनके लिए बुकिंग नहीं की जा सकती. दोहराव की अवधि में बदलाव नहीं किया जाना चाहिए.
| JSON के काेड में दिखाना |
|---|
{
"timeRange": {
object ( |
| फ़ील्ड | |
|---|---|
timeRange |
अपवाद की समयसीमा. अगर कोई स्लॉट, बार-बार होने वाले इवेंट के लिए तय की गई इस समयावधि के साथ ओवरलैप करता है, तो उसे उपलब्ध नहीं माना जाएगा. उदाहरण: अगर बार-बार होने वाली किसी घटना की अवधि 20 मिनट, हर 30 मिनट में दोहराई जाने वाली घटना, शुरू होने का समय सुबह 9:00 बजे, और दोहराए जाने की आखिरी तारीख सुबह 11:00 बजे है, तो 9:45 बजे से 11:00 बजे तक की समयावधि वाली ScheduleException से, सुबह 9:30 बजे से 9:50 बजे, 10 बजे से 10:20 बजे, और 10:30 बजे से 10:50 बजे तक के स्लॉट उपलब्ध नहीं होंगे. ध्यान दें कि समयसीमा बंद-खुली होने की वजह से, सुबह 11 बजे से शुरू होने वाले स्लॉट पर कोई असर नहीं पड़ेगा. |
पूर्व-भुगतान
यह वह पेमेंट है जो उपयोगकर्ता से बुकिंग के दौरान लिया जा सकता है.
| JSON के काेड में दिखाना |
|---|
{
"priceInfo": {
object ( |
| फ़ील्ड | |
|---|---|
priceInfo |
कीमत की जानकारी के लिए कंटेनर. |
PriceInfo
कीमत की जानकारी के लिए कंटेनर.
| JSON के काेड में दिखाना |
|---|
{ "priceType": enum ( |
| फ़ील्ड | |
|---|---|
priceType |
इससे तय होता है कि किराया या किराये की सीमा कैसे लागू होती है (हर व्यक्ति के हिसाब से या तय) |
यूनियन फ़ील्ड price_options. कीमत के विकल्पों में, सटीक कीमत या कीमत सीमा बताई जाती है. price_options इनमें से सिर्फ़ एक हो सकता है: |
|
price |
किसी सेवा या शुल्क की कीमत. |
priceRange |
किसी सेवा या शुल्क की ऊपरी और/या निचली सीमा. |
PriceRange
यह मॉनेटरी वैल्यू की रेंज के लिए रैपर है. जब तक दोनों वैल्यू सेट नहीं की जाती हैं, तब तक इसे असीमित माना जाता है. कम से कम minAmount और maxAmount में से किसी एक का होना ज़रूरी है.
| JSON के काेड में दिखाना |
|---|
{ "minPrice": { object ( |
| फ़ील्ड | |
|---|---|
minPrice |
कम से कम इतनी रकम. |
maxPrice |
ज़्यादा से ज़्यादा रकम. यह हमेशा minPrice से ज़्यादा होनी चाहिए. |
DurationRequirement
इस enum से पता चलता है कि उपयोगकर्ता को अनुरोध किए गए स्लॉट की अवधि/खत्म होने का समय देखने या इसकी पुष्टि करने के लिए, कौनसी ज़रूरी शर्तें पूरी करनी होंगी.
| Enums | |
|---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
खत्म होने के समय के बारे में नहीं बताया गया है. यह डिफ़ॉल्ट रूप से होता है. |
DO_NOT_SHOW_DURATION |
उपयोगकर्ता को खत्म होने का समय नहीं दिखता. |
MUST_SHOW_DURATION |
अपॉइंटमेंट बुक करने से पहले, उपयोगकर्ता को अपॉइंटमेंट खत्म होने का समय दिखाना ज़रूरी है. |
SchedulingRuleOverrides
उपलब्धता के लेवल के हिसाब से शेड्यूल करने के नियम.
| JSON के काेड में दिखाना |
|---|
{ "lastBookableSec": string, "firstBookableSec": string, "lastOnlineCancellableSec": string } |
| फ़ील्ड | |
|---|---|
lastBookableSec |
यह स्लॉट पिछली बार कितने सेकंड पहले बुक किया गया था. यह टाइमस्टैंप, स्लॉट के startSec से पहले का होना चाहिए, ताकि इसका पालन किया जा सके. अगर उपयोगकर्ताओं को शुरू होने के समय के बाद बुकिंग करने की अनुमति देनी है, तो सेवा के स्तर पर SchedulingRules.min_booking_before_end_time का इस्तेमाल करें. अगर यह मौजूद है, तो यह उस सेवा की SchedulingRules के min_booking_buffer में बताई गई किसी भी जानकारी को बदल देगा. |
firstBookableSec |
यह स्लॉट पहली बार कितने सेकंड में बुक किया जा सकता है. यह टाइमस्टैंप, स्लॉट के startSec से पहले का होना चाहिए. अगर lastBookableSec तय किया गया है, तो यह टाइमस्टैंप उससे पहले का होना चाहिए. |
lastOnlineCancellableSec |
अगर यह सेट है, तो यह उस आखिरी समय (यूनिक्स इपोक के बाद से सेकंड में) को दिखाता है जब Reserve with Google के ज़रिए इस अपॉइंटमेंट स्लॉट को रद्द किया जा सकता है. इस फ़ील्ड की वैल्यू, सेवा के लेवल पर लागू होने वाले रद्द करने के नियमों को बदल देगी. (ज़रूरी नहीं) |
ConfirmationMode
बुकिंग की उपलब्धता की पुष्टि करने के लिए इस्तेमाल किए गए मोड.
| Enums | |
|---|---|
CONFIRMATION_MODE_UNSPECIFIED |
पुष्टि करने का तरीका नहीं बताया गया था. पुष्टि करने के लिए, सिंक्रोनस तरीके का इस्तेमाल किया जाएगा. |
CONFIRMATION_MODE_SYNCHRONOUS |
उपलब्धता के इस समय के लिए की गई बुकिंग की पुष्टि एक साथ की जाएगी. |
CONFIRMATION_MODE_ASYNCHRONOUS |
उपलब्धता के इस विकल्प के लिए की गई बुकिंग की पुष्टि एसिंक्रोनस तरीके से की जाएगी. |
LinkoutRequiredReason
किसी स्लॉट में लिंकआउट की सुविधा उपलब्ध होने की वजह.
| Enums | |
|---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू: इसका इस्तेमाल न करें. इसका मतलब है कि जानकारी मौजूद नहीं है. |
PAYMENT_REQUIRED |
स्लॉट बुक करने के लिए, पार्टनर प्लैटफ़ॉर्म पर पेमेंट करना होगा. |
तरीके |
|
|---|---|
|
यह फ़ंक्शन, एग्रीगेटर के मैनेज किए जा रहे कारोबारी या कंपनी के मौजूदा Service के Availability को बदलता है और उसे दिखाता है. |