Method: accounts.locations.findMatches

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

एचटीटीपी अनुरोध

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:findMatches

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

मिलान ढूंढने के लिए जगह का संसाधन नाम.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

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

string

मैच होने वाली जगह के लिए पसंदीदा भाषा (BCP-47 फ़ॉर्मैट में).
numResults

integer

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

string (Duration format)

समर्थन नहीं होना या रुकना. इस फ़ील्ड को सभी अनुरोधों के लिए अनदेखा कर दिया जाता है.

सेकंड में कुल नौ दशमलव अंकों वाली अवधि, जिसे 's' से खत्म किया जाता है. उदाहरण: "3.5s".

जवाब का मुख्य भाग

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

Places.FindMatchingLocations के लिए जवाब मैसेज.

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

object (MatchedLocation)

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

string (Timestamp format)

इस जगह के लिए, मिलते-जुलते एल्गोरिदम को पिछली बार कब चलाया गया था.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

अनुमति पाने के लिंक

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

MatchedLocation

यह किसी जगह से मिलती-जुलती जगह के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
फ़ील्ड
location

object (Location)

कम जनसंख्या वाली जगह, जो आपके कॉन्टेंट से मेल खाती हो. भरे हुए फ़ील्ड में ये शामिल हैं, लेकिन इनके अलावा और भी चीज़ें शामिल हो सकती हैं: name (मेल खाने वाली जगह की जानकारी, locations.get और locations.batchGet के ज़रिए नहीं पाई जा सकती); storeCode; serviceArea कवरेज एरिया की जानकारी; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

क्या यह एग्ज़ैक्ट मैच है?