Method: mobiledevices.list

Récupère une liste paginée de tous les appareils mobiles appartenant à l'utilisateur pour un compte. Pour récupérer une liste qui inclut les appareils détenus par l'entreprise, utilisez plutôt l'API Cloud Identity Devices. Cette méthode expire au bout de 60 minutes. Pour en savoir plus, consultez Résoudre les problèmes liés aux 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 customerId de votre compte. Le customerId est également renvoyé dans le cadre de 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 dans la liste

projection

enum (Projection)

Limite 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/admin-sdk/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 dont il s'agit.

etag

string

ETag de la ressource.

mobiledevices[]

object (MobileDevice)

Liste des objets Mobile Device (Appareil mobile).

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 relatif aux autorisations.

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 des 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 Comprend uniquement 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 Ordre croissant.
DESCENDING Ordre décroissant.