REST Resource: accounts.locations

संसाधन: जगह की जानकारी

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

JSON के काेड में दिखाना 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. इस जगह के लिए Google आइडेंटिफ़ायर, इस फ़ॉर्मैट में होना चाहिए: locations/{locationId}.
languageCode

string

इम्यूटेबल. जगह की भाषा. इसे एनटाइटलमेंट बनाने के दौरान सेट किया जाता है और अपडेट नहीं किया जा सकता.
storeCode

string

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

string

ज़रूरी है. जगह का नाम वही होना चाहिए जिसका इस्तेमाल आपके स्टोरफ़्रंट, वेबसाइट, और साइन बोर्ड पर हमेशा किया जाता है और जिसे आपके ग्राहक पहले से जानते हैं. अगर ज़रूरी हो, तो संसाधन के अन्य फ़ील्ड में अतिरिक्त जानकारी शामिल की जा सकती है. उदाहरण के लिए, Address, Categories. अपने नाम में ग़ैर-ज़रूरी जानकारी न जोड़ें. उदाहरण के लिए, "Google Inc. - Mountain View Corporate Headquarters" के बजाय "Google" को प्राथमिकता दें. मार्केटिंग टैगलाइन, स्टोर कोड, खास वर्ण, कारोबार के खुले होने का समय या बंद/खुले होने की स्थिति, फ़ोन नंबर, वेबसाइट के यूआरएल, सेवा/प्रॉडक्ट की जानकारी, जगह/पता या निर्देश या कारोबार की जगह की जानकारी (उदाहरण के लिए, "Duane Reade में Chase ATM") शामिल न करें.
phoneNumbers

object (PhoneNumbers)

ज़रूरी नहीं. वे अलग-अलग फ़ोन नंबर जिनका इस्तेमाल करके, ग्राहक कारोबार से संपर्क कर सकते हैं.
categories

object (Categories)

ज़रूरी नहीं. कारोबार के बारे में बताने वाली अलग-अलग कैटगरी.
storefrontAddress

object (PostalAddress)

ज़रूरी नहीं. अपने कारोबार की जगह की जानकारी देने के लिए, सही पता. दूर-दराज़ की जगहों पर मौजूद पोस्ट बॉक्स या मेलबॉक्स का पता मान्य नहीं होगा. फ़िलहाल, पते में ज़्यादा से ज़्यादा पांच addressLines वैल्यू डाली जा सकती हैं. यह फ़ील्ड सिर्फ़ उन कारोबारों के लिए सेट किया जाना चाहिए जिनका स्टोरफ़्रंट है. इस फ़ील्ड को CUSTOMER_LOCATION_ONLY टाइप की जगहों के लिए सेट नहीं किया जाना चाहिए. हालांकि, अगर इसे सेट किया जाता है, तो दी गई कोई भी वैल्यू खारिज कर दी जाएगी.
websiteUri

string

ज़रूरी नहीं. इस कारोबार का यूआरएल. अगर हो सके, तो कारोबार की इस जगह को दिखाने वाले यूआरएल का इस्तेमाल करें. कारोबार की सभी जगहों या ब्रैंड को दिखाने वाली सामान्य वेबसाइट/यूआरएल का इस्तेमाल न करें.
regularHours

object (BusinessHours)

ज़रूरी नहीं. कारोबार के खुले होने का समय.
specialHours

object (SpecialHours)

ज़रूरी नहीं. कारोबार के लिए खास घंटे. आम तौर पर, इसमें छुट्टी के दिन कारोबार के खुले होने का समय और कारोबार के खुले होने के सामान्य समय के अलावा अन्य समय शामिल होता है. ये कारोबार के खुले होने के सामान्य समय को बदल देते हैं. इस फ़ील्ड को सामान्य कामकाजी घंटों के बिना सेट नहीं किया जा सकता.
serviceArea

object (ServiceAreaBusiness)

ज़रूरी नहीं. घर या दुकान पर सेवा देने वाले कारोबार, ग्राहक के पते पर अपनी सेवा देते हैं. अगर यह कारोबार, घर या दुकान पर सेवा देने वाला कारोबार है, तो इस फ़ील्ड में उन इलाकों की जानकारी दी जाती है जहां यह कारोबार सेवा देता है.
labels[]

string

ज़रूरी नहीं. यह फ़्री-फ़ॉर्म स्ट्रिंग का एक कलेक्शन है. इसकी मदद से, अपने कारोबार को टैग किया जा सकता है. ये लेबल, उपयोगकर्ताओं को नहीं दिखते. ये सिर्फ़ आपको दिखते हैं. हर लेबल में 1 से 255 वर्ण होने चाहिए.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

