Method: mobiledevices.list

Ruft eine paginierte Liste aller Mobilgeräte eines Nutzers für ein Konto ab. Wenn Sie eine Liste mit unternehmenseigenen Geräten abrufen möchten, verwenden Sie stattdessen die Cloud Identity Devices API. 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 darzustellen. customerId wird auch als Teil der Nutzerressource zurückgegeben.

Abfrageparameter

Parameter
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse. Der maximal zulässige Wert ist 100.
orderBy

enum (OrderBy)

Geräteeigenschaft zum Sortieren von Ergebnissen.
pageToken

string

Token zur Angabe der nächsten Seite in der Liste
projection

enum (Projection)

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

string

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

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

Der Ressourcentyp.
etag

string

Das ETag der Ressource.
mobiledevices[]

object (MobileDevice)

Eine Liste der Mobilgeräteobjekte.
nextPageToken

string

Token für den Zugriff auf die nächste Seite dieses Ergebnisses.

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 Mobilgeräts mit Google Sync. Bei Android-Geräten ist dies eine softwaregenerierte eindeutige Kennung.
EMAIL 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 Der Gerätestatus.
TYPE Typ des Geräts.

Projektion

Enums
BASIC Enthält nur die grundlegenden Metadatenfelder (z. B. Geräte-ID, Modell, Status, Typ und Status).
FULL Enthält alle Metadatenfelder

SortOrder

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.