किसी कारोबार से जुड़ी जानकारी इकट्ठा करना.
जेएसओएन के काेड में दिखाना |
---|
{ "name": string, "address": { object ( |
फ़ील्ड | |
---|---|
name |
आइडेंटिफ़ायर. कारोबार की जानकारी के संसाधन का नाम. फ़ॉर्मैट: |
address |
ज़रूरी नहीं. कारोबार का पता. |
phone |
ज़रूरी नहीं. कारोबार का फ़ोन नंबर. |
phoneVerificationState |
सिर्फ़ आउटपुट के लिए. कारोबार के लिए फ़ोन नंबर की मदद से पुष्टि की स्थिति. |
customerService |
ज़रूरी नहीं. कारोबार की ग्राहक सेवा. |
PostalAddress
यह डाक पते को दिखाता है, जैसे कि डाक डिलीवरी या पेमेंट के पते. डाक पता होने पर, डाक सेवा किसी कंपनी, पीओ बॉक्स या इसी तरह की किसी जगह पर आइटम डिलीवर कर सकती है. यह भौगोलिक जगहों (सड़कों, कस्बों, पहाड़ों) को मॉडल करने के लिए नहीं बना है.
सामान्य इस्तेमाल में, उपयोगकर्ता के इनपुट के ज़रिए या मौजूदा डेटा को इंपोर्ट करके पता बनाया जाएगा. यह इस बात पर निर्भर करता है कि प्रोसेस किस तरह की है.
पता इनपुट / बदलाव करने के बारे में सलाह: - अंतरराष्ट्रीय मानकों के मुताबिक पता विजेट का इस्तेमाल करें, जैसे कि https://github.com/google/libaddressinput) - उपयोगकर्ताओं को उन देशों के बाहर फ़ील्ड में इनपुट या बदलाव करने के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट नहीं पेश किए जाने चाहिए जहां इस फ़ील्ड का इस्तेमाल किया जाता है.
इस स्कीमा का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, कृपया यहां देखें: https://support.google.com/business/answer/6397478
जेएसओएन के काेड में दिखाना |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
फ़ील्ड | |
---|---|
revision |
सभी नए संशोधन पुराने संशोधनों के साथ पुराने रूप से संगत होने चाहिए. |
regionCode |
ज़रूरी है. पते के देश/इलाके का CLDR इलाके का कोड. इसका कभी भी अनुमान नहीं लगाया जाता और यह उपयोगकर्ता पर निर्भर करता है कि वैल्यू सही है या नहीं. ज़्यादा जानकारी के लिए, https://cldr.unicode.org/ और https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html पर जाएं. उदाहरण: स्विट्ज़रलैंड के लिए "CH". |
languageCode |
ज़रूरी नहीं. इस पते के कॉन्टेंट का BCP-47 भाषा कोड (अगर पता है). यह आम तौर पर इनपुट फ़ॉर्म की यूज़र इंटरफ़ेस (यूआई) भाषा होती है. इसके अलावा, ऐसा हो सकता है कि यह पता, देश/इलाके के लिए इस्तेमाल होने वाली किसी भाषा या उनकी ट्रांसलिट्रेट की गई भाषा से मेल खाती हो. इसका असर कुछ देशों में फ़ॉर्मैट पर पड़ सकता है. हालांकि, यह डेटा के सही होने के लिए ज़रूरी नहीं है. साथ ही, इससे कभी भी किसी पुष्टि या बिना फ़ॉर्मैट वाली अन्य कार्रवाइयों पर कोई असर नहीं पड़ेगा. अगर यह वैल्यू मौजूद नहीं है, तो गलत डिफ़ॉल्ट वैल्यू तय करने के बजाय, इसे हटा देना चाहिए. उदाहरण: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
ज़रूरी नहीं. पते का पिन कोड. सभी देशों के लिए पिन कोड मौजूद नहीं होते या उनका इस्तेमाल करना ज़रूरी नहीं होता. हालांकि, जहां इनका इस्तेमाल किया जाता है वहां पते के अन्य हिस्सों की मदद से, अतिरिक्त पुष्टि ट्रिगर की जा सकती है. जैसे, अमेरिका में राज्य/ज़िप कोड. |
sortingCode |
ज़रूरी नहीं. अतिरिक्त, देश के हिसाब से, क्रम से लगाने के लिए कोड. ज़्यादातर इलाकों में इसका इस्तेमाल नहीं किया जाता. जहां इसका इस्तेमाल किया जाता है, वहां वैल्यू या तो "CEDEX" जैसी कोई स्ट्रिंग होती है. इसके बाद, कोई संख्या (जैसे, "CEDEX 7") या सिर्फ़ एक नंबर होता है. यह "sector कोड" (जमैका) या "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (जैसे, आइवरी कोस्ट) को दिखाता है. |
administrativeArea |
ज़रूरी नहीं. राज्य का सबसे बड़ा सबडिविज़न, जिसका इस्तेमाल किसी देश या इलाके के डाक पतों के लिए किया जाता है. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है, न कि स्वायत्त समुदाय (उदाहरण के लिए, "बार्सीलोना", न कि "कैटलोनिया"). कई देश डाक पतों में राज्य का इस्तेमाल नहीं करते. उदाहरण के लिए, स्विट्ज़रलैंड में इस पते पर कोई जनसंख्या नहीं होनी चाहिए. |
locality |
ज़रूरी नहीं. आम तौर पर, यह पते में शहर/कस्बे वाले हिस्से का होता है. उदाहरण: यूएस शहर, आईटी कम्यून, यूके पोस्ट टाउन. दुनिया के उन क्षेत्रों में, जहां क्षेत्र अच्छी तरह से परिभाषित नहीं हैं या इस संरचना में ठीक से फ़िट नहीं होते हैं, मोहल्ले को खाली छोड़ दें और पता रेखाओं का उपयोग करें. |
sublocality |
ज़रूरी नहीं. पते का मोहल्ला. उदाहरण के लिए, इसमें आस-पड़ोस, नगर, ज़िला हो सकते हैं. |
addressLines[] |
पते के निचले लेवल के बारे में बताने वाली अव्यवस्थित पता पंक्तियां. पता लाइनों में मौजूद वैल्यू में टाइप की जानकारी नहीं होती. साथ ही, कभी-कभी एक ही फ़ील्ड में एक से ज़्यादा वैल्यू हो सकती हैं (जैसे, "ऑस्टिन, टेक्सस"), इसलिए यह ज़रूरी है कि लाइन का क्रम साफ़ हो. पते की लाइनों का क्रम, "लिफ़ाफ़े का क्रम" होना चाहिए. यह क्रम, पते में दिए गए देश/इलाके के हिसाब से होना चाहिए. जिन जगहों पर यह अलग-अलग हो सकता है वहां (जैसे, जापान), address_language का इस्तेमाल उसे साफ़ तौर पर दिखाने के लिए किया जाता है. जैसे, बड़े से छोटे क्रम के लिए "ja" और छोटे से बड़े क्रम के लिए "ja-Latn" या "en". इस तरह, भाषा के आधार पर किसी पते की सबसे सटीक लाइन चुनी जा सकती है. किसी पते को कम से कम जितनी जानकारी के लिए अनुमति दी जाती है उसमें क्षेत्र का कोड शामिल होता है. इसमें, बची हुई सारी जानकारी पता लाइनों में डाली जाती है. इस तरह के पते को तकरीबन जियोकोडिंग के बिना भी फ़ॉर्मैट किया जा सकता है, लेकिन पते के किसी भी कॉम्पोनेंट के बारे में तब तक सिमैंटिक रीज़निंग के बारे में नहीं बताया जा सकता, जब तक कि यह पूरी तरह से आंशिक रूप से हल न हो जाए. सिर्फ़ RegionCode और addressLines वाला पता बनाने और फिर पूरी तरह से स्ट्रक्चर नहीं किए गए पतों को मैनेज करने के लिए, जियोकोडिंग तरीका इस्तेमाल करने का सुझाव दिया जाता है. इससे यह अनुमान नहीं लगाया जा सकता कि पते के कौनसे हिस्से, इलाके या प्रशासनिक इलाके होने चाहिए. |
recipients[] |
ज़रूरी नहीं. कारोबार के पते पर मौजूद व्यक्ति. कुछ मामलों में, इस फ़ील्ड में मल्टीलाइन जानकारी शामिल हो सकती है. उदाहरण के लिए, इसमें "केयर ऑफ़" से जुड़ी जानकारी हो सकती है. |
organization |
ज़रूरी नहीं. पते पर संगठन का नाम. |
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": string, // Union field |
फ़ील्ड | |
---|---|
extension |
फ़ोन नंबर का एक्सटेंशन. ITU सुझावों में एक्सटेंशन मानक नहीं है, लेकिन इसे 40 अंकों की अधिकतम लंबाई वाली संख्याओं की शृंखला के रूप में परिभाषित किया गया है. अंकों के अलावा, कुछ अन्य डायलिंग वर्ण यहां सेव किए जा सकते हैं, जैसे कि ',' (इंतज़ार का संकेत देने वाला) या '#'. ध्यान दें कि फ़िलहाल किसी भी इलाके में शॉर्ट कोड वाले एक्सटेंशन का इस्तेमाल नहीं किया जाता. इसलिए, आम तौर पर यह फ़ील्ड सिर्फ़ E.164 नंबर के साथ सेट किया जाता है. इस नंबर को E.164 नंबर से अलग रखा जाता है, ताकि आने वाले समय में छोटे कोड एक्सटेंशन इस्तेमाल किए जा सकें. |
यूनियन फ़ील्ड kind . ज़रूरी है. कोई सामान्य संख्या या छोटा कोड. आने वाले समय में, इनमें से किसी फ़ील्ड में नए फ़ील्ड जोड़े जा सकते हैं. इसलिए, क्लाइंट को ऐसे फ़ोन नंबर नज़रअंदाज़ करने चाहिए जिनके लिए उन्हें कोड किया गया कोई भी फ़ील्ड सेट न हो. kind इनमें से सिर्फ़ एक हो सकता है: |
|
e164Number |
फ़ोन नंबर को लीडिंग प्लस के निशान ('+') के तौर पर दिखाया जाता है. इसके बाद, एक आरामदेह आईटीयू 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 |
shortCode |
छोटा कोड. रेफ़रंस: - https://en.wikipedia.org/wiki/Short_code |
ShortCode
छोटा कोड दिखाने वाला ऑब्जेक्ट.यह ऐसा फ़ोन नंबर होता है जो आम तौर पर सामान्य फ़ोन नंबर से काफ़ी छोटा होता है. इसका इस्तेमाल मल्टीमीडिया मैसेज (एमएमएस) और एसएमएस सिस्टम में मैसेज के जवाब देने के लिए किया जा सकता है. साथ ही, शॉर्ट कोड डायल करने के लिए भी इसका इस्तेमाल किया जा सकता है (जैसे, "आपका प्लान में कितने मिनट बचे हैं" मैसेज 611).
छोटे कोड किसी इलाके के लिए ही इस्तेमाल किए जा सकते हैं. साथ ही, इन्हें अंतरराष्ट्रीय स्तर पर डायल नहीं किया जा सकता. इसका मतलब है कि एक ही शॉर्ट कोड, अलग-अलग इलाकों में अलग-अलग इस्तेमाल और शुल्क के साथ मौजूद हो सकता है. भले ही, उन सभी क्षेत्रों में एक ही देश का कॉलिंग कोड मौजूद हो, जैसे कि अमेरिका और कनाडा.
जेएसओएन के काेड में दिखाना |
---|
{ "regionCode": string, "number": string } |
फ़ील्ड | |
---|---|
regionCode |
ज़रूरी है. उस जगह का BCP-47 क्षेत्र कोड जहां इस छोटे कोड पर कॉल किए जा सकते हैं, जैसे कि "US" और "BB". रेफ़रंस: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
ज़रूरी है. ऐसे छोटे कोड अंक जिनकी शुरुआत में प्लस ('+') या देश का नंबर नहीं है, जैसे कि "611". |
PhoneVerificationState
फ़ोन नंबर की मदद से पुष्टि की स्थिति.
Enums | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है. |
PHONE_VERIFICATION_STATE_VERIFIED |
फ़ोन नंबर की पुष्टि हो चुकी है. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
फ़ोन की पुष्टि नहीं हुई है |
CustomerService
ग्राहक सेवा की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{
"uri": string,
"email": string,
"phone": {
object ( |
फ़ील्ड | |
---|---|
uri |
ज़रूरी नहीं. वह यूआरआई जहां ग्राहक सेवा मिल सकती है. |
email |
ज़रूरी नहीं. वह ईमेल पता जिस पर ग्राहक सेवा से संपर्क किया जा सकता है. |
phone |
ज़रूरी नहीं. वह फ़ोन नंबर जिस पर ग्राहक सेवा को कॉल किया जा सकता है. |