ज़रूरी नहीं. AdWords में दिखने वाली अतिरिक्त जानकारी.
latlng

object (LatLng)

ज़रूरी नहीं. उपयोगकर्ता से मिला अक्षांश और देशांतर. कोई जगह बनाते समय, अगर दिए गए पते को जियोकोड कर दिया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है. यह फ़ील्ड, GET अनुरोधों पर सिर्फ़ तब दिखता है, जब उपयोगकर्ता की दी गई latlng वैल्यू को प्रोफ़ाइल बनाते समय स्वीकार किया गया हो या latlng वैल्यू को Google Business Profile की वेबसाइट के ज़रिए अपडेट किया गया हो. इस फ़ील्ड को सिर्फ़ वे क्लाइंट अपडेट कर सकते हैं जिन्हें अनुमति मिली है.
openInfo

object (OpenInfo)

ज़रूरी नहीं. यह फ़्लैग बताता है कि कारोबार की जगह फ़िलहाल खुली है या नहीं.
metadata

object (Metadata)

सिर्फ़ आउटपुट के लिए. ऐसी अतिरिक्त जानकारी जिसमें उपयोगकर्ता बदलाव नहीं कर सकता.
profile

object (Profile)

ज़रूरी नहीं. इससे आपको अपने कारोबार के बारे में अपने हिसाब से जानकारी देने का मौका मिलता है. साथ ही, उपयोगकर्ताओं के साथ अपने कारोबार की खास कहानी और ऑफ़र शेयर करने की सुविधा मिलती है.

यह फ़ील्ड, ठहरने की जगहों की कैटगरी (जैसे, होटल, मोटल, सराय) को छोड़कर, अन्य सभी कैटगरी के लिए ज़रूरी है.
relationshipData

object (RelationshipData)

ज़रूरी नहीं. इस कारोबार से जुड़ी सभी जगहें और चेन.
moreHours[]

object (MoreHours)

ज़रूरी नहीं. कारोबार के अलग-अलग विभागों या खास ग्राहकों के लिए, 'ज़्यादा घंटे' सेट करने की सुविधा.
serviceItems[]

object (ServiceItem)

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

PhoneNumbers

