REST Resource: accounts

संसाधन: खाता

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

JSON के काेड में दिखाना 
{
  "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)

ज़रूरी है. इसमें यह जानकारी होती है कि खाता किस तरह का है. इस API का उपयोग करके कस्टम और 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

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

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

string

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

object (PostalAddress)

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

string

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

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

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") या सिर्फ़ एक संख्या होती है. यह "sector code" को दिखाता है (जमैका), "डिलीवरी एरिया इंडिकेटर" (मलावी) या "पोस्ट ऑफ़िस इंडिकेटर" (उदाहरण के लिए आइवरी कोस्ट).
administrativeArea

string

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

string

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

string

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

string

पते के निचले लेवल के बारे में बताने वाली अव्यवस्थित पता पंक्तियां.

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

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

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

string

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

string

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

तरीके

create

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

get

 चुने गए खाते को ऐक्सेस करता है.

list

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

patch

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