Method: chromeosdevices.list

Ruft eine paginierte Liste von Chrome OS-Geräten 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 des Google Workspace-Kontos des Kunden. Als Kontoadministrator können Sie auch den my_customer-Alias verwenden, um die customerId Ihres Kontos darzustellen. Das customerId wird auch als Teil der Nutzerressource zurückgegeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse;
orderBy

enum (OrderBy)

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

string

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

string

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

enum (Projection)

Beschränken Sie die zurückgegebenen Informationen auf einen Satz ausgewählter Felder.
query

string

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

enum (SortOrder)

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

boolean

Gibt Geräte aus allen untergeordneten Organisationseinheiten sowie der angegebenen Organisationseinheit zurück. Wenn dies auf „true“ 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 Chrome OS-Geräteobjekten.
nextPageToken

string

Token für den Zugriff auf die nächste Seite dieses Ergebnisses. 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 Chrome-Gerätenotizen, die vom Administrator kommentiert wurden.
SERIAL_NUMBER Die Seriennummer des Chrome-Geräts, die bei der Aktivierung 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 „Nutzer“)
FULL Enthält alle Metadatenfelder

SortOrder

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

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.