कारोबार के फ़ोन नंबर का कलेक्शन. अपडेट के दौरान, दोनों फ़ील्ड सेट होने चाहिए. ऐसा हो सकता है कि क्लाइंट, अपडेट मास्क का इस्तेमाल करके सिर्फ़ मुख्य या अतिरिक्त फ़ोन नंबर अपडेट न कर पाएं. अंतरराष्ट्रीय फ़ोन नंबर फ़ॉर्मैट का इस्तेमाल करना बेहतर होता है, जैसे कि "+1 415 555 0132". ज़्यादा जानकारी के लिए, (https://developers.google.com/style/phone-numbers#international-phone-numbers) पर जाएं.

JSON के काेड में दिखाना 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
फ़ील्ड
primaryPhone

string

ज़रूरी है. आपके कारोबार का फ़ोन नंबर, ताकि ग्राहक आपसे सीधे संपर्क कर सकें. अगर मुमकिन हो, तो सेंट्रल कॉल सेंटर के हेल्पलाइन नंबर के बजाय, कोई स्थानीय फ़ोन नंबर दें.
additionalPhones[]

string

ज़रूरी नहीं. अपने कारोबार के लिए, मुख्य फ़ोन नंबर के अलावा ज़्यादा से ज़्यादा दो फ़ोन नंबर (मोबाइल या लैंडलाइन, फ़ैक्स नंबर नहीं) जोड़े जा सकते हैं.

कैटगरी

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

JSON के काेड में दिखाना 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
फ़ील्ड
primaryCategory

object (Category)

ज़रूरी है. वह कैटगरी जिससे इस जगह पर मौजूद कारोबार के बारे में सबसे सटीक जानकारी मिलती है.
additionalCategories[]

object (Category)

ज़रूरी नहीं. अपने कारोबार के बारे में बताने के लिए अतिरिक्त कैटगरी. कैटगरी की मदद से, आपके ग्राहक अपनी पसंद वाली सेवाओं के लिए सटीक नतीजे पा सकते हैं. अपने कारोबार की जानकारी को सटीक और लाइव बनाए रखने के लिए, अपने मुख्य कारोबार की पूरी जानकारी देने के लिए, कम से कम कैटगरी का इस्तेमाल करें. अगर हो सके, तो ऐसी कैटगरी चुनें जो आपके कारोबार के हिसाब से हो.

कैटगरी

कोई ऐसी कैटगरी जो यह बताती हो कि यह कारोबार किस तरह का है, न कि यह कि यह क्या काम करता है. मान्य कैटगरी आईडी की सूची और उनके आसानी से पढ़े जा सकने वाले नामों की मैपिंग देखने के लिए, categories.list पर जाएं.

JSON के काेड में दिखाना 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
फ़ील्ड
name

string

ज़रूरी है. इस कैटगरी के लिए, Google की ओर से दिया गया स्टेबल आईडी. कैटगरी में बदलाव करते समय (कोई जगह बनाते या अपडेट करते समय), वैल्यू तय करना ज़रूरी है.
displayName

string

सिर्फ़ आउटपुट के लिए. कैटगरी का ऐसा नाम जिसे आसानी से पढ़ा जा सकता है. यह जगह की जानकारी को पढ़ते समय सेट किया जाता है. जगह की जानकारी में बदलाव करते समय, category_id को सेट करना ज़रूरी है.
serviceTypes[]

object (ServiceType)

सिर्फ़ आउटपुट के लिए. कारोबार की इस कैटगरी के लिए उपलब्ध सभी सेवा टाइप की सूची.
moreHoursTypes[]

object (MoreHoursType)

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

ServiceType

कारोबार की ओर से दी जाने वाली किसी सेवा के बारे में जानकारी देने वाला मैसेज.

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

string

सिर्फ़ आउटपुट के लिए. इस तरह की सेवा के लिए, Google की ओर से दिया गया एक स्टेबल आईडी.
displayName

string

सिर्फ़ आउटपुट के लिए. सेवा के टाइप का डिसप्ले नेम, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

MoreHoursType

कारोबार के खुले रहने के सामान्य घंटों के अलावा, कारोबार के खुले रहने के और समय के टाइप.

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

string

सिर्फ़ आउटपुट के लिए. Google ने इस तरह के कारोबार के खुले होने के समय के लिए, एक स्टेबल आईडी दिया है.
displayName

string

सिर्फ़ आउटपुट के लिए. कारोबार के खुले होने के घंटों के टाइप के लिए, अंग्रेज़ी में डिसप्ले नेम. इसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
localizedDisplayName

string

सिर्फ़ आउटपुट के लिए. कारोबार के खुले होने के समय के टाइप के लिए, स्थानीय भाषा में डिसप्ले नेम. इसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

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

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

string

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

string

पते की ऐसी लाइनें जो व्यवस्थित नहीं हैं और पते के निचले लेवल के बारे में बताती हैं.

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

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

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

string

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

string

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

BusinessHours

इससे पता चलता है कि यह जगह, कारोबार के लिए किस समयावधि में खुली रहती है. इसमें [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] इंस्टेंस का कलेक्शन होता है.

JSON के काेड में दिखाना 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
फ़ील्ड
periods[]

object (TimePeriod)

ज़रूरी है. यह जानकारी कि यह जगह कारोबार के लिए कब-कब खुली रहती है. हर समयावधि, हफ़्ते के दौरान कारोबार के खुले होने के घंटों की रेंज दिखाती है.

TimePeriod

इससे पता चलता है कि कारोबार कितने समय तक खुला रहता है. इसमें कारोबार के खुलने और बंद होने के दिन और समय की जानकारी शामिल होती है. कारोबार बंद होने का समय, उसके खुलने के समय के बाद का होना चाहिए. उदाहरण के लिए, उसी दिन बाद का समय या उसके बाद के किसी दिन का समय.

JSON के काेड में दिखाना 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
फ़ील्ड
openDay

enum (DayOfWeek)

ज़रूरी है. इससे पता चलता है कि यह अवधि day of the week को शुरू होगी.
openTime

object (TimeOfDay)

ज़रूरी है. मान्य वैल्यू 00:00 से 24:00 तक होती हैं. यहां 24:00 का मतलब, तय किए गए दिन के फ़ील्ड के आखिर में आधी रात से है. ध्यान दें: Proto3 JSON मैपिंग में, डिफ़ॉल्ट शून्य वैल्यू (00:00) को शामिल नहीं किया जाता. इससे openTime के लिए {} जनरेट होता है.
closeDay

enum (DayOfWeek)

ज़रूरी है. इससे पता चलता है कि यह अवधि day of the week को खत्म होगी.
closeTime

object (TimeOfDay)

ज़रूरी है. मान्य वैल्यू 00:00-24:00 हैं. इसमें 24:00 का मतलब, दिन के आखिर में आधी रात से है. ध्यान दें: Proto3 JSON मैपिंग में, डिफ़ॉल्ट शून्य वैल्यू (00:00) को शामिल नहीं किया जाता. इससे closeTime के लिए {} जनरेट होता है.

DayOfWeek

यह हफ़्ते के किसी दिन को दिखाता है.

Enums
DAY_OF_WEEK_UNSPECIFIED हफ़्ते के दिन की जानकारी नहीं दी गई है.
MONDAY सोमवार
TUESDAY मंगलवार
WEDNESDAY बुधवार
THURSDAY गुरुवार
FRIDAY शुक्रवार
SATURDAY शनिवार
SUNDAY रविवार

TimeOfDay

यह दिन के किसी समय को दिखाता है. तारीख और टाइम ज़ोन या तो अहम नहीं हैं या उन्हें कहीं और बताया गया है. कोई एपीआई, लीप सेकंड की अनुमति दे सकता है. इससे मिलते-जुलते टाइप हैं: google.type.Date और google.protobuf.Timestamp.

JSON के काेड में दिखाना 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
फ़ील्ड
hours

integer

दिन के घंटे, 24 घंटे वाले फ़ॉर्मैट में. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह 23 से कम या इसके बराबर होनी चाहिए. कारोबार के बंद होने के समय जैसी स्थितियों के लिए, एपीआई "24:00:00" वैल्यू की अनुमति दे सकता है.
minutes

integer

एक घंटे के मिनट. यह वैल्यू 0 से ज़्यादा या इसके बराबर और 59 से कम या इसके बराबर होनी चाहिए.
seconds

integer

एक मिनट में कितने सेकंड होते हैं. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह 59 से कम या इसके बराबर होनी चाहिए. अगर कोई एपीआई लीप सेकंड की अनुमति देता है, तो वह 60 वैल्यू की अनुमति दे सकता है.
nanos

integer

सेकंड के हिस्से, नैनोसेकंड में. यह वैल्यू 0 से ज़्यादा या इसके बराबर और 99,99,99,999 से कम या इसके बराबर होनी चाहिए.

SpecialHours

यह समयावधि के उस सेट को दिखाता है जब किसी जगह के खुले होने का समय, कारोबार के खुले होने के सामान्य समय से अलग होता है.

JSON के काेड में दिखाना 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
फ़ील्ड
specialHourPeriods[]

object (SpecialHourPeriod)

ज़रूरी है. कारोबार के सामान्य कामकाजी घंटों के अपवादों की सूची.

SpecialHourPeriod

यह उस समयावधि को दिखाता है जब किसी जगह के खुले होने का समय, कारोबार के खुले होने के सामान्य समय से अलग होता है. खास घंटों की अवधि, 24 घंटे से कम होनी चाहिए. openTime और startDate की वैल्यू, closeTime और endDate की वैल्यू से पहले की होनी चाहिए. closeTime और endDate को, तय की गई startDate के अगले दिन सुबह 11:59 बजे तक बढ़ाया जा सकता है. उदाहरण के लिए, ये इनपुट मान्य हैं:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

ये इनपुट मान्य नहीं हैं:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON के काेड में दिखाना 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
फ़ील्ड
startDate

object (Date)

ज़रूरी है. कैलेंडर की वह तारीख जब खास घंटे की यह अवधि शुरू होती है.
openTime

object (TimeOfDay)

ज़रूरी नहीं. मान्य वैल्यू 00:00 से 24:00 तक होती हैं. इसमें 24:00 का मतलब, दिन के आखिर में आधी रात से है. अगर closed की वैल्यू false है, तो यह वैल्यू देना ज़रूरी है.
endDate

object (Date)

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

object (TimeOfDay)

ज़रूरी नहीं. मान्य वैल्यू 00:00-24:00 हैं. इसमें 24:00 का मतलब, तय किए गए दिन के फ़ील्ड के आखिर में आधी रात से है. अगर closed की वैल्यू false है, तो यह वैल्यू देना ज़रूरी है.
closed

boolean

ज़रूरी नहीं. अगर इसकी वैल्यू true पर सेट है, तो endDate, openTime, और closeTime को अनदेखा कर दिया जाता है. साथ ही, startDate में बताई गई तारीख को, कारोबार की जगह पूरे दिन के लिए बंद मानी जाती है.

तारीख

यह कैलेंडर की पूरी या कुछ तारीखों को दिखाता है, जैसे कि जन्मदिन. दिन के समय और टाइम ज़ोन की जानकारी कहीं और दी गई है या यह जानकारी ज़रूरी नहीं है. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य न हो.
  • महीना और दिन, जिसमें साल की वैल्यू शून्य हो (उदाहरण के लिए, सालगिरह).
  • सिर्फ़ साल की जानकारी, जिसमें महीने और दिन की जानकारी शून्य हो.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. यह 1 से 9999 के बीच होना चाहिए. इसके अलावा, साल के बिना तारीख बताने के लिए 0 होना चाहिए.
month

integer

साल का महीना. यह 1 से 12 के बीच होना चाहिए. इसके अलावा, महीने और दिन के बिना साल की जानकारी देने के लिए, 0 डालें.
day

integer

महीने का दिन. यह वैल्यू 1 से 31 के बीच होनी चाहिए. साथ ही, साल और महीने के लिए मान्य होनी चाहिए. इसके अलावा, साल या साल और महीने की जानकारी देने के लिए, 0 डालें. ऐसा तब करें, जब दिन की जानकारी देना ज़रूरी न हो.

ServiceAreaBusiness

घर या दुकान पर सेवा देने वाले कारोबार, ग्राहकों के पते पर जाकर सेवाएं देते हैं. उदाहरण के लिए, ताला ठीक करने वाला या प्लंबर.

JSON के काेड में दिखाना 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
फ़ील्ड
businessType

enum (BusinessType)

ज़रूरी है. यह घर या दुकान पर सेवा देने वाले कारोबार के [टाइप] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] के बारे में बताता है.
places

