REST Resource: 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)

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

तरीके

delete

 किसी जगह की जानकारी मिटाता है.

get

 यह कारोबारी या कंपनी की ओर से सेट की गई आखिरी जगह की जानकारी दिखाता है.

getAttributes

 कारोबारी या कंपनी ने किसी जगह के लिए जो एट्रिब्यूट आखिरी बार सेट किए थे उन्हें वापस लाता है.

getGoogleUpdated

 यह Google Maps और Search पर लाइव दिखने वाली जगह की जानकारी दिखाता है.

patch

 यह जगह की जानकारी को अपडेट करता है.

updateAttributes

 किसी जगह के लिए एट्रिब्यूट अपडेट करना.