Method: customers.profiles.list

แสดงรายการโปรไฟล์เบราว์เซอร์ Chrome ของลูกค้าตามเกณฑ์การค้นหาและการจัดเรียงที่ระบุ

คำขอ HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

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

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

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

string

ต้องระบุ รูปแบบ: customers/{customer_id}

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

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

integer

ไม่บังคับ จํานวนโปรไฟล์สูงสุดที่จะแสดง ขนาดหน้าเริ่มต้นคือ 100 หากไม่ได้ระบุ pageSize และขนาดหน้าสูงสุดที่อนุญาตคือ 200
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ใช้ดึงข้อมูลหน้าที่ต้องการของคำขอข้อมูล
filter

string

ไม่บังคับ ตัวกรองที่ใช้กรองโปรไฟล์ ฟิลด์ต่อไปนี้สามารถใช้ในตัวกรองได้

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

คุณใช้ฟิลด์ใดก็ได้ข้างต้นเพื่อระบุตัวกรอง และระบบรองรับการกรองตามหลายฟิลด์ด้วยโอเปอเรเตอร์ AND ฟิลด์ประเภทสตริงและฟิลด์ประเภท Enum รองรับโอเปอเรเตอร์ "=" และ "!=" ฟิลด์ประเภทจำนวนเต็มและฟิลด์ประเภทการประทับเวลารองรับโอเปอเรเตอร์ "=", "!=", "<", ">", "<=" และ ">=" การประทับเวลาต้องใช้สตริงรูปแบบ RFC-3339 (เช่น 2012-04-21T11:30:00-04:00) คุณใช้ไวลด์การ์ด "*" กับตัวกรองช่องประเภทสตริงได้ นอกจากนี้ ระบบยังรองรับการกรองสตริงตัวอักษรล้วน เช่น "ABC" เป็นตัวกรองที่แมปกับตัวกรองที่ตรวจสอบว่าช่องประเภทสตริงที่กรองได้มี "ABC" หรือไม่

คุณสามารถใช้หมายเลขหน่วยขององค์กรเป็นเกณฑ์การกรองได้ที่นี่โดยระบุ "ouId = ${your_org_unit_id}" โปรดทราบว่าระบบรองรับการจับคู่รหัส OU รายการเดียวเท่านั้น
orderBy

string

ไม่บังคับ ฟิลด์ที่ใช้ระบุลําดับของผลลัพธ์ ฟิลด์ที่รองรับ ได้แก่

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

โดยค่าเริ่มต้น ระบบจะจัดเรียงจากน้อยไปมาก หากต้องการระบุลําดับจากมากไปน้อยสําหรับช่องหนึ่งๆ ให้เพิ่มส่วนต่อท้าย " desc" ต่อท้ายชื่อช่อง การจัดเรียงเริ่มต้นคือลําดับจากมากไปน้อยของ lastStatusReportTime

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

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

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

การตอบสนองต่อเมธอด profiles.list

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

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

object (ChromeBrowserProfile)

รายการโปรไฟล์ที่แสดง
nextPageToken

string

โทเค็นการแบ่งหน้าเว็บที่ใช้แสดงรายการในหน้าถัดไปได้
totalSize

string (int64 format)

ขนาดทั้งหมดแสดงจํานวนทรัพยากรโดยประมาณที่แสดงผล ไม่มีการรับประกันความถูกต้องเมื่อโปรไฟล์มีจำนวนมากกว่า 10,000 รายการ

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

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

  • https://www.googleapis.com/auth/chrome.management.profiles.readonly
  • https://www.googleapis.com/auth/chrome.management.profiles