Method: mobiledevices.list

Récupère une liste paginée de tous les appareils mobiles appartenant à un utilisateur pour un compte. Pour récupérer une liste incluant les appareils appartenant à l'entreprise, utilisez plutôt l'API Devices de Cloud Identity. Cette méthode expire au bout de 60 minutes. Pour en savoir plus, consultez la section Résoudre les codes d'erreur.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte. customerId est également renvoyé dans la ressource "Users".

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal de résultats sur une page. La valeur maximale autorisée est de 100.
orderBy

enum (OrderBy)

Propriété de l'appareil à utiliser pour trier les résultats.
pageToken

string

Jeton permettant de spécifier la page suivante de la liste
projection

enum (Projection)

Limitez les informations renvoyées à un ensemble de champs sélectionnés.
query

string

Chaîne de recherche au format indiqué sur la page https://developers.google.com/workspace/admin/directory/v1/search-operators
sortOrder

enum (SortOrder)

Indique si les résultats doivent être renvoyés par ordre croissant ou décroissant. Doit être utilisé avec le paramètre orderBy.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Type de ressource
etag

string

ETag de la ressource.
mobiledevices[]

object (MobileDevice)

Liste d'objets Mobile Device.
nextPageToken

string

Jeton utilisé pour accéder à la page suivante de ce résultat.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide d'autorisation.

OrderBy

Enums
DEVICE_ID Numéro de série d'un appareil mobile Google Sync. Pour les appareils Android, il s'agit d'un identifiant unique généré par logiciel.
EMAIL Adresse e-mail du propriétaire de l'appareil.
LAST_SYNC Date et heure de la dernière synchronisation des paramètres de règles de l'appareil.
MODEL Modèle de l'appareil mobile.
NAME Nom d'utilisateur du propriétaire de l'appareil.
OS Système d'exploitation de l'appareil.
STATUS État de l'appareil.
TYPE Type d'appareil.

Projection

Enums
BASIC N'inclut que les champs de métadonnées de base (par exemple, deviceId, model, status, type et status)
FULL Inclut tous les champs de métadonnées

SortOrder

Enums
ASCENDING par ordre croissant.
DESCENDING Ordre décroissant.