किसी कारोबार से जुड़ी जानकारी इकट्ठा करना.
JSON के काेड में दिखाना |
---|
{ "name": string, "address": { object ( |
फ़ील्ड | |
---|---|
name |
आइडेंटिफ़ायर. कारोबार की जानकारी के लिए, संसाधन का नाम. फ़ॉर्मैट: |
address |
ज़रूरी नहीं. कारोबार का पता. |
phone |
सिर्फ़ आउटपुट के लिए. कारोबार का फ़ोन नंबर. |
phoneVerificationState |
सिर्फ़ आउटपुट के लिए. कारोबार के लिए फ़ोन नंबर की मदद से पुष्टि की स्थिति. |
customerService |
ज़रूरी नहीं. कारोबार की ग्राहक सेवा. |
PostalAddress
यह किसी डाक पते को दिखाता है, जैसे कि डाक डिलीवरी या पेमेंट के पतों के लिए. डाक पता होने पर, डाक सेवा, पी.ओ. Box या उससे मिलता-जुलता. यह भौगोलिक जगहों (सड़कों, कस्बों, पहाड़ों) को मॉडल करने के लिए नहीं बना है.
सामान्य इस्तेमाल में, उपयोगकर्ता के इनपुट के ज़रिए या मौजूदा डेटा को इंपोर्ट करके पता बनाया जाएगा. यह इस बात पर निर्भर करता है कि प्रोसेस किस तरह की है.
पता इनपुट / बदलाव करने के बारे में सलाह: - अंतरराष्ट्रीय मानकों के मुताबिक पता विजेट का इस्तेमाल करें, जैसे कि https://github.com/google/libaddressinput) - उपयोगकर्ताओं को उन देशों के बाहर फ़ील्ड में इनपुट या बदलाव करने के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट नहीं दिखाना चाहिए जहां इस फ़ील्ड का इस्तेमाल किया जाता है.
इस स्कीमा का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, कृपया यहां देखें: https://support.google.com/business/answer/6397478
JSON के काेड में दिखाना |
---|
{ "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 code" को दिखाता है (जमैका), "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (उदाहरण के लिए आइवरी कोस्ट). |
administrativeArea |
ज़रूरी नहीं. राज्य का सबसे बड़ा सबडिविज़न, जिसका इस्तेमाल किसी देश या इलाके के डाक पतों के लिए किया जाता है. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है, न कि स्वायत्त समुदाय (उदाहरण के लिए, "बार्सीलोना", न कि "कैटलोनिया"). कई देश डाक पतों में राज्य का इस्तेमाल नहीं करते. उदाहरण के लिए, अगर कोई व्यक्ति आता है, तो इसे खाली छोड़ देना चाहिए. |
locality |
ज़रूरी नहीं. आम तौर पर, यह पते में शहर/कस्बे वाले हिस्से का होता है. उदाहरण: यूएस शहर, आईटी कम्यून, यूके पोस्ट टाउन. दुनिया के उन क्षेत्रों में, जहां क्षेत्र अच्छी तरह से परिभाषित नहीं हैं या इस संरचना में ठीक से फ़िट नहीं होते हैं, मोहल्ले को खाली छोड़ दें और पता रेखाओं का उपयोग करें. |
sublocality |
ज़रूरी नहीं. पते का मोहल्ला. उदाहरण के लिए, यह आस-पड़ोस, नगर, ज़िला हो सकता है. |
addressLines[] |
पते के निचले लेवल के बारे में बताने वाली अव्यवस्थित पता पंक्तियां. पता लाइनों में मौजूद वैल्यू में टाइप की जानकारी नहीं होती. साथ ही, कभी-कभी एक ही फ़ील्ड में एक से ज़्यादा वैल्यू हो सकती हैं (जैसे, "ऑस्टिन, टेक्सस"), इसलिए यह ज़रूरी है कि लाइन का क्रम साफ़ हो. पता पंक्तियों का क्रम "लिफ़ाफ़े का क्रम" होना चाहिए पते के देश/क्षेत्र के लिए. जिन जगहों पर यह अलग-अलग हो सकता है वहां (जैसे, जापान), address_language का इस्तेमाल उसे साफ़ तौर पर दिखाने के लिए किया जाता है. जैसे, बड़े से छोटे क्रम के लिए "ja" और छोटे से बड़े क्रम के लिए "ja-Latn" या "en". इस तरह, भाषा के आधार पर किसी पते की सबसे सटीक लाइन चुनी जा सकती है. किसी पते को कम से कम जितनी जानकारी के लिए अनुमति दी जाती है उसमें क्षेत्र का कोड शामिल होता है. इसमें, बची हुई सारी जानकारी पता लाइनों में डाली जाती है. इस तरह के पते को करीब-करीब जियोकोडिंग के बिना फ़ॉर्मैट किया जा सकता है, लेकिन पते के किसी भी कॉम्पोनेंट के बारे में तब तक सिमैंटिक रीज़निंग के बारे में नहीं बताया जा सकता, जब तक कि यह पूरी तरह से आंशिक रूप से हल न हो जाए. सिर्फ़ RegionCode और addressLines वाला पता बनाने और फिर पूरी तरह से स्ट्रक्चर नहीं किए गए पतों को मैनेज करने के लिए, जियोकोडिंग तरीका इस्तेमाल करने का सुझाव दिया जाता है. इससे यह अनुमान नहीं लगाया जा सकता कि पते के कौनसे हिस्से, इलाके या प्रशासनिक इलाके होने चाहिए. |
recipients[] |
ज़रूरी नहीं. कारोबार के पते पर मौजूद व्यक्ति. कुछ मामलों में, इस फ़ील्ड में मल्टीलाइन जानकारी शामिल हो सकती है. उदाहरण के लिए, इसमें "care of" शामिल हो सकती है जानकारी. |
organization |
ज़रूरी नहीं. पते पर संगठन का नाम. |
फ़ोन नंबर
फ़ोन नंबर दिखाने वाला ऑब्जेक्ट, जो एपीआई वायर फ़ॉर्मैट के तौर पर काम करता है.
यह कॉन्टेंट:
फ़ोन नंबर की स्थान-भाषा के हिसाब से फ़ॉर्मैटिंग के लिए इस्तेमाल नहीं किया जाना चाहिए, जैसे कि "+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
JSON के काेड में दिखाना |
---|
{ "extension": string, // Union field |
फ़ील्ड | |
---|---|
extension |
फ़ोन नंबर का एक्सटेंशन. ITU सुझावों में एक्सटेंशन मानक के मुताबिक नहीं है, लेकिन इसे 40 अंकों की अधिकतम लंबाई वाली संख्याओं की सीरीज़ के रूप में परिभाषित किया गया है. अंकों के अलावा, डायल करने के लिए इस्तेमाल किए जाने वाले कुछ दूसरे वर्ण, जैसे कि ',' (इंतज़ार दिखाना) या gtm इन्हें यहां सेव किया जा सकता है. ध्यान दें कि फ़िलहाल किसी भी इलाके में शॉर्ट कोड वाले एक्सटेंशन का इस्तेमाल नहीं किया जाता. इसलिए, आम तौर पर यह फ़ील्ड सिर्फ़ E.164 नंबर के साथ सेट किया जाता है. इस नंबर को E.164 नंबर से अलग रखा जाता है, ताकि आने वाले समय में छोटे कोड एक्सटेंशन इस्तेमाल किए जा सकें. |
यूनियन फ़ील्ड kind . ज़रूरी है. कोई सामान्य संख्या या छोटा कोड. आने वाले समय में, इनमें से किसी एक फ़ील्ड में नए फ़ील्ड जोड़े जा सकते हैं. इसलिए, क्लाइंट को ऐसे फ़ोन नंबर नज़रअंदाज़ करने चाहिए जिनके लिए उन्हें कोड किया गया कोई भी फ़ील्ड सेट न किया गया हो. kind इनमें से सिर्फ़ एक हो सकता है: |
|
e164Number |
फ़ोन नंबर को शुरू में प्लस के निशान ('+') के तौर पर दिखाया जाता है.इसके बाद, एक आरामदेह ITU 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).
छोटे कोड किसी इलाके के लिए ही इस्तेमाल किए जा सकते हैं. साथ ही, इन्हें अंतरराष्ट्रीय स्तर पर डायल नहीं किया जा सकता. इसका मतलब है कि एक ही शॉर्ट कोड, अलग-अलग इलाकों में अलग-अलग इस्तेमाल और शुल्क के साथ मौजूद हो सकता है. भले ही, उन सभी क्षेत्रों में एक ही देश का कॉलिंग कोड मौजूद हो, जैसे कि अमेरिका और कनाडा.
JSON के काेड में दिखाना |
---|
{ "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
ग्राहक सेवा की जानकारी.
JSON के काेड में दिखाना |
---|
{
"uri": string,
"email": string,
"phone": {
object ( |
फ़ील्ड | |
---|---|
uri |
ज़रूरी नहीं. वह यूआरआई जहां ग्राहक सेवा मिल सकती है. |
email |
ज़रूरी नहीं. वह ईमेल पता जिस पर ग्राहक सेवा से संपर्क किया जा सकता है. |
phone |
ज़रूरी नहीं. वह फ़ोन नंबर जिस पर ग्राहक सेवा को कॉल किया जा सकता है. |