object (Places)

ज़रूरी नहीं. वह इलाका जहां यह कारोबार सेवा देता है. इस इलाके को जगहों के सेट के ज़रिए तय किया जाता है.
regionCode

string

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

यह फ़ील्ड, CUSTOMER_LOCATION_ONLY कारोबारों के लिए ज़रूरी है. अन्य कारोबारों के लिए, इसे अनदेखा कर दिया जाता है.

यहां बताया गया देश या इलाका, उन इलाकों से अलग हो सकता है जहां यह कारोबार अपनी सेवाएं देता है. उदाहरण के लिए, घर या दुकान पर सेवा देने वाले कारोबार, अपने देश या इलाके के अलावा अन्य इलाकों में भी सेवाएं देते हैं.

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

BusinessType

इससे पता चलता है कि यह कारोबार, सिर्फ़ ग्राहक की जगह पर सेवाएं देता है (उदाहरण के लिए, टो ट्रक) या कारोबार के पते और ग्राहक की जगह, दोनों पर सेवाएं देता है (उदाहरण के लिए, डाइनिंग एरिया वाला पिज़्ज़ा स्टोर, जो ग्राहकों को डिलीवरी भी करता है).

Enums
BUSINESS_TYPE_UNSPECIFIED सिर्फ़ आउटपुट के लिए. जानकारी नहीं दी गई है.
CUSTOMER_LOCATION_ONLY सिर्फ़ आस-पास के इलाके में सेवा देता है (कारोबार के पते पर नहीं). अगर किसी कारोबार की जगह की जानकारी को CUSTOMER_AND_BUSINESS_LOCATION से CUSTOMER_LOCATION_ONLY पर अपडेट किया जा रहा है, तो जगह की जानकारी के अपडेट में फ़ील्ड मास्क storefrontAddress शामिल होना चाहिए. साथ ही, फ़ील्ड को खाली पर सेट करना चाहिए.
CUSTOMER_AND_BUSINESS_LOCATION कारोबार के पते और आस-पास के इलाके में सेवा देता है.

