Google Business Performance API มีเมธอด API ใหม่ที่อนุญาตให้ดึง `DailyMetrics` หลายรายการในคําขอ API รายการเดียว
ตรวจสอบกําหนดการเลิกใช้งานและวิธีการย้ายข้อมูลจากเมธอด v4 reportInsights API ไปยัง API ประสิทธิภาพของ Google Business Profile

Method: accounts.list

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

คำขอ HTTP

GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

ไม่บังคับ ชื่อทรัพยากรของบัญชีที่จะเรียกข้อมูลรายการบัญชีที่เข้าถึงโดยตรง ซึ่งจะเหมาะสมเฉพาะสําหรับองค์กรและกลุ่มผู้ใช้เท่านั้น หากเว้นว่างไว้ ระบบจะแสดงค่า accounts.list สําหรับผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ accounts/{account_id}

pageSize

integer

ไม่บังคับ จํานวนบัญชีที่จะดึงข้อมูลต่อหน้าเว็บ ค่าเริ่มต้นและค่าสูงสุดคือ 20

pageToken

string

ไม่บังคับ หากระบุ ระบบจะดึงหน้าถัดไปของบัญชี ระบบจะแสดงผล pageToken เมื่อการเรียกไปยัง accounts.list ได้ผลลัพธ์มากกว่าที่จะพอดีกับขนาดหน้าเว็บที่ขอ

filter

string

ไม่บังคับ ตัวกรองบังคับให้บัญชีต่างๆ กลับมา การตอบกลับจะรวมเฉพาะรายการที่ตรงกับตัวกรองเท่านั้น หาก filter ว่างเปล่า ระบบจะใช้ข้อจํากัดและดึงบัญชีทั้งหมด (ที่ใส่เลขหน้า) มาสําหรับบัญชีที่ขอ

ตัวอย่างเช่น คําขอที่มีตัวกรอง type=USER_GROUP จะแสดงกลุ่มผู้ใช้เท่านั้น

ช่อง type เป็นเพียงตัวกรองเดียวที่รองรับ

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

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

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

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

ข้อความตอบกลับสําหรับ Accounts.ListAccounts

การแสดง JSON
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
ช่อง
accounts[]

object (Account)

คอลเล็กชันของบัญชีที่ผู้ใช้มีสิทธิ์เข้าถึง บัญชีส่วนบุคคลของผู้ใช้ที่ทําการค้นหาจะเป็นรายการแรกของผลการค้นหาเสมอ เว้นแต่จะมีการกรองออก

nextPageToken

string

หากจํานวนบัญชีมีขนาดเกินหน้าที่ขอ ระบบจะเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของบัญชีในการเรียกใช้ accounts.list ครั้งถัดไป หากไม่มีบัญชีเพิ่มเติม ระบบจะแสดงช่องนี้ในการตอบกลับ

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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