Method: mobiledevices.list

Ruft eine paginierte Liste aller Mobilgeräte des Nutzers eines Kontos 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 Fehlerbehebung bei Fehlercodes.

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

enum (OrderBy)

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

string

Token zur Angabe der nächsten Seite in der Liste
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/search-operators
sortOrder

enum (SortOrder)

Gibt an, ob 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

Der Ressourcentyp.
etag

string

ETag der Ressource.
mobiledevices[]

object (MobileDevice)

Eine Liste von Mobilgeräteobjekten.
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 Google Sync-Mobilgeräts. 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 auf dem Gerät.
MODEL Das Modell des Mobilgeräts.
NAME 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 Enthält alle Metadatenfelder

SortOrder

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.