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. - माउंटेन व्यू कॉर्पोरेट हेडक्वार्टर" के बजाय "Google" को प्राथमिकता दें. मार्केटिंग टैगलाइन, स्टोर कोड, खास वर्ण, कारोबार के खुले होने का समय या क्लोज़्ड/ओपन स्टेटस, फ़ोन नंबर, वेबसाइट के यूआरएल, सेवा/प्रॉडक्ट की जानकारी, जगह/पता या रास्ते की जानकारी या कंटेनमेंट की जानकारी (उदाहरण के लिए, "Duane Reade में चेज़ एटीएम") शामिल न करें.
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)

ज़रूरी नहीं. उपयोगकर्ता की ओर से दिया गया अक्षांश और देशांतर. जगह बनाते समय, अगर दिए गए पते को जियोकोड में शामिल कर लिया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है. यह फ़ील्ड, अनुरोध पाने पर सिर्फ़ तब दिखता है, जब उपयोगकर्ता से मिली 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 का अपडेट किया गया वर्शन मिलता है.

patch

 बताए गए स्थान को अपडेट करता है.

updateAttributes

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