REST Resource: accounts

संसाधन: खाता

खाता, आपकी जगह के लिए एक कंटेनर होता है. अगर सिर्फ़ आप अपने कारोबार की जगहें मैनेज करने वाले उपयोगकर्ता हैं, तो अपने निजी Google खाते का इस्तेमाल कर सकते हैं. कई उपयोगकर्ताओं के साथ स्थानों का प्रबंधन शेयर करने के लिए, एक व्यवसाय खाता बनाएं.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
फ़ील्ड
name

string

इम्यूटेबल. संसाधन का नाम, accounts/{account_id} फ़ॉर्मैट में.
accountName

string

ज़रूरी है. खाते का नाम. PERSONAL टाइप के खाते के लिए, यह उपयोगकर्ता खाते का नाम और सरनेम है.
primaryOwner

string

ज़रूरी है. सिर्फ़ इनपुट. उस खाते के संसाधन का नाम जो बनाए जा रहे खाते का मुख्य मालिक होगा. यह accounts/{account_id} फ़ॉर्मैट में होना चाहिए.
type

enum (AccountType)

ज़रूरी है. इसमें खाते का टाइप शामिल होता है. इस एपीआई का इस्तेमाल करके PERSONAL और ORGANIZATION जैसे खाते नहीं बनाए जा सकते.
role

enum (AccountRole)

सिर्फ़ आउटपुट के लिए. इस खाते की AccountRole बताई जाती है.
verificationState

enum (VerificationState)

सिर्फ़ आउटपुट के लिए. अगर सत्यापित हो जाता है, तो बनाए जाने वाले भावी स्थान, मॉडरेशन की आवश्यकता के बिना अपने आप Google मैप से कनेक्ट हो जाते हैं और उनमें Google+ पेज बनाए जाते हैं.
vettedState

enum (VettedState)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि Google ने खाते की जांच की है या नहीं. जांचा गया खाता, VETTED_PARTNER तरीके से जगहों की पुष्टि कर सकता है.
accountNumber

string

सिर्फ़ आउटपुट के लिए. अगर प्रावधान किया गया है, तो खाते का रेफ़रंस नंबर.
permissionLevel

enum (PermissionLevel)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि उपयोगकर्ता के पास इस खाते को किस लेवल की अनुमति है.
organizationInfo

object (OrganizationInfo)

सिर्फ़ आउटपुट के लिए. संगठन के लिए अतिरिक्त जानकारी. यह सिर्फ़ संगठन के खाते के लिए भरा जाता है.

AccountType

इससे पता चलता है कि यह किस तरह का खाता है: निजी/उपयोगकर्ता खाता या कारोबारी खाता.

Enums
ACCOUNT_TYPE_UNSPECIFIED जानकारी नहीं दी गई.
PERSONAL असली उपयोगकर्ता खाता.
LOCATION_GROUP जगहों का ग्रुप. ज़्यादा जानकारी के लिए, सहायता केंद्र का लेख पढ़ें
USER_GROUP संगठन के कर्मचारियों को अलग-अलग ग्रुप में रखने के लिए उपयोगकर्ता ग्रुप. ज़्यादा जानकारी के लिए, सहायता केंद्र का लेख पढ़ें
ORGANIZATION किसी कंपनी का प्रतिनिधित्व करने वाला संगठन. ज़्यादा जानकारी के लिए, सहायता केंद्र का लेख पढ़ें

AccountRole

इस खाते के लिए, पुष्टि किए गए उपयोगकर्ता के ऐक्सेस लेवल को दिखाता है. ज़्यादा जानकारी के लिए, सहायता केंद्र का लेख पढ़ें

Enums
ACCOUNT_ROLE_UNSPECIFIED जानकारी नहीं दी गई.
PRIMARY_OWNER उपयोगकर्ता इस खाते का मुख्य मालिक है.
OWNER खाते का उपयोगकर्ता मालिक.
MANAGER उपयोगकर्ता इस खाते को मैनेज कर सकता है.
SITE_MANAGER उपयोगकर्ता, खाते के लिए कुछ सुविधाओं को मैनेज कर सकता है.

VerificationState

खाते की पुष्टि की स्थिति को दिखाता है.

Enums
VERIFICATION_STATE_UNSPECIFIED जानकारी नहीं दी गई.
VERIFIED खाता सत्यापित किया गया.
UNVERIFIED ऐसा खाता जिसकी पुष्टि नहीं हुई है और पुष्टि का अनुरोध नहीं किया गया है.
VERIFICATION_REQUESTED वह खाता जिसकी पुष्टि नहीं हुई है, लेकिन पुष्टि का अनुरोध किया गया है.

VettedState

यह किसी खाते की जांची गई स्थिति को दिखाता है.

Enums
VETTED_STATE_UNSPECIFIED जानकारी मौजूद नहीं
NOT_VETTED Google ने इस खाते की जांच नहीं की है.
VETTED Google ने इस खाते की जांच की है और यह मान्य स्थिति में है. अगर किसी खाते के पास पुष्टि किए गए ग्रुप के खाते का सीधा ऐक्सेस है, तो उसकी अपने-आप जांच हो जाती है.
INVALID खाते की जांच की गई है, लेकिन यह अमान्य है. यह खाता ऐसे खाते की तरह काम करेगा जिसकी पुष्टि नहीं की गई है.

PermissionLevel

इस खाते के लिए, पुष्टि किए गए उपयोगकर्ता के ऐक्सेस लेवल को दिखाता है.

Enums
PERMISSION_LEVEL_UNSPECIFIED जानकारी नहीं दी गई.
OWNER_LEVEL उपयोगकर्ता के पास मालिक के लेवल की अनुमति है.
MEMBER_LEVEL उपयोगकर्ता के पास सदस्य लेवल की अनुमति है.

OrganizationInfo

किसी संगठन के लिए सेव की गई अतिरिक्त जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
फ़ील्ड
registeredDomain

string

सिर्फ़ आउटपुट के लिए. खाते के लिए रजिस्टर किया गया डोमेन.
address

object (PostalAddress)

सिर्फ़ आउटपुट के लिए. खाते का डाक पता.
phoneNumber

string

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

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

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

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

string

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

string

पते के निचले लेवल के बारे में बताने वाली अनस्ट्रक्चर्ड मैसेज लाइनें.

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

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

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

string

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

string

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

तरीके

create

 दिए गए पैरंट के तहत बताए गए नाम और टाइप वाला खाता बनाता है.

get

 बताए गए खाते को ऐक्सेस करता है.

list

 यह पुष्टि किए गए उपयोगकर्ता के सभी खातों की सूची बनाता है.

patch

 कारोबार के खाते को अपडेट करता है.