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

Der Abfrageparameter pageToken wird verwendet, um die nächste Seite mit Abfrageergebnissen anzufordern. Der Abfrageparameter pageToken der Folgeanfrage ist der Parameter nextPageToken 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/workspace/admin/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

Art der Ressource.

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 Seriennummer des Chrome-Geräts, die beim Aktivieren des Geräts eingegeben wurde.
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 Alle Metadatenfelder einschließen

SortOrder

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

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.