Method: accounts.locations.findMatches

ค้นหาสถานที่ตั้งที่เป็นไปได้ทั้งหมดที่ตรงกับสถานที่ตั้งที่ระบุ การดำเนินการนี้จะใช้ได้ต่อเมื่อสถานที่ไม่ได้รับการยืนยันเท่านั้น

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ชื่อทรัพยากรของสถานที่ตั้งที่จะค้นหารายการที่ตรงกัน

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
ช่อง
languageCode

string

ภาษาที่ต้องการใช้กับสถานที่ตั้งที่ตรงกัน (ในรูปแบบ BCP-47)
numResults

integer

จำนวนรายการที่ตรงกันที่จะแสดงผล ค่าเริ่มต้นคือ 3 โดยมีค่าสูงสุดคือ 10 โปรดทราบว่าเวลาในการตอบสนองอาจเพิ่มขึ้นหากมีการขอเพิ่ม โดยไม่ต้องใส่เลขหน้า
maxCacheDuration

string (Duration format)

เลิกใช้งานแล้ว ฟิลด์นี้จะละเว้นสำหรับคำขอทั้งหมด

ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" เช่น "3.5s"

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ข้อความตอบกลับสำหรับ Locations.FindMatchingLocations

การแสดง JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
ช่อง
matchedLocations[]

object (MatchedLocation)

คอลเล็กชันของสถานที่ตั้งที่อาจตรงกับสถานที่ที่ระบุ โดยเรียงตามลำดับจากดีที่สุดไปน้อยที่สุด หากมีการจับคู่ที่ตรงกันทั้งหมด รายการดังกล่าวจะอยู่ในตำแหน่งแรก
matchTime

string (Timestamp format)

เวลาที่อัลกอริทึมการจับคู่ถูกเรียกใช้ครั้งสุดท้ายสำหรับตำแหน่งนี้

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "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)

สถานที่ตั้งที่มีประชากรเบาบางซึ่งอาจตรงกับสถานที่ดังกล่าว ช่องที่ไม่ได้ป้อนข้อมูลรวมถึงแต่ไม่จํากัดเพียงชื่อ (ระบบดึงข้อมูลสถานที่ตั้งที่ตรงกันผ่าน locations.get หรือ locations.batchGet ไม่ได้), storeCode, serviceArea รายละเอียดพื้นที่ที่ครอบคลุม, labels, adWordsLocationExtensions, photos
isExactMatch

boolean

รายการนี้ตรงกันทั้งหมดไหม