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:
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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["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)."]]
