Method: admin.directory.v1.customers.chrome.printers.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetla listę konfiguracji drukarek.
Żądanie HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
parent |
string
Wymagane. Nazwa klienta, który jest właścicielem tej kolekcji drukarek. Format: customers/{customer_id}
|
Parametry zapytania
| Parametry |
pageSize |
integer
Maksymalna liczba zwracanych obiektów. Usługa może zwrócić mniej niż ta wartość.
|
pageToken |
string
Token strony otrzymany z poprzedniego wywołania.
|
orgUnitId |
string
Jednostka organizacyjna, dla której chcemy wyświetlić listę drukarek. Jeśli w żądaniu nie ma parametru org_unit, zwracane są wszystkie (lub filtrowane) drukarki klienta. Jeśli w żądaniu występuje parametr org_unit, zwrócone zostaną tylko drukarki dostępne dla tej jednostki organizacyjnej (własne lub odziedziczone). Aby sprawdzić, czy drukarka jest własnością tej jednostki organizacyjnej, czy została odziedziczona, możesz spojrzeć na wartość parametru Printer.org_unit_id.
|
filter |
string
Zapytanie. Składnia wyszukiwania jest wspólna dla tego interfejsu API i stron drukarek w Konsoli administracyjnej.
|
orderBy |
string
Kolejność sortowania wyników. Musi być jedną z tych wartości: displayName, description, makeAndModel lub createTime. Domyślny kierunek sortowania to rosnąco, ale można zmienić go na malejąco, dodając do pola orderBy ciąg „desc”. Na przykład „description desc” spowoduje zwrócenie drukarek posortowanych według opisu w kolejności malejącej.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź dotycząca wyświetlania drukarek
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"printers": [
{
object (Printer)
}
],
"nextPageToken": string
} |
| Pola |
printers[] |
object (Printer)
Lista drukarek. Jeśli w prośbie podano parametr orgUnitId, zwrócone zostaną tylko drukarki widoczne dla tej jednostki organizacyjnej. Jeśli w zgłoszeniu nie podano wartości orgUnitId, wszystkie drukarki zostaną zwrócone.
|
nextPageToken |
string
token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-24 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
