Method: googleLocations.search

ค้นหาสถานที่ที่เป็นไปได้ทั้งหมดที่ตรงกับคำขอที่ระบุ

คำขอ HTTP

POST https://mybusiness.googleapis.com/v4/googleLocations:search

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

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

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

การแสดง JSON
{
  "resultCount": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  },
  "query": string
  // End of list of possible types for union field search_query.
}
ช่อง
resultCount

integer

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

ฟิลด์การรวม search_query คำค้นหา ซึ่งสามารถระบุเป็นออบเจ็กต์ตำแหน่งหรือข้อความค้นหาแบบสตริงได้ search_query ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location

object (Location)

ตำแหน่งที่จะค้นหา หากระบุ ระบบจะค้นหาสถานที่ตั้งที่ตรงกับรายละเอียดสถานที่ตั้งที่ให้ไว้

query

string

ข้อความค้นหาที่จะค้นหา ผลการค้นหาจากสตริงคําค้นหาจะแม่นยําน้อยกว่าการระบุตําแหน่งที่แน่นอน แต่สามารถให้การจับคู่ที่ไม่ตรงกันได้มากกว่า

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

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

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

การแสดง JSON
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ]
}
ช่อง
googleLocations[]

object (GoogleLocation)

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

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0