REST Resource: mobiledevices

Ressource: MobileDevice

Le service Gestion des appareils mobiles Google Workspace inclut les appareils Android, Google Sync et iOS. Pour en savoir plus sur les tâches courantes de groupe liées à l'API des 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

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 de propriétaires d'appareils, utilisez la méthode get. Pour en savoir plus sur la récupération des informations utilisateur sur les 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 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. Lors de l'ajout d'un appareil mobile Android, cette propriété est facultative. Lors de la mise à jour de l'un de ces appareils, cette propriété est en lecture seule.

firstSync

string

Date et heure auxquelles l'appareil a été initialement synchronisé 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, minutes et 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 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, minutes et 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

Le code 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 principal/propriétaire.

deviceCompromisedStatus

string

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

buildNumber

string

Numéro de build 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 de l'appareil mobile (lecture seule)

securityPatchLevel

string (int64 format)

Niveau du correctif de sécurité des appareils mobiles (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 d'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 comprend 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, il s'agit désormais de la liste actualisée des cinq applications.

applications[].packageName

string

Nom du package de l'application. Exemple : com.android.browser.

applications[].displayName

string

Nom à afficher de l'application 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. Exemple : 13.

applications[].permission[]

string

Liste des autorisations de cette application. Il peut s'agir d'une autorisation Android standard ou définie par l'application. Vous les trouverez dans le fichier manifeste Android de l'application. READ_CALENDAR ou MANAGE_ACCOUNTS sont des exemples d'autorisations accordées à 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 détenus par l'utilisateur pour un compte.