Method: customers.profiles.list

Liệt kê hồ sơ của một khách hàng trên trình duyệt Chrome dựa trên tiêu chí tìm kiếm và sắp xếp đã cho.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Định dạng: customers/{customer_id}

Tham số truy vấn

Thông số
pageSize

integer

Không bắt buộc. Số lượng hồ sơ tối đa cần trả về. Kích thước trang mặc định là 100 nếu bạn không chỉ định pageSize và kích thước trang tối đa được phép là 200.
pageToken

string

Không bắt buộc. Mã thông báo trang dùng để truy xuất một trang cụ thể của yêu cầu trang thông tin.
filter

string

Không bắt buộc. Bộ lọc được dùng để lọc hồ sơ. Bạn có thể dùng các trường sau trong bộ lọc:

  • profileId
  • Tên hiển thị
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • ouId

Bạn có thể sử dụng bất kỳ trường nào ở trên để chỉ định bộ lọc và lọc theo nhiều trường bằng toán tử AND. Các trường loại chuỗi và trường loại enum hỗ trợ toán tử "=" và "!=". Loại số nguyên và trường loại dấu thời gian hỗ trợ các toán tử "=", "!=", "<", ">", "<=" và ">=". Dấu thời gian phải là một chuỗi được định dạng theo RFC-3339 (ví dụ: 2012-04-21T11:30:00-04:00). Bạn có thể sử dụng ký tự đại diện "*" với bộ lọc trường kiểu chuỗi. Ngoài ra, tính năng lọc chuỗi cố định cũng được hỗ trợ, ví dụ: "ABC" dưới dạng bộ lọc liên kết với một bộ lọc kiểm tra xem có trường loại chuỗi nào có thể lọc chứa "ABC" hay không.

Bạn có thể sử dụng số đơn vị tổ chức làm tiêu chí lọc tại đây bằng cách chỉ định "ouId = ${your_org_unit_id}", xin lưu ý rằng chúng tôi chỉ hỗ trợ việc so khớp một mã đơn vị tổ chức.
orderBy

string

Không bắt buộc. Các trường dùng để chỉ định thứ tự của kết quả. Các trường được hỗ trợ là:

  • profileId
  • Tên hiển thị
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState

Theo mặc định, việc sắp xếp được thực hiện theo thứ tự tăng dần. Để chỉ định thứ tự giảm dần cho một trường, bạn phải thêm hậu tố " desc" vào tên trường. Thứ tự mặc định là thứ tự giảm dần của lastStatusReportTime.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho phương thức profiles.list.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Trường
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

Danh sách hồ sơ được trả về.
nextPageToken

string

Mã thông báo phân trang có thể dùng để liệt kê trang tiếp theo.
totalSize

string (int64 format)

Tổng kích thước biểu thị số lượng tài nguyên ước tính được trả về. Không đảm bảo tính chính xác đối với hơn 10.000 trang doanh nghiệp.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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