Method: admin.directory.v1.customers.chrome.printers.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
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. Tên của khách hàng sở hữu bộ sưu tập máy in này. Định dạng: customers/{customer_id}
|
Tham số truy vấn
Thông số |
pageSize |
integer
Số lượng đối tượng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này.
|
pageToken |
string
Mã thông báo trang, nhận được từ một lệnh gọi trước đó.
|
orgUnitId |
string
Đơn vị tổ chức mà chúng ta muốn liệt kê máy in. Khi org_unit không có trong yêu cầu, tất cả máy in của khách hàng sẽ được trả về (hoặc được lọc). Khi org_unit có trong yêu cầu, hệ thống sẽ chỉ trả về những máy in có sẵn cho OU này (thuộc sở hữu hoặc được kế thừa). Bạn có thể xem liệu máy in có thuộc sở hữu hoặc được kế thừa cho OU này hay không bằng cách xem Printer.org_unit_id.
|
filter |
string
Cụm từ tìm kiếm. Cú pháp tìm kiếm được chia sẻ giữa api này và các trang máy in trong Bảng điều khiển dành cho quản trị viên.
|
orderBy |
string
Thứ tự sắp xếp kết quả. Phải là một trong các thuộc tính displayName, description, makeAndModel hoặc createTime. Thứ tự mặc định là tăng dần, nhưng bạn có thể trả về thứ tự giảm dần bằng cách thêm "desc" vào trường orderBy. Ví dụ: "description desc" sẽ trả về các máy in được sắp xếp theo nội dung mô tả theo thứ tự giảm dần.
|
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 việc đăng thông tin về máy in.
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 |
{
"printers": [
{
object (Printer )
}
],
"nextPageToken": string
} |
Trường |
printers[] |
object (Printer )
Danh sách máy in. Nếu bạn đã cung cấp orgUnitId trong yêu cầu, thì hệ thống sẽ chỉ trả về những máy in hiển thị cho OU này. Nếu bạn không cung cấp orgUnitId trong yêu cầu, thì tất cả máy in sẽ được trả về.
|
nextPageToken |
string
Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.
|
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/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-24 UTC."],[],[],null,["# Method: admin.directory.v1.customers.chrome.printers.list\n\nList printers configs.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the customer who owns this collection of printers. Format: customers/{customer_id} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of objects to return. The service may return fewer than this value. |\n| `pageToken` | `string` A page token, received from a previous call. |\n| `orgUnitId` | `string` Organization Unit that we want to list the printers for. When org_unit is not present in the request then all printers of the customer are returned (or filtered). When org_unit is present in the request then only printers available to this OU will be returned (owned or inherited). You may see if printer is owned or inherited for this OU by looking at Printer.org_unit_id. |\n| `filter` | `string` Search query. Search syntax is shared between this api and Admin Console printers pages. |\n| `orderBy` | `string` The order to sort results by. Must be one of displayName, description, makeAndModel, or createTime. Default order is ascending, but descending order can be returned by appending \"desc\" to the orderBy field. For instance, \"description desc\" will return the printers sorted by description in descending order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for listing printers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printers\": [ { object (/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printers[]` | `object (`[Printer](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer)`)` List of printers. If `orgUnitId` was given in the request, then only printers visible for this OU will be returned. If `orgUnitId` was not given in the request, then all printers will be returned. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.chrome.printers`\n- `\n https://www.googleapis.com/auth/admin.chrome.printers.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]