जगहें

इससे जगहों के सेट से दिखाए गए इलाकों के यूनियन के बारे में पता चलता है.

JSON के काेड में दिखाना 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
फ़ील्ड
placeInfos[]

object (PlaceInfo)

ज़रूरी नहीं. जगह के आईडी से दिखाए गए इलाके. ज़्यादा से ज़्यादा 20 जगहों की जानकारी जोड़ी जा सकती है.

PlaceInfo

इससे उस इलाके के बारे में पता चलता है जिसे जगह के आईडी से दिखाया जाता है.

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

string

ज़रूरी है. जगह का स्थानीय नाम. उदाहरण के लिए, Scottsdale, AZ.
placeId

string

ज़रूरी है. जगह का आईडी. यह किसी देश या इलाके से जुड़ा होना चाहिए. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

AdWords में दिखने वाली अतिरिक्त जानकारी.

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

string

ज़रूरी है. AdWords लोकेशन एक्सटेंशन पर, जगह के मुख्य फ़ोन नंबर के बजाय दिखाने के लिए कोई दूसरा फ़ोन नंबर.

LatLng

अक्षांश/देशांतर के जोड़े को दिखाने वाला ऑब्जेक्ट. इसे डबल के पेयर के तौर पर दिखाया जाता है, ताकि अक्षांश और देशांतर की डिग्री दिखाई जा सके. जब तक कोई और जानकारी न दी गई हो, तब तक इस ऑब्जेक्ट को WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज में होनी चाहिए.

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

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

