Method: admin.directory.v1.customers.chrome.printers.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
parent |
string
필수 항목입니다. 이 프린터 모음을 소유한 고객의 이름입니다. 형식: customers/{customer_id}
|
쿼리 매개변수
매개변수 |
pageSize |
integer
반환할 최대 객체 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다.
|
pageToken |
string
이전 호출에서 받은 페이지 토큰입니다.
|
orgUnitId |
string
프린터를 나열할 조직 단위입니다. 요청에 org_unit이 없으면 고객의 모든 프린터가 반환 (또는 필터링)됩니다. 요청에 org_unit가 있으면 이 OU에서 사용할 수 있는 프린터 (소유 또는 상속)만 반환됩니다. Printer.org_unit_id를 확인하여 이 OU의 프린터가 소유인지 상속인지 확인할 수 있습니다.
|
filter |
string
검색어 검색 문법은 이 API와 관리 콘솔 프린터 페이지 간에 공유됩니다.
|
orderBy |
string
결과를 정렬할 순서입니다. displayName, description, makeAndModel, createTime 중 하나여야 합니다. 기본 순서는 오름차순이지만 orderBy 필드에 'desc'를 추가하여 내림차순을 반환할 수 있습니다. 예를 들어 'description desc'는 설명을 기준으로 내림차순으로 정렬된 프린터를 반환합니다.
|
응답 본문
프린터를 나열하기 위한 응답입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
{
"printers": [
{
object (Printer )
}
],
"nextPageToken": string
} |
필드 |
printers[] |
object (Printer )
프린터 목록 요청에 orgUnitId 가 제공된 경우 이 OU에 표시되는 프린터만 반환됩니다. 요청에 orgUnitId 가 제공되지 않은 경우 모든 프린터가 반환됩니다.
|
nextPageToken |
string
다음 페이지를 검색하기 위해 pageToken 으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-24(UTC)
[null,null,["최종 업데이트: 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)."]]