Method: admin.directory.v1.customers.chrome.printers.list

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 vorhanden 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 Daten in absteigender 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.