OpenInfo

कारोबार के खुलने की स्थिति से जुड़ी जानकारी.

JSON के काेड में दिखाना 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
फ़ील्ड
status

enum (OpenForBusiness)

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

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि इस कारोबार को फिर से खोला जा सकता है या नहीं.
openingDate

object (Date)

ज़रूरी नहीं. वह तारीख जब कारोबार की जगह पहली बार खुली. अगर आपको सटीक तारीख नहीं पता है, तो सिर्फ़ महीना और साल की जानकारी दी जा सकती है. तारीख, आज से पहले की होनी चाहिए या आज से एक साल बाद की नहीं होनी चाहिए.

OpenForBusiness

इससे किसी जगह की स्थिति का पता चलता है.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED जानकारी नहीं दी गई है.
OPEN इससे पता चलता है कि कारोबार खुला है.
CLOSED_PERMANENTLY इससे पता चलता है कि कारोबार हमेशा के लिए बंद हो गया है.
CLOSED_TEMPORARILY इससे पता चलता है कि कारोबार कुछ समय के लिए बंद है.

मेटाडेटा

जगह के बारे में ऐसी अतिरिक्त जानकारी जिसमें उपयोगकर्ता बदलाव नहीं कर सकता.

JSON के काेड में दिखाना 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
फ़ील्ड
hasGoogleUpdated

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि इस जगह की किसी प्रॉपर्टी में बदलाव करने की प्रोसेस बाकी है या नहीं.
canDelete

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि एपीआई का इस्तेमाल करके, जगह की जानकारी मिटाई जा सकती है या नहीं.
canOperateLocalPost
(deprecated)

boolean

सिर्फ़ आउटपुट के लिए. अब इस्तेमाल नहीं किया जा सकता: इस फ़ील्ड में अब डेटा नहीं भरा जाता. इसे आने वाले वर्शन में हटा दिया जाएगा.
canModifyServiceList

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि लिस्टिंग में, सेवाओं की सूची में बदलाव किया जा सकता है या नहीं.
canHaveFoodMenus

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि लिस्टिंग, खाने के मेन्यू की ज़रूरी शर्तें पूरी करती है या नहीं.
canOperateHealthData

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि जगह की जानकारी की सेटिंग, सेहत के डेटा पर काम कर सकती है या नहीं.
canOperateLodgingData

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि कारोबार की जगह, ठहरने की जगह के डेटा पर काम कर सकती है या नहीं.
placeId

string

सिर्फ़ आउटपुट के लिए. अगर यह जगह Google Maps पर दिखती है, तो इस फ़ील्ड में जगह का आईडी अपने-आप भर जाता है. इस आईडी का इस्तेमाल, अलग-अलग Places API में किया जा सकता है.

इस फ़ील्ड को Create कॉल के दौरान सेट किया जा सकता है, लेकिन Update के लिए नहीं.
duplicateLocation

string

सिर्फ़ आउटपुट के लिए. वह जगह जिसका यह डुप्लीकेट है.
mapsUri

string

सिर्फ़ आउटपुट के लिए. Maps पर जगह की जानकारी का लिंक.
newReviewUri

string

सिर्फ़ आउटपुट के लिए. Google Search पर मौजूद उस पेज का लिंक जहां ग्राहक, कारोबार की जगह के लिए समीक्षा लिख सकता है.
canHaveBusinessCalls

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि लिस्टिंग, कारोबार के लिए कॉल की सुविधा पाने की ज़रूरी शर्तें पूरी करती है या नहीं.
hasVoiceOfMerchant

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि लिस्टिंग में कारोबारी या कंपनी की आवाज़ है या नहीं. अगर यह बूलियन वैल्यू 'गलत है' पर सेट है, तो आपको locations.getVoiceOfMerchantState एपीआई को कॉल करना चाहिए. इससे आपको यह जानकारी मिलेगी कि कारोबार के पास Voice of Merchant की सुविधा क्यों नहीं है.
isParticularlyPersonalPlace

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि जगह को निजी जगह के तौर पर कैटगरी में रखा गया है या नहीं. इसका मतलब है कि जगह की जानकारी के इतिहास की सुविधाओं पर पाबंदियां लगी हैं. अगर आपको लगता है कि यह गलती से हुआ है, तो सहायता केंद्र में मौजूद लेख पढ़ें.

