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 |
Die eindeutige ID des Google Workspace-Kontos des Kunden. Als Kontoadministrator können Sie auch den |
Abfrageparameter
Parameter | |
---|---|
maxResults |
Maximale Anzahl der zurückzugebenden Ergebnisse; |
orderBy |
Geräteeigenschaft, die zum Sortieren der Ergebnisse verwendet werden soll. |
orgUnitPath |
Der vollständige Pfad der Organisationseinheit (ohne das vorangestellte |
pageToken |
Mit dem Abfrageparameter |
projection |
Beschränken Sie die zurückgegebenen Informationen auf einen Satz ausgewählter Felder. |
query |
Suchstring im Format unter https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Gibt an, ob Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen. Muss mit dem Parameter |
includeChildOrgunits |
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 ( |
Felder | |
---|---|
kind |
Der Ressourcentyp. |
etag |
ETag der Ressource. |
chromeosdevices[] |
Eine Liste von Chrome OS-Geräteobjekten. |
nextPageToken |
Token für den Zugriff auf die nächste Seite dieses Ergebnisses. Verwenden Sie den Wert dieses Tokens im Abfragestring |
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. |