इंडेक्स
Date
(मैसेज)DayOfWeek
(enum)Interval
(मैसेज)PhoneNumber
(मैसेज)PhoneNumber.ShortCode
(मैसेज)PostalAddress
(मैसेज)TimeOfDay
(मैसेज)TimeZone
(मैसेज)
तारीख
पूरी या आंशिक तारीख को दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन कहीं और बताए गए हैं या अहम नहीं हैं. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से है. यह इनमें से कोई एक चीज़ हो सकती है:
- पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य के अलावा किसी अन्य वैल्यू के तौर पर शामिल हों.
- कोई महीना और दिन, जिसमें शून्य साल लिखा हो. जैसे, सालगिरह.
- अपने आप में एक वर्ष, एक शून्य महीना और एक शून्य दिन.
- साल और महीना, जिसमें दिन की तारीख भी शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.
मिलते-जुलते टाइप:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
फ़ील्ड | |
---|---|
year |
तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए. |
month |
साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए. |
day |
महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, यह साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए. |
DayOfWeek
यह हफ़्ते का कोई दिन दिखाता है.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
हफ़्ते के दिन की जानकारी नहीं दी गई है. |
MONDAY |
सोमवार |
TUESDAY |
मंगलवार |
WEDNESDAY |
बुधवार |
THURSDAY |
गुरुवार |
FRIDAY |
शुक्रवार |
SATURDAY |
शनिवार |
SUNDAY |
रविवार |
इंटरवल
यह एक टाइम इंटरवल के बारे में बताता है. इसे टाइमस्टैंप शुरू होने के समय और टाइमस्टैंप के आखिर (खास) के तौर पर एन्कोड किया जाता है.
प्रारंभ का समय अंत से कम या उसके बराबर होना चाहिए. जब शुरुआत का समय अंत के बराबर होता है, तो इंटरवल खाली होता है (कोई समय नहीं मेल खाता). जब शुरू और खत्म होने का समय तय नहीं होता है, तब इंटरवल किसी भी समय मेल खाता है.
फ़ील्ड | |
---|---|
start_time |
ज़रूरी नहीं. इंटरवल की शुरुआत सभी को शामिल करके. अगर तय किया गया हो, तो इस इंटरवल से मेल खाने वाला टाइमस्टैंप एक जैसा होना चाहिए या शुरू के बाद का होना चाहिए. |
end_time |
ज़रूरी नहीं. इंटरवल का खास खत्म होना. अगर तय किया गया है, तो इस इंटरवल से मेल खाने वाला टाइमस्टैंप, खत्म होने से पहले होना चाहिए. |
PhoneNumber
फ़ोन नंबर दिखाने वाला ऑब्जेक्ट, जो एपीआई वायर फ़ॉर्मैट के तौर पर काम करता है.
यह कॉन्टेंट:
फ़ोन नंबर की स्थान-भाषा के हिसाब से फ़ॉर्मैटिंग के लिए इस्तेमाल नहीं किया जाना चाहिए, जैसे कि "+1 (650) 253-0000 एक्सटेंशन 123"
इसे बेहतर स्टोरेज के लिए डिज़ाइन नहीं किया गया है
- डायल करने के लिए उपयुक्त नहीं हो सकता है - विशेष लाइब्रेरी (संदर्भ देखें) का उपयोग उस उद्देश्य के लिए नंबर पार्स करने के लिए किया जाना चाहिए
इस संख्या से जुड़ा कोई काम करने के लिए, पहले इसे i18n.phonenumbers.PhoneNumber
ऑब्जेक्ट में बदलें.
उदाहरण के लिए, Java में यह होगा:
com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }
रेफ़रंस: - https://github.com/google/libphonenumber
फ़ील्ड | |
---|---|
extension |
फ़ोन नंबर का एक्सटेंशन. ITU सुझावों में एक्सटेंशन मानक नहीं है, लेकिन इसे 40 अंकों की अधिकतम लंबाई वाली संख्याओं की शृंखला के रूप में परिभाषित किया गया है. अंकों के अलावा, कुछ अन्य डायलिंग वर्ण यहां सेव किए जा सकते हैं, जैसे कि ',' (इंतज़ार का संकेत देने वाला) या '#'. ध्यान दें कि फ़िलहाल किसी भी इलाके में शॉर्ट कोड वाले एक्सटेंशन का इस्तेमाल नहीं किया जाता. इसलिए, आम तौर पर यह फ़ील्ड सिर्फ़ E.164 नंबर के साथ सेट किया जाता है. इस नंबर को E.164 नंबर से अलग रखा जाता है, ताकि आने वाले समय में छोटे कोड एक्सटेंशन इस्तेमाल किए जा सकें. |
यूनियन फ़ील्ड kind . ज़रूरी है. कोई सामान्य संख्या या छोटा कोड. आने वाले समय में, इनमें से किसी फ़ील्ड में नए फ़ील्ड जोड़े जा सकते हैं. इसलिए, क्लाइंट को ऐसे फ़ोन नंबर नज़रअंदाज़ करने चाहिए जिनके लिए उन्हें कोड किया गया कोई भी फ़ील्ड सेट न हो. kind इनमें से सिर्फ़ एक हो सकता है: |
|
e164_number |
फ़ोन नंबर को लीडिंग प्लस के निशान ('+') के तौर पर दिखाया जाता है. इसके बाद, एक आरामदेह आईटीयू E.164 फ़ॉर्मैट का इस्तेमाल किया जाता है. इसमें देश का कॉल कोड (1 से 3 अंक) और सदस्य का नंबर मौजूद होता है. इसमें कोई अतिरिक्त स्पेस या फ़ॉर्मैट नहीं होता, जैसे कि: - सही: "+15552220123" - गलत: "+1 (555) 222-01234 x123". ITU E.164 फ़ॉर्मैट में बाद वाले अंक को 12 अंकों तक सीमित किया गया है, लेकिन व्यावहारिक तौर पर सभी देश इसका ध्यान नहीं रखते हैं. इसलिए, हम यहां इस पाबंदी को हटा देते हैं. सिर्फ़ राष्ट्रीय स्तर के नंबरों की अनुमति नहीं है. रेफ़रंस: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes |
short_code |
छोटा कोड. रेफ़रंस: - https://en.wikipedia.org/wiki/Short_code |
ShortCode
छोटा कोड दिखाने वाला ऑब्जेक्ट.यह ऐसा फ़ोन नंबर होता है जो आम तौर पर सामान्य फ़ोन नंबर से काफ़ी छोटा होता है. इसका इस्तेमाल मल्टीमीडिया मैसेज (एमएमएस) और एसएमएस सिस्टम में मैसेज के जवाब देने के लिए किया जा सकता है. साथ ही, शॉर्ट कोड डायल करने के लिए भी इसका इस्तेमाल किया जा सकता है (जैसे, "आपका प्लान में कितने मिनट बचे हैं" मैसेज 611).
छोटे कोड किसी इलाके के लिए ही इस्तेमाल किए जा सकते हैं. साथ ही, इन्हें अंतरराष्ट्रीय स्तर पर डायल नहीं किया जा सकता. इसका मतलब है कि एक ही शॉर्ट कोड, अलग-अलग इलाकों में अलग-अलग इस्तेमाल और शुल्क के साथ मौजूद हो सकता है. भले ही, उन सभी क्षेत्रों में एक ही देश का कॉलिंग कोड मौजूद हो, जैसे कि अमेरिका और कनाडा.
फ़ील्ड | |
---|---|
region_code |
ज़रूरी है. उस जगह का BCP-47 क्षेत्र कोड जहां इस छोटे कोड पर कॉल किए जा सकते हैं, जैसे कि "US" और "BB". रेफ़रंस: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
ज़रूरी है. ऐसे छोटे कोड अंक जिनकी शुरुआत में प्लस ('+') या देश का नंबर नहीं है, जैसे कि "611". |
PostalAddress
यह डाक पते को दिखाता है, जैसे कि डाक डिलीवरी या पेमेंट के पते. डाक पता होने पर, डाक सेवा किसी कंपनी, पीओ बॉक्स या इसी तरह की किसी जगह पर आइटम डिलीवर कर सकती है. यह भौगोलिक जगहों (सड़कों, कस्बों, पहाड़ों) को मॉडल करने के लिए नहीं बना है.
सामान्य इस्तेमाल में, उपयोगकर्ता के इनपुट के ज़रिए या मौजूदा डेटा को इंपोर्ट करके पता बनाया जाएगा. यह इस बात पर निर्भर करता है कि प्रोसेस किस तरह की है.
पता इनपुट / बदलाव करने के बारे में सलाह: - अंतरराष्ट्रीय मानकों के मुताबिक पता विजेट का इस्तेमाल करें, जैसे कि https://github.com/google/libaddressinput) - उपयोगकर्ताओं को उन देशों के बाहर फ़ील्ड में इनपुट या बदलाव करने के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट नहीं पेश किए जाने चाहिए जहां इस फ़ील्ड का इस्तेमाल किया जाता है.
इस स्कीमा का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, कृपया यहां देखें: https://support.google.com/business/answer/6397478
फ़ील्ड | |
---|---|
revision |
सभी नए संशोधन पुराने संशोधनों के साथ पुराने रूप से संगत होने चाहिए. |
region_code |
ज़रूरी है. पते के देश/इलाके का CLDR इलाके का कोड. इसका कभी भी अनुमान नहीं लगाया जाता और यह उपयोगकर्ता पर निर्भर करता है कि वैल्यू सही है या नहीं. ज़्यादा जानकारी के लिए, https://cldr.unicode.org/ और https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html पर जाएं. उदाहरण: स्विट्ज़रलैंड के लिए "CH". |
language_code |
ज़रूरी नहीं. इस पते के कॉन्टेंट का BCP-47 भाषा कोड (अगर पता है). यह आम तौर पर इनपुट फ़ॉर्म की यूज़र इंटरफ़ेस (यूआई) भाषा होती है. इसके अलावा, ऐसा हो सकता है कि यह पता, देश/इलाके के लिए इस्तेमाल होने वाली किसी भाषा या उनकी ट्रांसलिट्रेट की गई भाषा से मेल खाती हो. इसका असर कुछ देशों में फ़ॉर्मैट पर पड़ सकता है. हालांकि, यह डेटा के सही होने के लिए ज़रूरी नहीं है. साथ ही, इससे कभी भी किसी पुष्टि या बिना फ़ॉर्मैट वाली अन्य कार्रवाइयों पर कोई असर नहीं पड़ेगा. अगर यह वैल्यू मौजूद नहीं है, तो गलत डिफ़ॉल्ट वैल्यू तय करने के बजाय, इसे हटा देना चाहिए. उदाहरण: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
ज़रूरी नहीं. पते का पिन कोड. सभी देशों के लिए पिन कोड मौजूद नहीं होते या उनका इस्तेमाल करना ज़रूरी नहीं होता. हालांकि, जहां इनका इस्तेमाल किया जाता है वहां पते के अन्य हिस्सों की मदद से, अतिरिक्त पुष्टि ट्रिगर की जा सकती है. जैसे, अमेरिका में राज्य/ज़िप कोड. |
sorting_code |
ज़रूरी नहीं. अतिरिक्त, देश के हिसाब से, क्रम से लगाने के लिए कोड. ज़्यादातर इलाकों में इसका इस्तेमाल नहीं किया जाता. जहां इसका इस्तेमाल किया जाता है, वहां वैल्यू या तो "CEDEX" जैसी कोई स्ट्रिंग होती है. इसके बाद, कोई संख्या (जैसे, "CEDEX 7") या सिर्फ़ एक नंबर होता है. यह "sector कोड" (जमैका) या "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (जैसे, आइवरी कोस्ट) को दिखाता है. |
administrative_area |
ज़रूरी नहीं. राज्य का सबसे बड़ा सबडिविज़न, जिसका इस्तेमाल किसी देश या इलाके के डाक पतों के लिए किया जाता है. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है, न कि स्वायत्त समुदाय (उदाहरण के लिए, "बार्सीलोना", न कि "कैटलोनिया"). कई देश डाक पतों में राज्य का इस्तेमाल नहीं करते. उदाहरण के लिए, स्विट्ज़रलैंड में इस पते पर कोई जनसंख्या नहीं होनी चाहिए. |
locality |
ज़रूरी नहीं. आम तौर पर, यह पते में शहर/कस्बे वाले हिस्से का होता है. उदाहरण: यूएस शहर, आईटी कम्यून, यूके पोस्ट टाउन. दुनिया के उन क्षेत्रों में, जहां क्षेत्र अच्छी तरह से परिभाषित नहीं हैं या इस संरचना में ठीक से फ़िट नहीं होते हैं, क्षेत्र को खाली छोड़ दें और address_lines का उपयोग करें. |
sublocality |
ज़रूरी नहीं. पते का मोहल्ला. उदाहरण के लिए, इसमें आस-पड़ोस, नगर, ज़िला हो सकते हैं. |
address_lines[] |
पते के निचले लेवल के बारे में बताने वाली अव्यवस्थित पता पंक्तियां. Address_lines में वैल्यू के टाइप की जानकारी नहीं होती है.साथ ही, कभी-कभी एक फ़ील्ड में एक से ज़्यादा वैल्यू हो सकती हैं (जैसे, "Austin, TX"). इसलिए, यह ज़रूरी है कि लाइन का क्रम साफ़ हो. पते की लाइनों का क्रम, "लिफ़ाफ़े का क्रम" होना चाहिए. यह क्रम, पते में दिए गए देश/इलाके के हिसाब से होना चाहिए. जिन जगहों पर यह अलग-अलग हो सकता है वहां (जैसे, जापान), address_language का इस्तेमाल उसे साफ़ तौर पर दिखाने के लिए किया जाता है. जैसे, बड़े से छोटे क्रम के लिए "ja" और छोटे से बड़े क्रम के लिए "ja-Latn" या "en". इस तरह, भाषा के आधार पर किसी पते की सबसे सटीक लाइन चुनी जा सकती है. किसी पते की कम से कम जितनी जानकारी की अनुमति दी गई है, उसमें क्षेत्र का कोड शामिल होता है. साथ ही, इसमें बची हुई सारी जानकारी address_lines में सेव की जाती है. इस तरह के पते को तकरीबन जियोकोडिंग के बिना भी फ़ॉर्मैट किया जा सकता है, लेकिन पते के किसी भी कॉम्पोनेंट के बारे में तब तक सिमैंटिक रीज़निंग के बारे में नहीं बताया जा सकता, जब तक कि यह पूरी तरह से आंशिक रूप से हल न हो जाए. क्षेत्र का कोड और address_lines के साथ एक ऐसा पता बनाएं. इसके बाद, पूरी तरह से स्ट्रक्चर नहीं किए गए पतों को मैनेज करने के लिए, जियोकोडिंग तरीका इस्तेमाल करने का सुझाव दिया जाता है. यह अनुमान लगाने के बजाय कि पते के कौनसे हिस्से, इलाके या प्रशासनिक इलाके होने चाहिए. |
recipients[] |
ज़रूरी नहीं. कारोबार के पते पर मौजूद व्यक्ति. कुछ मामलों में, इस फ़ील्ड में मल्टीलाइन जानकारी शामिल हो सकती है. उदाहरण के लिए, इसमें "केयर ऑफ़" से जुड़ी जानकारी हो सकती है. |
organization |
ज़रूरी नहीं. पते पर संगठन का नाम. |
TimeOfDay
दिन का कोई समय दिखाता है. तारीख और टाइम ज़ोन कोई खास नहीं है या उन्हें कहीं और बताया गया है. एपीआई, लीप सेकंड को अनुमति देने का विकल्प चुन सकता है. इससे मिलते-जुलते टाइप google.type.Date
और google.protobuf.Timestamp
हैं.
फ़ील्ड | |
---|---|
hours |
24 घंटे के फ़ॉर्मैट में, दिन के घंटे. यह 0 से 23 के बीच होना चाहिए. एपीआई, कारोबार के बंद होने के समय जैसी स्थितियों के लिए, वैल्यू के तौर पर "24:00:00" का इस्तेमाल करने की अनुमति दे सकता है. |
minutes |
दिन के घंटे के मिनट. वैल्यू 0 से 59 के बीच होनी चाहिए. |
seconds |
समय के मिनट के सेकंड. आम तौर पर, यह संख्या 0 से 59 के बीच होनी चाहिए. अगर एपीआई, लीप-सेकंड की अनुमति देता है, तो हो सकता है कि एपीआई वैल्यू 60 को अनुमति दे. |
nanos |
नैनोसेकंड में सेकंड के फ़्रैक्शन. यह 0 से 9,99,99,99,999 के बीच होना चाहिए. |
TimeZone
IANA टाइम ज़ोन डेटाबेस से किसी टाइम ज़ोन को दिखाता है.
फ़ील्ड | |
---|---|
id |
IANA टाइम ज़ोन डेटाबेस का टाइम ज़ोन, जैसे कि "अमेरिका/New_York". |
version |
ज़रूरी नहीं. आईएएनए टाइम ज़ोन डेटाबेस का वर्शन नंबर, जैसे कि "2019a". |