REST Resource: accounts.businessInfo

रिसॉर्स: BusinessInfo

BusinessInfo मैसेज में, कारोबारी या कंपनी के कारोबार की ज़रूरी जानकारी होती है.

इस मैसेज में, कारोबार की मुख्य जानकारी शामिल होती है. जैसे, कारोबार का पता, ग्राहक सेवा के संपर्क, और इलाके के हिसाब से आइडेंटिफ़ायर.

JSON के काेड में दिखाना 
{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  },
  "koreanBusinessRegistrationNumber": string
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. कारोबार की जानकारी के रिसॉर्स का नाम. फ़ॉर्मैट: accounts/{account}/businessInfo
address

object (PostalAddress)

ज़रूरी नहीं. कारोबार का पता. सिर्फ़ regionCode, addressLines, postalCode, administrativeArea, और locality फ़ील्ड का इस्तेमाल किया जा सकता है. अन्य सभी फ़ील्ड को अनदेखा कर दिया जाता है.
phone

object (PhoneNumber)

सिर्फ़ आउटपुट के लिए. कारोबार का फ़ोन नंबर.
phoneVerificationState

enum (PhoneVerificationState)

सिर्फ़ आउटपुट के लिए. कारोबार के फ़ोन नंबर की पुष्टि की स्थिति.
customerService

object (CustomerService)

ज़रूरी नहीं. कारोबार की ग्राहक सेवा.
koreanBusinessRegistrationNumber

string

ज़रूरी नहीं. कोरिया में मौजूद कारोबार का रजिस्ट्रेशन नंबर 10 अंकों का होना चाहिए. इसे इस फ़ॉर्मैट में डालें: XXX-XX-XXXXX.

PostalAddress

डाक पते की जानकारी दिखाता है. जैसे, डाक से डिलीवरी करने या पेमेंट के पते के लिए. डाक पते की मदद से, डाक सेवा किसी प्रॉपर्टी, पीओ बॉक्स या इसी तरह की जगह पर सामान डिलीवर कर सकती है. इसका मकसद, भौगोलिक जगहों (सड़कों, शहरों, पहाड़ों) को मॉडल करना नहीं है.

आम तौर पर, प्रोसेस के टाइप के हिसाब से, उपयोगकर्ता के इनपुट या मौजूदा डेटा को इंपोर्ट करके पता बनाया जाएगा.

पते के इनपुट या उसमें बदलाव करने के बारे में सलाह: - अंतरराष्ट्रीय स्तर पर इस्तेमाल किए जा सकने वाले पते के विजेट का इस्तेमाल करें. जैसे, 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

integer

PostalAddress के स्कीमा में किया गया बदलाव. इसे 0 पर सेट करना चाहिए, जो कि सबसे नया बदलाव है.

सभी नए बदलाव, पुराने बदलावों के साथ काम करने चाहिए.
regionCode

string

ज़रूरी है. पते के देश/इलाके का CLDR कोड. इसकी जानकारी कभी भी अनुमानित नहीं की जाती. यह उपयोगकर्ता की ज़िम्मेदारी है कि वह यह पक्का करे कि वैल्यू सही हो. ज़्यादा जानकारी के लिए, https://cldr.unicode.org/ और https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html देखें. उदाहरण: स्विट्ज़रलैंड के लिए "CH".
languageCode

string

ज़रूरी नहीं. इस पते के कॉन्टेंट का BCP-47 भाषा कोड (अगर पता हो). आम तौर पर, यह इनपुट फ़ॉर्म के यूज़र इंटरफ़ेस (यूआई) की भाषा होती है. इसके अलावा, यह पता है कि यह भाषा, पते के देश/इलाके में इस्तेमाल की जाने वाली किसी भाषा या ट्रांसलिटरेट की गई किसी भाषा से मेल खाती है. इससे कुछ देशों में फ़ॉर्मैटिंग पर असर पड़ सकता है. हालांकि, इससे डेटा की सटीक जानकारी पर कोई असर नहीं पड़ेगा. साथ ही, इसकी वजह से पुष्टि करने या फ़ॉर्मैटिंग से जुड़े अन्य कामों पर भी कभी असर नहीं पड़ेगा.

अगर यह वैल्यू नहीं पता है, तो गलत डिफ़ॉल्ट वैल्यू देने के बजाय, इसे हटा दिया जाना चाहिए.

उदाहरण: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

ज़रूरी नहीं. पते का पिन कोड. सभी देश, पिन कोड का इस्तेमाल नहीं करते या यह ज़रूरी नहीं है कि पते में पिन कोड शामिल हो. हालांकि, जिन देशों में पिन कोड का इस्तेमाल किया जाता है वहां पते के अन्य हिस्सों की पुष्टि करने के लिए, पिन कोड की पुष्टि भी की जा सकती है. उदाहरण के लिए, अमेरिका में राज्य/पिन कोड की पुष्टि.
sortingCode

string

