REST Resource: locations

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

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

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

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

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