Method: accounts.listRecommendGoogleLocations

แสดงรายการ GoogleLocation ทั้งหมดที่แนะนําให้กับบัญชี Business Profile ที่ระบุ คําแนะนํามีไว้สำหรับบัญชีส่วนตัวและกลุ่มสถานที่ตั้งเท่านั้น ส่วนคําขอสําหรับบัญชีประเภทอื่นๆ ทั้งหมดจะทำให้เกิดข้อผิดพลาด คําแนะนําสําหรับกลุ่มสถานที่ตั้งจะขึ้นอยู่กับสถานที่ตั้งในกลุ่มนั้น

คำแนะนำสำหรับบัญชีส่วนตัวจะอิงตามสถานที่ตั้งทั้งหมดที่ผู้ใช้มีสิทธิ์เข้าถึงใน Business Profile (ซึ่งรวมถึงสถานที่ที่เข้าถึงได้ผ่านกลุ่มสถานที่ตั้ง) และเป็นชุดคำแนะนำขั้นสูงจากคำแนะนำทั้งหมดที่สร้างขึ้นสำหรับผู้ใช้

คำขอ HTTP

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

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

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

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

string

ชื่อของทรัพยากรบัญชีสำหรับดึงข้อมูลสถานที่ที่แนะนำใน Google

พารามิเตอร์การค้นหา

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

integer

จำนวนสถานที่ที่จะดึงข้อมูลต่อหน้า ค่าเริ่มต้นคือ 25 ขั้นต่ำคือ 1 และขนาดสูงสุดคือ 100
pageToken

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าของสถานที่ถัดไป

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

เนื้อหาของคำขอต้องว่างเปล่า

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

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

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

ทั้งยังมีสถานที่ตั้งบางแห่งที่ผู้ใช้ Business Profile รายอื่นอ้างสิทธิ์ตั้งแต่ครั้งล่าสุดที่มีการแนะนำมายังบัญชี Business Profile นี้

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

object (GoogleLocation)

สถานที่ตั้งที่แนะนำให้กับบัญชี Business Profile แต่ละเหตุการณ์แสดงถึง GoogleLocation ที่มีอยู่บน Maps โดยจะจัดเรียงสถานที่ตั้งตามความเกี่ยวข้องกับบัญชี Business Profile จากมากไปหาน้อย
totalSize

integer

จำนวนสถานที่ตั้งที่แนะนำทั้งหมดสำหรับบัญชี Business Profile นี้ โดยไม่คำนึงถึงการใส่เลขหน้า
nextPageToken

string

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

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

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

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

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