Method: accounts.locations.findMatches

बताई गई जगह से मेल खाने वाली सभी संभावित जगहें ढूंढता है. यह कार्रवाई सिर्फ़ तब मान्य होती है, जब जगह की पुष्टि नहीं हुई हो.

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

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

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

पाथ के पैरामीटर

पैरामीटर
name

string

जिस जगह से मिलती-जुलती जगह ढूंढना है उसके संसाधन का नाम.

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

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

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

string

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

integer

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

string (Duration format)

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

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

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

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

स्थानों के लिए जवाब संदेश.FindMatchingLocations.

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

object (MatchedLocation)

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

string (Timestamp format)

इस जगह के लिए, मैचिंग एल्गोरिदम को आखिरी बार कब लागू किया गया था.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "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

यह किसी जगह के मिलते-जुलते नतीजे दिखाता है.

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

object (Location)

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

boolean

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