ค้นหาสถานที่ตั้งที่เป็นไปได้ทั้งหมดที่ตรงกับสถานที่ตั้งที่ระบุ การดำเนินการนี้จะใช้ได้ต่อเมื่อสถานที่ไม่ได้รับการยืนยันเท่านั้น
คำขอ HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:findMatches
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
name |
ชื่อทรัพยากรของสถานที่ตั้งที่จะค้นหารายการที่ตรงกัน |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON | |
---|---|
{ "languageCode": string, "numResults": integer, "maxCacheDuration": string } |
ช่อง | |
---|---|
languageCode |
ภาษาที่ต้องการใช้กับสถานที่ตั้งที่ตรงกัน (ในรูปแบบ BCP-47) |
numResults |
จำนวนรายการที่ตรงกันที่จะแสดงผล ค่าเริ่มต้นคือ 3 โดยมีค่าสูงสุดคือ 10 โปรดทราบว่าเวลาในการตอบสนองอาจเพิ่มขึ้นหากมีการขอเพิ่ม โดยไม่ต้องใส่เลขหน้า |
maxCacheDuration |
เลิกใช้งานแล้ว ฟิลด์นี้จะละเว้นสำหรับคำขอทั้งหมด ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับสำหรับ Locations.FindMatchingLocations
การแสดง JSON | |
---|---|
{
"matchedLocations": [
{
object ( |
ช่อง | |
---|---|
matchedLocations[] |
คอลเล็กชันของสถานที่ตั้งที่อาจตรงกับสถานที่ที่ระบุ โดยเรียงตามลำดับจากดีที่สุดไปน้อยที่สุด หากมีการจับคู่ที่ตรงกันทั้งหมด รายการดังกล่าวจะอยู่ในตำแหน่งแรก |
matchTime |
เวลาที่อัลกอริทึมการจับคู่ถูกเรียกใช้ครั้งสุดท้ายสำหรับตำแหน่งนี้ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต 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 |
รายการนี้ตรงกันทั้งหมดไหม |