Method: mobiledevices.list

Ruft eine paginated Liste aller Mobilgeräte eines Nutzers für ein Konto ab. Wenn Sie eine Liste mit Geräten abrufen möchten, die dem Unternehmen gehören, verwenden Sie stattdessen die Devices API von Cloud Identity. Bei dieser Methode tritt nach 60 Minuten eine Zeitüberschreitung auf. Weitere Informationen finden Sie unter Fehlercodes beheben.

HTTP-Anfrage

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

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 maximal zulässige Wert ist 100.
orderBy

enum (OrderBy)

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

string

Token, um die nächste Seite in der Liste anzugeben
projection

enum (Projection)

Zurückgegebene Informationen auf eine Reihe von ausgewählten Feldern beschränken.
query

string

Suchstring im Format, das unter https://developers.google.com/workspace/admin/directory/v1/search-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.

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,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Art der Ressource.
etag

string

ETag der Ressource.
mobiledevices[]

object (MobileDevice)

Eine Liste von Mobilgeräteobjekten.
nextPageToken

string

Token, mit dem auf die nächste Seite dieses Ergebnisses zugegriffen wird.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

OrderBy

Enums
DEVICE_ID Die Seriennummer eines Google Sync-Mobilgeräts. Bei Android-Geräten ist dies eine softwaregenerierte eindeutige Kennung.
EMAIL Die E-Mail-Adresse des Geräteeigentümers.
LAST_SYNC Datum und Uhrzeit der letzten Synchronisierung der Richtlinieneinstellungen des Geräts.
MODEL Das Modell des Mobilgeräts.
NAME Der Nutzername des Geräteeigentümers.
OS Das Betriebssystem des Geräts.
STATUS Gerätestatus
TYPE Typ des Geräts.

Projektion

Enums
BASIC Enthält nur die grundlegenden Metadatenfelder (z.B. deviceId, model, status, type und status)
FULL Alle Metadatenfelder einschließen

SortOrder

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.