ज़रूरी नहीं. देश के हिसाब से, क्रम से लगाने के लिए अतिरिक्त कोड. ज़्यादातर इलाकों में इसका इस्तेमाल नहीं किया जाता. जहां इसका इस्तेमाल किया जाता है वहां वैल्यू, "CEDEX" जैसी स्ट्रिंग होती है. इसके बाद, वैल्यू के तौर पर कोई संख्या भी हो सकती है, जैसे कि "CEDEX 7". इसके अलावा, वैल्यू सिर्फ़ एक संख्या भी हो सकती है. यह संख्या, "सेक्टर कोड" (जमैका), "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (जैसे, कोट डी आइवर) को दिखाती है.
administrativeArea

string

ज़रूरी नहीं. किसी देश या इलाके के डाक पते के लिए इस्तेमाल होने वाला सबसे बड़ा एडमिन के तौर पर उपखंड. उदाहरण के लिए, यह कोई राज्य, प्रांत, ओब्लास्ट या प्रीफ़ेक्चर हो सकता है. खास तौर पर, स्पेन के लिए यह प्रांत है, न कि ऑटोनोमस कम्यूनिटी (उदाहरण के लिए, "बार्सिलोना", न कि "कैटलोनिया"). कई देश, डाक पते में प्रशासनिक क्षेत्र का इस्तेमाल नहीं करते. उदाहरण के लिए, स्विट्ज़रलैंड में इस फ़ील्ड को खाली छोड़ा जाना चाहिए.
locality

string

ज़रूरी नहीं. आम तौर पर, इसका मतलब पते के शहर/कस्बे से होता है. उदाहरण: अमेरिका का शहर, इटली का कम्यून, यूनाइटेड किंगडम का पोस्ट टाउन. दुनिया के उन इलाकों में जहां इलाकों की जानकारी साफ़ तौर पर नहीं दी गई है या वे इस स्ट्रक्चर में सही से फ़िट नहीं होते, वहां इलाके की जानकारी वाले फ़ील्ड को खाली छोड़ें और addressLines का इस्तेमाल करें.
sublocality

string

ज़रूरी नहीं. पते की उप-इलाका. उदाहरण के लिए, यह इलाके, बोरो, जिले हो सकते हैं.
addressLines[]

string

पते की निचली लाइनों की जानकारी देने वाली, बिना स्ट्रक्चर वाली लाइनें.

addressLines में मौजूद वैल्यू में टाइप की जानकारी नहीं होती और कभी-कभी एक फ़ील्ड में कई वैल्यू हो सकती हैं (जैसे, "ऑस्टिन, टेक्सास"). इसलिए, यह ज़रूरी है कि लाइन का क्रम साफ़ तौर पर दिखे. पते के देश/इलाके के हिसाब से, पते की लाइन का क्रम "एनवलप का क्रम" होना चाहिए. जिन देशों/इलाकों में यह क्रम अलग-अलग हो सकता है (जैसे, जापान), वहां address_language का इस्तेमाल करके यह जानकारी साफ़ तौर पर दी जाती है. जैसे, बड़े से छोटे क्रम के लिए "ja" और छोटे से बड़े क्रम के लिए "ja-Latn" या "en". इस तरह, भाषा के आधार पर पते की सबसे खास लाइन चुनी जा सकती है.

किसी पते के स्ट्रक्चर के तौर पर, कम से कम regionCode की जानकारी होनी चाहिए. बाकी जानकारी, addressLines में दी जानी चाहिए. ऐसे पते को जियोकोडिंग के बिना भी फ़ॉर्मैट किया जा सकता है. हालांकि, पते के किसी भी कॉम्पोनेंट के बारे में तब तक कोई सेमेटिक वजह नहीं बताई जा सकती, जब तक कि उसे कम से कम कुछ हद तक हल नहीं किया जाता.

बिना क्रम के दिए गए पतों को मैनेज करने के लिए, हमारा सुझाव है कि आप सिर्फ़ regionCode और addressLines वाला पता बनाएं. इसके बाद, उसे जियोकोड करें. ऐसा करने से, यह अनुमान लगाने की ज़रूरत नहीं पड़ेगी कि पते के कौनसे हिस्से इलाके या प्रशासनिक क्षेत्र होने चाहिए.
recipients[]

string

ज़रूरी नहीं. पते पर मौजूद व्यक्ति. कुछ मामलों में, इस फ़ील्ड में एक से ज़्यादा लाइन की जानकारी हो सकती है. उदाहरण के लिए, इसमें "किसके पास है" जानकारी शामिल हो सकती है.
organization

string

ज़रूरी नहीं. पते पर मौजूद संगठन का नाम.

फ़ोन नंबर

फ़ोन नंबर दिखाने वाला ऑब्जेक्ट, जो एपीआई वायर फ़ॉर्मैट के तौर पर काम करता है.

इस जानकारी से:

  • का इस्तेमाल, स्थानीय भाषा के हिसाब से फ़ोन नंबर को फ़ॉर्मैट करने के लिए नहीं किया जाना चाहिए. जैसे, "+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 kind can be only one of the following:
  "e164Number": string,
  "shortCode": {
    object (ShortCode)
  }
  // End of list of possible types for union field kind.
}
फ़ील्ड
extension

string

