Method: admin.directory.v1.customers.chrome.printers.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Druckerkonfigurationen auflisten
HTTP-Anfrage
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
parent |
string
Erforderlich. Der Name des Kunden, dem diese Druckersammlung gehört. Format: customers/{customer_id}
|
Abfrageparameter
Parameter |
pageSize |
integer
Die maximale Anzahl der zurückzugebenden Objekte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
|
pageToken |
string
Ein Seitentoken, das von einem vorherigen Aufruf empfangen wurde.
|
orgUnitId |
string
Organisationseinheit, für die die Drucker aufgeführt werden sollen. Wenn „org_unit“ nicht in der Anfrage enthalten ist, werden alle Drucker des Kunden zurückgegeben (oder gefiltert). Wenn „org_unit“ in der Anfrage vorhanden ist, werden nur Drucker zurückgegeben, die für diese OU verfügbar sind (eigene oder übernommene). Ob der Drucker dieser OU zugewiesen oder von ihr übernommen wurde, sehen Sie unter „Printer.org_unit_id“.
|
filter |
string
Suchanfrage. Die Suchsyntax ist für diese API und die Druckerseiten in der Admin-Konsole identisch.
|
orderBy |
string
Die Reihenfolge, nach der die Ergebnisse sortiert werden sollen. Muss einer der folgenden Werte sein: „displayName“, „description“, „makeAndModel“ oder „createTime“. Die Standardreihenfolge ist aufsteigend. Wenn Sie die absteigende Reihenfolge zurückgeben möchten, fügen Sie dem Feld „orderBy“ das Suffix „desc“ hinzu. Mit „description desc“ werden beispielsweise die Drucker in absteigender Reihenfolge nach Beschreibung zurückgegeben.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort für das Auflisten von Druckern.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"printers": [
{
object (Printer )
}
],
"nextPageToken": string
} |
Felder |
printers[] |
object (Printer )
Liste der Drucker. Wenn orgUnitId in der Anfrage angegeben wurde, werden nur Drucker zurückgegeben, die für diese OU sichtbar sind. Wenn orgUnitId in der Anfrage nicht angegeben wurde, werden alle Drucker zurückgegeben.
|
nextPageToken |
string
Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-24 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]