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

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

string

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

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

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

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

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

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

นอกจากนี้ยังมีสถานที่บางแห่งที่ผู้ใช้ 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