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 |
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; Der maximal zulässige Wert ist 100. |
orderBy |
Geräteeigenschaft, die zum Sortieren der Ergebnisse verwendet werden soll. |
pageToken |
Token zur Angabe der nächsten Seite in der Liste |
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/search-operators |
sortOrder |
Gibt an, ob Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen. Muss mit dem Parameter |
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 ( |
Felder | |
---|---|
kind |
Der Ressourcentyp. |
etag |
ETag der Ressource. |
mobiledevices[] |
Eine Liste von Mobilgeräteobjekten. |
nextPageToken |
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. |