प्रोफ़ाइल

जगह की प्रोफ़ाइल से जुड़ी सारी जानकारी.

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

string

ज़रूरी है. जगह की जानकारी आपकी आवाज़ में रिकॉर्ड की गई हो. इसे कोई और व्यक्ति एडिट न कर सके.

RelationshipData

इस जगह से जुड़ी सभी पैरंट और चाइल्ड जगहों की जानकारी.

JSON के काेड में दिखाना 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
फ़ील्ड
parentLocation

object (RelevantLocation)

ज़रूरी नहीं. वह पैरंट लोकेशन जिससे यह लोकेशन जुड़ी है.
childrenLocations[]

object (RelevantLocation)

ज़रूरी नहीं. उन चाइल्ड लोकेशन की सूची जिनसे इस लोकेशन का संबंध है.
parentChain

string

ज़रूरी नहीं. उस चेन का रिसॉर्स नेम जिसकी यह जगह सदस्य है. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

मौजूदा जगह से जुड़ी किसी दूसरी जगह की जानकारी. यह संबंध DEPARTMENT_OF या INDEPENDENT_ESTABLISHMENT_OF में से कोई एक हो सकता है. साथ ही, यहां बताई गई जगह, जगह के किसी भी तरफ़ (पैरंट/चाइल्ड) हो सकती है.

JSON के काेड में दिखाना 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
फ़ील्ड
placeId

string

ज़रूरी है. रिलेशन के दूसरी तरफ़ मौजूद जगह की जानकारी, उसके placeID से दें.
relationType

enum (RelationType)

ज़रूरी है. संबंध का टाइप.

RelationType

टाइप रिलेशन के बारे में जानकारी देना ज़रूरी है.

Enums
RELATION_TYPE_UNSPECIFIED टाइप नहीं बताया गया.
DEPARTMENT_OF यह दो ऐसी जगहों के बीच संबंध दिखाता है जो एक ही जगह पर मौजूद हैं. साथ ही, उनका ब्रैंड/मैनेजमेंट/संगठन एक ही है, लेकिन स्टोर के खुले रहने का समय या फ़ोन नंबर जैसे मुख्य एट्रिब्यूट अलग-अलग हैं. उदाहरण के लिए, Costco Pharmacy, Costco Wholesale का एक डिपार्टमेंट है.
INDEPENDENT_ESTABLISHMENT_IN यह उन मामलों को दिखाता है जहां दो कारोबार एक ही जगह पर मौजूद होते हैं, लेकिन वे अलग-अलग कंपनियों के होते हैं. जैसे, Safeway में Starbucks, मॉल में दुकानें.

MoreHours

वह समयावधि जब कोई जगह, कुछ खास तरह के कारोबारों के लिए खुली रहती है.

JSON के काेड में दिखाना 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
फ़ील्ड
hoursTypeId

string

