Method: customers.chromeBrowsers.list

Truy xuất tất cả Trình duyệt Chrome của một khách hàng (được phân trang).

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
parent

string

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

Tham số truy vấn

Thông số
pageSize

integer

Không bắt buộc. Số lượng kết quả tối đa cần trả về. Giá trị tối đa và mặc định là 100.

pageToken

string

Không bắt buộc. Mã thông báo để chỉ định trang tiếp theo trong danh sách.

filter

string

Không bắt buộc. Bộ lọc dùng để lọc trình duyệt. Bạn có thể sử dụng các trường sau trong bộ lọc:

  • browser_permanent_id
  • last_policy_fetch_time
  • os_platform
  • os_architecture
  • os_version
  • machine_name
  • annotated_location
  • annotated_user
  • annotated_asset_id
  • annotated_note
  • org_unit_path
  • org_unit_id
  • last_registration_time
  • os_platform_version
  • browser_version
  • last_status_report_time
  • extension_count
  • policy_count
  • last_device_user
  • last_activity_time
  • device_id_collision

Bạn có thể sử dụng các hàm sau trong bộ lọc:

  • in_group(string): Lọc những trình duyệt thuộc tên tài nguyên nhóm Cloud Identity được chỉ định (ví dụ: in_group("groups/{groupId}")).

Bạn có thể sử dụng bất kỳ trường hoặc hàm nào ở trên để chỉ định bộ lọc. Ngoài ra, bạn có thể lọc theo nhiều trường hoặc hàm bằng toán tử AND. Các trường loại Chuỗi, loại Số nguyên và loại enum hỗ trợ toán tử = và :. Các trường loại dấu thời gian hỗ trợ toán tử =, <= và >=. Dấu thời gian cần có một chuỗi được định dạng theo RFC-3339 và nằm trong dấu ngoặc kép (ví dụ: "2012-04-21T11:30:00-04:00"). Ký tự đại diện * chỉ được hỗ trợ cho machine_name, annotated_asset_id và browser_version. Ngoài ra, bạn có thể lọc chuỗi ký tự chung mà không cần tên trường: một cụm từ (ví dụ: ABC) sẽ khớp nếu bất kỳ trường chuỗi nào được lập chỉ mục có chứa ABC, và nhiều cụm từ được nối bằng AND hoặc dấu cách (ví dụ: machine AND 73 hoặc machine 73) sẽ khớp với các trình duyệt mà mọi cụm từ đều xuất hiện trong ít nhất một trường chuỗi được lập chỉ mục (trong khi một cụm từ trong dấu ngoặc kép như "machine 73" sẽ khớp với cụm từ liền kề trong một trường).

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à:

  • browser_permanent_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_version

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

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 chromeBrowsers.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
{
  "chromeBrowsers": [
    {
      object (ChromeBrowser)
    }
  ],
  "nextPageToken": string
}
Trường
chromeBrowsers[]

object (ChromeBrowser)

Danh sách đối tượng thiết bị của Trình duyệt Chrome.

nextPageToken

string

Mã thông báo dùng để truy cập vào trang tiếp theo của kết quả này.

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.browsers.readonly
  • https://www.googleapis.com/auth/chrome.management.browsers