REST Resource: mobiledevices

Ressource: MobileDevice

La Gestion des appareils mobiles Google Workspace inclut les appareils Android, Google Sync et iOS. Pour en savoir plus sur les tâches courantes de l'API pour les appareils mobiles de groupe, 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 la ressource d'API. Pour les ressources Mobiledevices, la valeur est admin#directory#mobiledevice.

etag

string

ETag de la ressource.

resourceId

string

Identifiant 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 des propriétaires d'appareils, utilisez la méthode get. Pour en savoir plus sur la récupération des informations sur l'utilisateur d'un appareil mobile, 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 méthode 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 du matériel Android. Elle ne s'applique pas aux appareils Google Sync. Lorsque vous ajoutez un appareil mobile Android, cette propriété est 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 valeur est au format de date et d'heure 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>. Par exemple, 2010-04-05T17:30:04+01:00.

lastSync

string

Date et heure de la dernière synchronisation des paramètres de règles entre l'appareil et la console d'administration. La valeur est au format de date et d'heure 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>. Par 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 de l'appareil mobile (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 compromis.

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 (en 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 de l'appareil mobile (en lecture seule)

securityPatchLevel

string (int64 format)

Niveau du correctif de sécurité de l'appareil mobile (en 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 de l'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 et 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 comporte deux applications existantes et que l'API met à jour la liste avec cinq applications, la liste est désormais composée de cinq applications.

applications[].packageName

string

Nom du package de l'application. 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 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. READ_CALENDAR ou MANAGE_ACCOUNTS sont des exemples d'autorisations d'une application Agenda.

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 à un utilisateur pour un compte.