ज़रूरी है. खुले होने के समय का टाइप. क्लाइंट को {#link businessCategories:BatchGet} को कॉल करना चाहिए, ताकि वे अपने कारोबार की जगहों की कैटगरी के लिए, खुले होने के समय के टाइप की जानकारी पा सकें.
periods[]

object (TimePeriod)

ज़रूरी है. इस जगह के खुले होने का समय. हर समयावधि, हफ़्ते के दौरान कारोबार के खुले होने के घंटों की रेंज दिखाती है.

ServiceItem

ऐसा मैसेज जिसमें सेवा के किसी एक आइटम के बारे में बताया गया हो. इसका इस्तेमाल, कारोबारी या कंपनी की ओर से दी जाने वाली सेवा के बारे में बताने के लिए किया जाता है. उदाहरण के लिए, बाल काटना एक सेवा हो सकती है.

JSON के काेड में दिखाना 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
price

object (Money)

ज़रूरी नहीं. इससे सेवा आइटम की कीमत का पता चलता है. हमारा सुझाव है कि कीमत शामिल करते समय, currencyCode और units को सेट किया जाना चाहिए. इसे सेवा आइटम के लिए फ़िक्स्ड प्राइस माना जाएगा.
इनमें से किसी एक फ़ील्ड को हमेशा सेट किया जाना चाहिए. यहां उन फ़ील्ड की सूची दी गई है जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
structuredServiceItem

object (StructuredServiceItem)

ज़रूरी नहीं. यह फ़ील्ड, स्ट्रक्चर्ड सेवाओं के डेटा के मामले में सेट किया जाएगा.
freeFormServiceItem

object (FreeFormServiceItem)

ज़रूरी नहीं. यह फ़ील्ड, फ़्री-फ़ॉर्म सेवाओं के डेटा के मामले में सेट किया जाएगा.
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

StructuredServiceItem

यह व्यापारी/कंपनी की ओर से दी जाने वाली स्ट्रक्चर्ड सेवा को दिखाता है. उदाहरण के लिए: toilet_installation.

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

string

ज़रूरी है. serviceTypeId फ़ील्ड, Google से मिला एक यूनीक आईडी है, जो ServiceType में मिल सकता है. यह जानकारी, categories.batchGet आरपीसी सेवा से मिली है.
description

string

ज़रूरी नहीं. स्ट्रक्चर्ड सेवा आइटम की जानकारी. इसमें ज़्यादा से ज़्यादा 300 वर्ण हो सकते हैं.

FreeFormServiceItem

यह कारोबारी या कंपनी की ओर से दी जाने वाली फ़्री-फ़ॉर्म सेवा को दिखाता है. ये ऐसी सेवाएं हैं जो हमारे स्ट्रक्चर्ड सर्विस डेटा के हिस्से के तौर पर नहीं दिखती हैं. व्यापारी/कंपनी, जियोमर्चेंट प्लैटफ़ॉर्म का इस्तेमाल करके, ऐसी सेवाओं के नाम मैन्युअल तरीके से डालती है.

JSON के काेड में दिखाना 
{
  "category": string,
  "label": {
    object (Label)
  }
}
फ़ील्ड
category

string

ज़रूरी है. यह फ़ील्ड, कैटगरी का नाम दिखाता है. जैसे, कैटगरी का स्टेबल आईडी. category और serviceTypeId, Category मैसेज में दिए गए संभावित कॉम्बिनेशन से मेल खाने चाहिए.
label

object (Label)

ज़रूरी है. आइटम के लिए, भाषा के हिसाब से टैग किए गए लेबल. हमारा सुझाव है कि आइटम के नाम 140 या इससे कम वर्णों के हों और ब्यौरे 250 या इससे कम वर्णों के हों. इस फ़ील्ड को सिर्फ़ तब सेट किया जाना चाहिए, जब इनपुट कोई कस्टम सेवा आइटम हो. सेवा के स्टैंडर्ड टाइप को serviceTypeId का इस्तेमाल करके अपडेट किया जाना चाहिए.

लेबल

कीमत की सूची, सेक्शन या आइटम दिखाते समय इस्तेमाल किया जाने वाला लेबल.

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

string

ज़रूरी है. कीमत की सूची, सेक्शन या आइटम का डिसप्ले नेम.
description

string

ज़रूरी नहीं. कीमत की सूची, सेक्शन या आइटम का ब्यौरा.
languageCode

string

ज़रूरी नहीं. वह BCP-47 भाषा कोड जिस पर ये स्ट्रिंग लागू होती हैं. हर भाषा के लिए, लेबल का सिर्फ़ एक सेट सेट किया जा सकता है.

पैसे

यह मुद्रा के टाइप के साथ रकम को दिखाता है.

JSON के काेड में दिखाना 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
फ़ील्ड
currencyCode

string

ISO 4217 में तय किया गया तीन अक्षरों वाला करंसी कोड.
units

string (int64 format)

रकम की पूरी इकाइयां. उदाहरण के लिए, अगर currencyCode की वैल्यू "USD" है, तो एक यूनिट का मतलब एक डॉलर है.
nanos

integer

रकम की नैनो (10^-9) यूनिट की संख्या. वैल्यू, -999,999,999 और +999,999,999 के बीच की होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. अगर units पॉज़िटिव है, तो nanos पॉज़िटिव या शून्य होना चाहिए. अगर units शून्य है, तो nanos पॉज़िटिव, शून्य या नेगेटिव हो सकता है. अगर units नेगेटिव है, तो nanos नेगेटिव या शून्य होना चाहिए. उदाहरण के लिए, -1.75 डॉलर को units=-1 और nanos=-750,000,000 के तौर पर दिखाया जाता है.

तरीके

create

 यह एपीआई, कारोबार की एक नई जगह बनाता है. इसका मालिकाना हक, लॉग इन किए हुए उपयोगकर्ता के पास होगा.

list

 यह तय किए गए खाते की जगहों की सूची दिखाता है.