Method: chromeosdevices.list

Ruft eine paginierte Liste der Chrome OS-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 darzustellen. customerId wird auch als Teil der Nutzerressource zurückgegeben.

Abfrageparameter

Parameter
maxResults

integer

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

orderBy

enum (OrderBy)

Geräteeigenschaft zum Sortieren von Ergebnissen.

orgUnitPath

string

Der vollständige Pfad der Organisationseinheit (ohne vorangestelltes /) oder ihre eindeutige ID.

pageToken

string

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

projection

enum (Projection)

Bestimmt, ob die Antwort die vollständige Liste der Properties oder nur einen Teil davon 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)

Gibt an, ob Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden. Muss mit dem Parameter orderBy verwendet werden.

includeChildOrgunits

boolean

Gibt Geräte aus allen untergeordneten Organisationseinheiten sowie aus der angegebenen Organisationseinheit zurück. Ist dies auf „true“ gesetzt, ist „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

Das ETag der Ressource.

chromeosdevices[]

object (ChromeOsDevice)

Eine Liste der ChromeOS-Geräteobjekte.

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 Notizen des Chrome-Geräts, wie vom Administrator annotiert.
SERIAL_NUMBER Die bei der Aktivierung des Geräts eingegebene Seriennummer des Chrome-Geräts.
STATUS Status des Chrome-Geräts. Weitere Informationen finden Sie unter <a chromeosdevices.

Projektion

Der Projektionstyp, der 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.