REST Resource: mobiledevices

Ressource: MobileDevice

Le service Gestion des appareils mobiles Google Workspace comprend les appareils Android, Google Sync et iOS. Pour en savoir plus sur les tâches courantes de l'API de groupe d'appareils mobiles, consultez le Guide du développeur.

Représentation JSON
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
Champs
kind

string

Type de ressource d'API. Pour les ressources Mobiledevices, la valeur est admin#directory#mobiledevice.

etag

string

ETag de la ressource.

resourceId

string

ID unique utilisé par le service d'API pour identifier l'appareil mobile.

deviceId

string

Numéro de série d'un appareil mobile Google Sync. Pour les appareils Android et iOS, il s'agit d'un identifiant unique généré par logiciel.

name[]

string

Liste des noms d'utilisateur du propriétaire. Si votre application a besoin de la liste actuelle des noms de propriétaires d'appareils, utilisez la méthode get. Pour en savoir plus sur la récupération des informations sur les utilisateurs des appareils mobiles, consultez le Guide du développeur.

email[]

string

Liste des adresses e-mail du propriétaire. Si votre application a besoin de la liste actuelle des adresses e-mail des utilisateurs, utilisez la méthode get. Pour en savoir plus, consultez la section permettant de récupérer un utilisateur.

model

string

Nom du modèle de l'appareil mobile (par exemple, "Nexus S"). Cette propriété peut être mise à jour. Pour en savoir plus, consultez le Guide du développeur.

os

string

Système d'exploitation de l'appareil mobile (par exemple, IOS 4.3 ou Android 2.3.5) Cette propriété peut être mise à jour. Pour en savoir plus, consultez le Guide du développeur.

type

string

Type d'appareil mobile.

status

string

État de l'appareil.

hardwareId

string

Identifiant unique IMEI/MEID pour le matériel Android. Elle ne s'applique pas aux appareils Google Sync. Lors de l'ajout d'un appareil mobile Android, il s'agit d'une propriété facultative. Lors de la mise à jour de l'un de ces appareils, il s'agit d'une propriété en lecture seule.

firstSync

string

Date et heure de la première synchronisation de l'appareil avec les paramètres des règles dans la console d'administration. La date et l'heure sont au format ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Exemple : 2010-04-05T17:30:04+01:00.

lastSync

string

Date et heure de la dernière synchronisation des paramètres des règles entre l'appareil et la console d'administration. La date et l'heure sont au format ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Exemple : 2010-04-05T17:30:04+01:00.

userAgent

string

Fournit des informations sur l'appareil, telles que la version de os. Cette propriété peut être mise à jour. Pour en savoir plus, consultez le Guide du développeur.

serialNumber

string

Numéro de série de l'appareil.

imei

string

Code IMEI de l'appareil.

meid

string

Numéro MEID de l'appareil.

wifiMacAddress

string

Adresse MAC de l'appareil sur les réseaux Wi-Fi.

networkOperator

string

Opérateur mobile ou réseau (si disponible) (lecture seule)

defaultLanguage

string

Paramètres régionaux par défaut utilisés sur l'appareil.

managedAccountIsOnOwnerProfile

boolean

Booléen indiquant si ce compte est sur le profil propriétaire/principal ou non.

deviceCompromisedStatus

string

État de l'appareil dont la sécurité est compromise.

buildNumber

string

Numéro de version du système d'exploitation de l'appareil.

kernelVersion

string

Version du noyau de l'appareil.

basebandVersion

string

Version de bande de base de l'appareil.

unknownSourcesStatus

boolean

Sources inconnues activées ou désactivées sur l'appareil (lecture seule)

developerOptionsStatus

boolean

Options pour les développeurs activées ou désactivées sur l'appareil (lecture seule)

otherAccountsInfo[]

string

Liste des comptes ajoutés sur l'appareil (lecture seule)

adbStatus

boolean

Adb (débogage USB) activé ou désactivé sur l'appareil (lecture seule)

supportsWorkProfile

boolean

Profil professionnel compatible avec l'appareil (lecture seule)

manufacturer

string

Fabricant de l'appareil mobile (lecture seule)

releaseVersion

string

Version des appareils mobiles (lecture seule)

securityPatchLevel

string (int64 format)

Niveau du correctif de sécurité de l'appareil mobile (lecture seule)

brand

string

Marque de l'appareil mobile (lecture seule)

bootloaderVersion

string

Version du bootloader de l'appareil mobile (lecture seule)

hardware

string

Matériel pour appareil mobile (lecture seule)

encryptionStatus

string

État du chiffrement de l'appareil mobile (lecture seule)

devicePasswordStatus

string

DevicePasswordStatus (lecture seule)

privilege

string

DMAgentPermission (lecture seule)

applications[]

object

Liste des applications installées sur un appareil mobile Android. Elle ne s'applique pas à Google Sync ni aux appareils iOS. La liste inclut toutes les applications Android qui accèdent aux données Google Workspace.

Lorsque vous mettez à jour une liste d'applications, il est important de noter que les mises à jour remplacent la liste existante. Si l'appareil Android dispose de deux applications et que l'API met à jour la liste avec cinq applications, la liste des cinq applications est maintenant mise à jour.

applications[].packageName

string

Nom du package de l'application. Voici un exemple : com.android.browser.

applications[].displayName

string

Nom à afficher de l'application Voici un exemple : Browser.

applications[].versionName

string

Nom de la version de l'application Voici un exemple : 3.2-140714.

applications[].versionCode

integer

Code de version de l'application Voici un exemple : 13.

applications[].permission[]

string

Liste des autorisations de cette application. Il peut s'agir d'une autorisation Android standard ou d'une autorisation définie par l'application. Elles se trouvent dans le fichier manifeste Android d'une application. Exemples d'autorisations d'une application Agenda : READ_CALENDAR ou MANAGE_ACCOUNTS.

Méthodes

action

Effectue une action qui affecte un appareil mobile.

delete

Supprime un appareil mobile.

get

Récupère les propriétés d'un appareil mobile.

list

Récupère une liste paginée de tous les appareils mobiles appartenant à l'utilisateur pour un compte.