फ़ोन नंबर का एक्सटेंशन. आईटीयू के सुझावों में, एक्सटेंशन को स्टैंडर्ड नहीं बनाया गया है. हालांकि, इसे संख्याओं की एक सीरीज़ के तौर पर परिभाषित किया गया है, जिसमें ज़्यादा से ज़्यादा 40 अंक हो सकते हैं. अंकों के अलावा, डायल करने के लिए इस्तेमाल होने वाले कुछ अन्य वर्ण भी यहां सेव किए जा सकते हैं. जैसे, ',' (इंतज़ार का संकेत) या '#'.

ध्यान दें कि फ़िलहाल कोई भी क्षेत्र, शॉर्ट कोड वाले एक्सटेंशन का इस्तेमाल नहीं करता. इसलिए, आम तौर पर यह फ़ील्ड सिर्फ़ E.164 नंबर के साथ सेट किया जाता है. इसे E.164 नंबर से अलग रखा जाता है, ताकि आने वाले समय में शॉर्ट कोड एक्सटेंशन की सुविधा दी जा सके.
यूनियन फ़ील्ड kind. ज़रूरी है. कोई सामान्य नंबर या कोई छोटा कोड. आने वाले समय में, यहां दिए गए oneof में नए फ़ील्ड जोड़े जा सकते हैं. इसलिए, क्लाइंट को ऐसे फ़ोन नंबरों को अनदेखा करना चाहिए जिनके लिए कोड किए गए फ़ील्ड में से कोई भी फ़ील्ड सेट नहीं है. kind इनमें से कोई एक हो सकता है:
e164Number

string

फ़ोन नंबर, जिसे सबसे पहले प्लस के निशान ('+') के तौर पर दिखाया जाता है. इसके बाद, फ़ोन नंबर आता है, जो ITU E.164 फ़ॉर्मैट का इस्तेमाल करता है. इसमें देश का कॉलिंग कोड (1 से 3 अंक) और सदस्य का नंबर शामिल होता है. इसमें कोई अतिरिक्त स्पेस या फ़ॉर्मैटिंग नहीं होती. उदाहरण के लिए: - सही: "+15552220123" - गलत: "+1 (555) 222-01234 x123".

आईटीयू 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

object (ShortCode)

कोई छोटा कोड.

रेफ़रंस: - https://en.wikipedia.org/wiki/Short_code

ShortCode

यह शॉर्ट कोड दिखाने वाला ऑब्जेक्ट है. यह एक ऐसा फ़ोन नंबर होता है जो आम तौर पर सामान्य फ़ोन नंबर से काफ़ी छोटा होता है. इसका इस्तेमाल एमएमएस और एसएमएस सिस्टम में मैसेज भेजने के लिए किया जा सकता है. साथ ही, इसका इस्तेमाल कम वर्णों में डायल करने के लिए भी किया जा सकता है. उदाहरण के लिए, "अपने प्लान में बचे हुए मिनट देखने के लिए, 611 पर मैसेज भेजें."

शॉर्ट कोड का इस्तेमाल सिर्फ़ किसी एक इलाके में किया जा सकता है. साथ ही, इनका इस्तेमाल अंतरराष्ट्रीय स्तर पर नहीं किया जा सकता. इसका मतलब है कि एक ही शॉर्ट कोड का इस्तेमाल अलग-अलग इलाकों में किया जा सकता है. साथ ही, इनकी कीमत और इस्तेमाल भी अलग-अलग हो सकता है. भले ही, उन इलाकों का देश कोड एक ही हो, जैसे कि अमेरिका और कनाडा.

JSON के काेड में दिखाना 
{
  "regionCode": string,
  "number": string
}
फ़ील्ड
regionCode

string

ज़रूरी है. उस जगह का BCP-47 क्षेत्र कोड जहां इस शॉर्ट कोड पर कॉल किए जा सकते हैं, जैसे कि "US" और "BB".

रेफ़रंस: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

ज़रूरी है. शॉर्ट कोड के अंक, जिनमें सबसे पहले प्लस ('+') या देश का कॉलिंग कोड न हो. जैसे, "611".

PhoneVerificationState

फ़ोन नंबर की पुष्टि की स्थिति.

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता.
PHONE_VERIFICATION_STATE_VERIFIED फ़ोन नंबर की पुष्टि हो गई हो.
PHONE_VERIFICATION_STATE_UNVERIFIED फ़ोन नंबर की पुष्टि नहीं हुई है

CustomerService

ग्राहक सेवा की जानकारी.

JSON के काेड में दिखाना 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
फ़ील्ड
uri

string

ज़रूरी नहीं. वह यूआरआई जहां ग्राहक सेवा मिल सकती है.
email

string

ज़रूरी नहीं. वह ईमेल पता जिस पर ग्राहक सेवा टीम से संपर्क किया जा सकता है.
phone

object (PhoneNumber)

ज़रूरी नहीं. वह फ़ोन नंबर जहां ग्राहक सेवा को कॉल किया जा सकता है.

तरीके

getBusinessInfo

 किसी खाते के कारोबार की जानकारी दिखाता है.

updateBusinessInfo

 किसी खाते के कारोबार की जानकारी अपडेट करता है.