Method: chromeosdevices.list

Ruft eine paginated Liste der ChromeOS-Geräte in einem Konto ab.

HTTP-Anfrage

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die eindeutige ID für das Google Workspace-Konto des Kunden. Als Kontoadministrator können Sie auch den Alias my_customer verwenden, um die customerId Ihres Kontos zu repräsentieren. Die customerId wird auch als Teil der Ressource „Nutzer“ zurückgegeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse. Der Wert darf 300 nicht überschreiten.
orderBy

enum (OrderBy)

Geräteeigenschaft, die zum Sortieren der Ergebnisse verwendet werden soll.
orgUnitPath

string

Der vollständige Pfad der Organisationseinheit (ohne die führende /) oder ihre eindeutige ID.
pageToken

string

Mit dem Abfrageparameter pageToken wird die nächste Seite mit Abfrageergebnissen angefordert. Der Abfrageparameter pageToken der Folgeanfrage ist der nextPageToken aus der vorherigen Antwort.
projection

enum (Projection)

Legt fest, ob die Antwort die vollständige Liste der Properties oder nur einen Teil enthält.
query

string

Suchstring im Format, das unter https://developers.google.com/admin-sdk/directory/v1/list-query-operators angegeben ist
sortOrder

enum (SortOrder)

Ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen. Muss mit dem Parameter orderBy verwendet werden.
includeChildOrgunits

boolean

Geräte aus allen untergeordneten Organisationseinheiten sowie der angegebenen Organisationseinheit zurückgeben. Wenn dieser Wert auf „wahr“ gesetzt ist, muss „orgUnitPath“ angegeben werden.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Der Ressourcentyp.
etag

string

ETag der Ressource.
chromeosdevices[]

object (ChromeOsDevice)

Eine Liste von ChromeOS-Geräteobjekten.
nextPageToken

string

Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird. Verwenden Sie den Wert dieses Tokens im Abfragestring pageToken dieser Anfrage, um auf die nächste Seite zuzugreifen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

OrderBy

Enums
ANNOTATED_LOCATION Standort des Chrome-Geräts, wie vom Administrator angegeben.
ANNOTATED_USER Chromebook-Nutzer wie vom Administrator angegeben
LAST_SYNC Datum und Uhrzeit der letzten Synchronisierung des Chrome-Geräts mit den Richtlinieneinstellungen in der Admin-Konsole.
NOTES Hinweise zum Chrome-Gerät, wie vom Administrator festgelegt.
SERIAL_NUMBER Die bei der Aktivierung des Geräts eingegebene Seriennummer des Chrome-Geräts.
STATUS Chrome-Gerätestatus Weitere Informationen finden Sie unter <a chromeosdevices.

Projektion

Die Art der Projektion, die für die Geräte angezeigt werden soll.

Enums
BASIC Enthält nur die grundlegenden Metadatenfelder (z.B. deviceId, serialNumber, status und user)
FULL Enthält alle Metadatenfelder

SortOrder

Die Sortierreihenfolge, die auf die Geräteliste angewendet werden soll.

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.