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

นี่เป็นรายการที่ตรงกันทั้งหมดหรือไม่