REST Resource: enterprises.devices

Ressource: Device

Appareil appartenant à une entreprise Sauf indication contraire, tous les champs sont en lecture seule et ne peuvent pas être modifiés par enterprises.devices.patch.

Représentation JSON 
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Champs
name

string

Nom de l'appareil au format enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Nom de ressource de l'utilisateur propriétaire de cet appareil, au format enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Type de mode de gestion utilisé par Android Device Policy sur l'appareil. Cela détermine les paramètres de règle acceptés.
state

enum (DeviceState)

État à appliquer à l'appareil. Ce champ peut être modifié par une requête patch. Notez que lorsque vous appelez enterprises.devices.patch, ACTIVE et DISABLED sont les seules valeurs autorisées. Pour que l'appareil passe à l'état DELETED, appelez enterprises.devices.delete.
appliedState

enum (DeviceState)

État actuellement appliqué à l'appareil.
policyCompliant

boolean

Indique si l'appareil est conforme aux règles en vigueur.
nonComplianceDetails[]

object (NonComplianceDetail)

Informations sur les paramètres des règles avec lesquels l'appareil n'est pas conforme.
enrollmentTime

string (Timestamp format)

Heure d'enregistrement de l'appareil.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Dernière fois que l'appareil a envoyé un rapport d'état.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsolète.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Dernière fois que l'appareil a récupéré ses règles.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
policyName

string

Nom de la règle appliquée à l'appareil, au format enterprises/{enterpriseId}/policies/{policyId}. Si aucune valeur n'est spécifiée, la valeur policyName est appliquée à l'utilisateur de l'appareil. Ce champ peut être modifié par une requête patch. Vous ne pouvez spécifier que le policyId lorsque vous appelez enterprises.devices.patch, à condition que policyId ne contienne pas de barres obliques. Le reste du nom de la règle est déduit.
appliedPolicyName

string

Nom de la règle actuellement appliquée à l'appareil.
appliedPolicyVersion

string (int64 format)

Version de la règle actuellement appliquée à l'appareil.
apiLevel

integer

Niveau d'API de la version de la plate-forme Android exécutée sur l'appareil.
enrollmentTokenData

string

Si l'appareil a été enregistré avec un jeton d'enregistrement avec des données supplémentaires fournies, ce champ contient ces données.
enrollmentTokenName

string

Si l'appareil a été enregistré avec un jeton d'enregistrement, ce champ contient le nom du jeton.
disabledReason

object (UserFacingMessage)

Si l'état de l'appareil est DISABLED, un message facultatif s'affiche sur l'appareil indiquant la raison pour laquelle il est désactivé. Ce champ peut être modifié par une requête patch.
softwareInfo

object (SoftwareInfo)

Informations détaillées sur le logiciel de l'appareil. Ces informations ne sont disponibles que si softwareInfoEnabled est défini sur "true" dans la règle de l'appareil.
hardwareInfo

object (HardwareInfo)

Informations détaillées sur le matériel de l'appareil.
displays[]

object (Display)

Informations détaillées sur l'affichage de l'appareil. Ces informations ne sont disponibles que si displayInfoEnabled est défini sur "true" dans la règle de l'appareil.
applicationReports[]

object (ApplicationReport)

Rapports pour les applications installées sur l'appareil. Ces informations ne sont disponibles que si applicationReportsEnabled est défini sur "true" dans la règle de l'appareil.
previousDeviceNames[]

string

Si le même appareil physique a été enregistré plusieurs fois, ce champ contient les anciens noms d'appareils. Le numéro de série est utilisé comme identifiant unique pour déterminer si le même appareil physique a déjà été enregistré. Les noms sont dans l'ordre chronologique.
networkInfo

object (NetworkInfo)

Informations sur le réseau de l'appareil. Ces informations ne sont disponibles que si networkInfoEnabled est défini sur "true" dans la règle de l'appareil.
memoryInfo

object (MemoryInfo)

Informations sur la mémoire: contiennent des informations sur la mémoire et l'espace de stockage de l'appareil.
memoryEvents[]

object (MemoryEvent)

Événements liés aux mesures de la mémoire et du stockage, dans l'ordre chronologique Ces informations ne sont disponibles que si memoryInfoEnabled est défini sur "true" dans la règle de l'appareil.

Les événements sont conservés pendant une certaine période et les anciens événements sont supprimés.
powerManagementEvents[]

object (PowerManagementEvent)

Événements de gestion de l'alimentation sur l'appareil dans l'ordre chronologique Ces informations ne sont disponibles que si powerManagementEventsEnabled est défini sur "true" dans la règle de l'appareil.
hardwareStatusSamples[]

object (HardwareStatus)

Exemples d'état du matériel dans l'ordre chronologique. Ces informations ne sont disponibles que si hardwareStatusEnabled est défini sur "true" dans la règle de l'appareil.
deviceSettings

object (DeviceSettings)

Informations sur les paramètres de l'appareil. Ces informations ne sont disponibles que si deviceSettingsEnabled est défini sur "true" dans la règle de l'appareil.
user

object (User)

Utilisateur propriétaire de l'appareil.
systemProperties

map (key: string, value: string)

Carte des propriétés système sélectionnées, nom et valeur associés à l'appareil. Ces informations ne sont disponibles que si systemPropertiesEnabled est défini sur "true" dans la règle de l'appareil.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

Valeur de la stratégie de sécurité de l'appareil qui reflète le niveau de sécurité de l'appareil.
ownership

enum (Ownership)

Propriété de l'appareil géré.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informations sur le mode Critères communs, c'est-à-dire les normes de sécurité définies dans le document Common Criteria for Information Technology Security Evaluation (CC).

Ces informations ne sont disponibles que si statusReportingSettings.commonCriteriaModeEnabled est défini sur true dans la règle de l'appareil.
appliedPasswordPolicies[]

object (PasswordRequirements)

Exigences relatives au mot de passe actuellement appliquées à l'appareil.

  • Dans certains cas, les exigences appliquées peuvent être légèrement différentes de celles spécifiées dans passwordPolicies.
  • fieldPath est défini sur la base de passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Uniquement en sortie. Informations indiquant si cet appareil n'est plus géré par un autre outil de contrôle des règles relatives aux appareils (DPC) après la migration.

DeviceState

États pouvant être appliqués à un appareil.

Enums
DEVICE_STATE_UNSPECIFIED Cette valeur n'est pas autorisée.
ACTIVE L'appareil est actif.
DISABLED L'appareil est désactivé.
DELETED L'appareil a été supprimé. Cet état n'est jamais renvoyé par un appel d'API, mais il est utilisé dans le rapport d'état final lorsque l'appareil accuse réception de la suppression. Si l'appareil est supprimé via l'appel d'API, cet état est publié dans Pub/Sub. Si l'utilisateur supprime le profil professionnel ou réinitialise l'appareil, le serveur ne connaîtra pas son état.
PROVISIONING L'appareil est en cours de provisionnement. Les appareils nouvellement enregistrés restent dans cet état jusqu'à ce qu'une règle soit appliquée.
LOST L'appareil est perdu. Cet état n'est possible que sur les appareils appartenant à l'organisation.
PREPARING_FOR_MIGRATION L'appareil est en train de préparer la migration vers l'API Android Management. Aucune autre action n'est requise de votre part pour que la migration se poursuive.

NonComplianceDetail

Fournit des informations détaillées sur la non-conformité d'un paramètre de règle.

Représentation JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Champs
settingName

string

Nom du paramètre de la règle. Il s'agit du nom de champ JSON d'un champ Policy de niveau supérieur.
nonComplianceReason

enum (NonComplianceReason)

Raison pour laquelle l'appareil n'est pas conforme au paramètre.
packageName

string

Nom du package indiquant l'application non conforme, le cas échéant.
fieldPath

string

Pour les paramètres comportant des champs imbriqués, si un champ imbriqué spécifique n'est pas conforme, le chemin d'accès complet au champ mis en cause est indiqué. Le chemin d'accès est formaté de la même manière que le champ JSON de stratégie serait référencé en JavaScript, à savoir: 1) Pour les champs de type objet, le nom du champ est suivi d'un point, puis d'un nom de sous-champ. 2) Pour les champs de type tableau, le nom du champ est suivi de l'index du tableau, entre crochets. Par exemple, pour indiquer un problème avec le champ url du champ externalData dans la troisième application, le chemin d'accès serait applications[2].externalData.url.
currentValue

value (Value format)

Valeur actuelle du paramètre sur l'appareil si le paramètre de règle n'a pas pu être appliqué.
installationFailureReason

enum (InstallationFailureReason)

Si packageName est défini et que le motif de non-conformité est APP_NOT_INSTALLED ou APP_NOT_UPDATED, le motif détaillé pour lequel l'application ne peut pas être installée ou mise à jour.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Raison spécifique à la règle pour laquelle l'appareil n'est pas conforme au paramètre.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Contexte supplémentaire pour specificNonComplianceReason.

InstallationFailureReason

Causes d'échecs d'installation d'une application

Enums
INSTALLATION_FAILURE_REASON_UNSPECIFIED Cette valeur n'est pas autorisée.
INSTALLATION_FAILURE_REASON_UNKNOWN Une condition inconnue empêche l'installation de l'appli. Cela peut être dû au fait que l'appareil n'a pas assez d'espace de stockage, que sa connexion réseau n'est pas fiable ou que l'installation prend plus de temps que prévu. Une nouvelle tentative d'installation sera effectuée automatiquement.
IN_PROGRESS L'installation est toujours en cours.
NOT_FOUND L'application est introuvable sur Play.
NOT_COMPATIBLE_WITH_DEVICE L'application n'est pas compatible avec l'appareil.
NOT_APPROVED L'application n'a pas été approuvée par l'administrateur.
PERMISSIONS_NOT_ACCEPTED L'application dispose de nouvelles autorisations qui n'ont pas été acceptées par l'administrateur.
NOT_AVAILABLE_IN_COUNTRY L'application n'est pas disponible dans le pays de l'utilisateur.
NO_LICENSES_REMAINING Aucune licence n'est disponible pour cet utilisateur.
NOT_ENROLLED L'entreprise n'est plus inscrite à Google Play d'entreprise ou l'administrateur n'a pas accepté les dernières conditions d'utilisation de Google Play d'entreprise.
USER_INVALID L'utilisateur n'est plus valide. L'utilisateur a peut-être été supprimé ou désactivé.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Une erreur réseau sur l'appareil de l'utilisateur a empêché l'installation. Cela se produit généralement lorsque la connectivité Internet de l'appareil est dégradée ou indisponible, ou en cas de problème de configuration du réseau. Veuillez vous assurer que l'appareil a accès à une connectivité Internet complète sur un réseau conforme au format Android Enterprise Network Requirements. Dans ce cas, l'installation ou la mise à jour de l'application reprendront automatiquement.
INSUFFICIENT_STORAGE L'espace de stockage de l'appareil de l'utilisateur est insuffisant pour installer l'application. Pour résoudre ce problème, libérez de l'espace sur l'appareil. L'installation ou la mise à jour de l'application reprendra automatiquement une fois que l'appareil disposera d'un espace de stockage suffisant.

SpecificNonComplianceReason

Plus d'informations sur les raisons pour lesquelles un appareil peut ne pas être conforme à un paramètre de règle. De nouvelles valeurs pourront être ajoutées ultérieurement à l'énumération.

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Aucun motif de non-conformité spécifique n'est indiqué. Les champs de specificNonComplianceContext ne sont pas définis.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED L'utilisateur doit confirmer les identifiants en accédant au verrouillage de l'écran. Les champs de specificNonComplianceContext ne sont pas définis. nonComplianceReason est défini sur USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Le mot de passe de l'appareil ou du profil a expiré. passwordPoliciesContext est défini. nonComplianceReason est défini sur USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Le mot de passe de l'appareil ne répond pas aux exigences concernant le mot de passe. passwordPoliciesContext est défini. nonComplianceReason est défini sur USER_ACTION.
ONC_WIFI_INVALID_VALUE La valeur de la configuration Wi-Fi ONC est incorrecte. fieldPath indique quelle valeur de champ est incorrecte. oncWifiContext est défini. nonComplianceReason est défini sur INVALID_VALUE.
ONC_WIFI_API_LEVEL Le paramètre Wi-Fi ONC n'est pas compatible avec le niveau d'API de la version d'Android exécutée sur l'appareil. fieldPath spécifie la valeur de champ non acceptée. oncWifiContext est défini. nonComplianceReason est défini sur API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Il manque l'autorité de certification racine ou le nom de domaine au réseau Wi-Fi de l'entreprise. La propriété nonComplianceReason est définie sur INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK L'utilisateur doit supprimer manuellement le réseau Wi-Fi configuré. Cela s'applique uniquement aux profils professionnels sur les appareils personnels. La propriété nonComplianceReason est définie sur USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY L'alias de paire de clés spécifié via le champ ClientCertKeyPairAlias dans openNetworkConfiguration ne correspond pas à une clé existante installée sur l'appareil. nonComplianceReason est défini sur INVALID_VALUE.

SpecificNonComplianceContext

Contexte supplémentaire pour SpecificNonComplianceReason.

Représentation JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Champs
oncWifiContext

object (OncWifiContext)

Contexte supplémentaire pour la non-conformité liée à la configuration Wi-Fi. Voir ONC_WIFI_INVALID_VALUE et ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Contexte supplémentaire pour la non-conformité liée aux règles relatives aux mots de passe. Voir PASSWORD_POLICIES_PASSWORD_EXPIRED et PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contexte supplémentaire pour la non-conformité liée à la configuration Wi-Fi.

Représentation JSON 
{
  "wifiGuid": string
}
Champs
wifiGuid

string

GUID de la configuration Wi-Fi non conforme.

PasswordPoliciesContext

Contexte supplémentaire pour la non-conformité liée aux règles relatives aux mots de passe.

Représentation JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Champs
passwordPolicyScope

enum (PasswordPolicyScope)

Champ d'application du mot de passe non conforme.

SoftwareInfo

Informations sur le logiciel de l'appareil.

Représentation JSON 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Champs
androidVersion

string

Chaîne de version d'Android visible par l'utilisateur. Par exemple, 6.0.1.
androidDevicePolicyVersionCode

integer

Le code de version de l'application Android Device Policy.
androidDevicePolicyVersionName

string

Version de l'application Android Device Policy telle qu'elle est présentée à l'utilisateur.
androidBuildNumber

string

Chaîne d'ID de build Android destinée à être présentée à l'utilisateur. Par exemple, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Version du noyau (par exemple, 2.6.32.9-g103d848)
bootloaderVersion

string

Numéro de version du bootloader du système, par exemple 0.6.7.
androidBuildTime

string (Timestamp format)

Durée de la compilation.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
securityPatchLevel

string

Niveau du correctif de sécurité, par exemple 2016-05-01.
primaryLanguageCode

string

Code de langue IETF BCP 47 pour les paramètres régionaux principaux de l'appareil.
deviceBuildSignature

string

Hachage SHA-256 de android.content.pm.Signature associé au package système, qui permet de vérifier que le build système n'a pas été modifié.
systemUpdateInfo

object (SystemUpdateInfo)

Informations sur une mise à jour potentielle du système en attente.

SystemUpdateInfo

Informations sur une mise à jour potentielle du système en attente.

Représentation JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Champs
updateStatus

enum (UpdateStatus)

État d'une mise à jour indiquant si une mise à jour existe et son type.
updateReceivedTime

string (Timestamp format)

Date et heure auxquelles la mise à jour a été disponible pour la première fois. Une valeur nulle indique que ce champ n'est pas défini. Ce champ n'est défini que si une mise à jour est disponible (c'est-à-dire que updateStatus n'est ni UPDATE_STATUS_UNKNOWN, ni UP_TO_DATE).

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

UpdateStatus

État d'une mise à jour indiquant si une mise à jour existe et son type.

Enums
UPDATE_STATUS_UNKNOWN Il est impossible de savoir si une mise à jour du système est en attente. Cela se produit, par exemple, lorsque le niveau d'API de l'appareil est inférieur à 26 ou si la version d'Android Device Policy est obsolète.
UP_TO_DATE Aucune mise à jour du système en attente n'est disponible sur l'appareil.
UNKNOWN_UPDATE_AVAILABLE Une mise à jour du système est en attente, mais son type est inconnu.
SECURITY_UPDATE_AVAILABLE Une mise à jour de sécurité est en attente.
OS_UPDATE_AVAILABLE Une mise à jour de l'OS est en attente.

HardwareInfo

Informations sur le matériel de l'appareil. Les champs liés aux seuils de température ne sont disponibles que si hardwareStatusEnabled est défini sur "true" dans la règle de l'appareil.

Représentation JSON 
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
Champs
brand

string

Marque de l'appareil. Par exemple, Google.
hardware

string

Nom du matériel. Par exemple, Angler.
deviceBasebandVersion

string

Version de bande de base. Par exemple, MDM9625_104662.22.05.34p.
manufacturer

string

Fabricant. Par exemple, Motorola.
serialNumber

string

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

string

Modèle de l'appareil. Par exemple, Asus Nexus 7.
batteryShutdownTemperatures[]

number

Seuils de température d'arrêt de la batterie en degrés Celsius pour chaque batterie de l'appareil.
batteryThrottlingTemperatures[]

number

Seuils de limitation de la température de limitation de la batterie en degrés Celsius pour chaque batterie de l'appareil.
cpuShutdownTemperatures[]

number

Seuils de température d'arrêt du processeur en degrés Celsius pour chaque processeur de l'appareil.
cpuThrottlingTemperatures[]

number

Seuils de limitation de la température en degrés Celsius pour chaque processeur de l'appareil.
gpuShutdownTemperatures[]

number

Seuils de température d'arrêt du GPU en degrés Celsius pour chaque GPU de l'appareil.
gpuThrottlingTemperatures[]

number

Seuils de limitation de la température GPU en degrés Celsius pour chaque GPU de l'appareil.
skinShutdownTemperatures[]

number

Seuils de température cutanée d'arrêt de l'appareil en degrés Celsius.
skinThrottlingTemperatures[]

number

Seuils de température cutanée de limitation de l'appareil en degrés Celsius.
enterpriseSpecificId

string

Uniquement en sortie. ID qui identifie de manière unique un appareil personnel dans une organisation donnée. Sur le même appareil physique lorsqu'il est enregistré auprès de la même organisation, cet identifiant persiste entre les configurations, et même les rétablissements de la configuration d'usine. Cet ID est disponible sur les appareils personnels dotés d'un profil professionnel sur les appareils équipés d'Android 12 ou version ultérieure.

Écran

Informations affichées sur l'appareil.

Représentation JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Champs
name

string

Nom de l'écran.
displayId

integer

ID à afficher unique
refreshRate

integer

Fréquence d'actualisation de l'écran en images par seconde.
state

enum (DisplayState)

État de l'écran.
width

integer

Largeur d'affichage en pixels.
height

integer

Afficher la hauteur en pixels.
density

integer

Densité d'affichage exprimée en points par pouce.

DisplayState

État d'un écran.

Enums
DISPLAY_STATE_UNSPECIFIED Cette valeur n'est pas autorisée.
OFF L'écran est éteint.
ON L'écran est allumé.
DOZE L'écran est en veille alors que la batterie est faible
SUSPENDED L'écran reste en veille alors qu'il est en mode faible consommation d'énergie.

ApplicationReport

Informations concernant une application installée.

Représentation JSON 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Champs
packageName

string

Nom du package de l'application.
versionName

string

Version de l'application telle qu'elle est présentée à l'utilisateur.
versionCode

integer

Code de version de l'application, qui permet de déterminer si une version est plus récente qu'une autre.
events[]

object (ApplicationEvent)

Liste des événements d'application qui se sont produits au cours des 30 dernières heures.
displayName

string

Nom à afficher de l'application.
packageSha256Hash

string

Hachage SHA-256 du fichier APK de l'application, qui permet de vérifier que l'application n'a pas été modifiée. Chaque octet de la valeur de hachage est représenté par un nombre hexadécimal à deux chiffres.
signingKeyCertFingerprints[]

string

Le hachage SHA-1 de chaque android.content.pm.Signature associé au package de l'application. Chaque octet de chaque valeur de hachage est représenté par un nombre hexadécimal à deux chiffres.
installerPackageName

string

Nom du package de l'application qui a installé cette application.
applicationSource

enum (ApplicationSource)

Source du package.
state

enum (ApplicationState)

État de l'application.
keyedAppStates[]

object (KeyedAppState)

Liste des états d'application appariés signalés par l'application.
userFacingType

enum (UserFacingType)

Indique si l'application est destinée aux utilisateurs.

ApplicationEvent

Événement lié à l'application.

Représentation JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Champs
eventType

enum (ApplicationEventType)

Type d'événement d'application.
createTime

string (Timestamp format)

Heure de création de l'événement.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Type d'événement lié à l'application.

Enums
APPLICATION_EVENT_TYPE_UNSPECIFIED Cette valeur n'est pas autorisée.
INSTALLED L'application a été installée.
CHANGED L'application a été modifiée (un composant a été activé ou désactivé, par exemple).
DATA_CLEARED Les données de l'application ont été effacées.
REMOVED L'application a été supprimée.
REPLACED Une nouvelle version de l'application a été installée et remplace l'ancienne version.
RESTARTED L'application a redémarré.
PINNED L'application a été épinglée au premier plan.
UNPINNED L'application a été retirée.

ApplicationSource

Source qui a fourni une application.

Enums
APPLICATION_SOURCE_UNSPECIFIED L'appli a été téléchargée indépendamment depuis une source non spécifiée.
SYSTEM_APP_FACTORY_VERSION Il s'agit d'une application système issue de l'image d'usine de l'appareil.
SYSTEM_APP_UPDATED_VERSION Il s'agit d'une application système mise à jour.
INSTALLED_FROM_PLAY_STORE L'application a été installée depuis le Google Play Store.

ApplicationState

État de l'installation actuel.

Enums
APPLICATION_STATE_UNSPECIFIED L'état de l'application n'est pas spécifié
REMOVED L'application a été supprimée de l'appareil
INSTALLED L'application est installée sur l'appareil

KeyedAppState

État de l'application à clé signalé par l'application.

Représentation JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Champs
key

string

Clé de l'état de l'application. Sert de point de référence pour ce à quoi l'application fournit l'état. Par exemple, lorsque vous envoyez des commentaires sur la configuration gérée, cette clé peut être la clé de configuration gérée.
severity

enum (Severity)

Gravité de l'état de l'application.
message

string

Éventuellement, une chaîne de message de format libre pour expliquer l'état de l'application. Si l'état a été déclenché par une valeur particulière (par exemple, une valeur de configuration gérée), il doit être inclus dans le message.
data

string

Éventuellement, une valeur lisible par un ordinateur que l'EMM doit lire. Par exemple, vous pouvez définir des valeurs sur lesquelles l'administrateur peut choisir d'interroger la console EMM (par exemple, "M'avertir si les données d'avertissement de batterie sont inférieures à 10").
createTime

string (Timestamp format)

Date et heure de création de l'état de l'application sur l'appareil.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

Heure de la dernière mise à jour de l'état de l'application.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

Gravité

Gravité de l'état de l'application.

Enums
SEVERITY_UNSPECIFIED Niveau de gravité non spécifié.
INFO Niveau de gravité des informations.
ERROR Niveau de gravité de l'erreur. Ce paramètre ne doit être défini que pour les erreurs réelles qu'une organisation de gestion doit corriger.

UserFacingType

Indique si l'application est destinée aux utilisateurs.

Enums
USER_FACING_TYPE_UNSPECIFIED Le type d'application visible par l'utilisateur n'est pas spécifié.
NOT_USER_FACING L'application n'est pas visible par l'utilisateur.
USER_FACING L'application est destinée aux utilisateurs.

NetworkInfo

Informations sur le réseau de l'appareil.

Représentation JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Champs
imei

string

Code IMEI de l'appareil GSM. Par exemple, A1000031212.
meid

string

Code MEID de l'appareil CDMA Par exemple, A00000292788E1.
wifiMacAddress

string

Adresse MAC Wi-Fi de l'appareil. Par exemple, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Nom alphabétique de l'opérateur actuellement enregistré. Par exemple : Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Fournit des informations de téléphonie associées à chaque carte SIM sur l'appareil. Uniquement disponible sur les appareils entièrement gérés à partir du niveau d'API Android 23.

TelephonyInfo

Informations téléphoniques associées à une carte SIM donnée sur l'appareil. Uniquement disponible sur les appareils entièrement gérés à partir du niveau d'API Android 23.

Représentation JSON 
{
  "phoneNumber": string,
  "carrierName": string
}
Champs
phoneNumber

string

Numéro de téléphone associé à cette carte SIM.
carrierName

string

Nom de l'opérateur associé à cette carte SIM.

MemoryInfo

Informations sur la mémoire et l'espace de stockage de l'appareil.

Représentation JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Champs
totalRam

string (int64 format)

RAM totale sur l'appareil en octets.
totalInternalStorage

string (int64 format)

Mémoire de stockage interne totale sur l'appareil, en octets.

MemoryEvent

Événement lié aux mesures de la mémoire et du stockage.

Pour distinguer les nouveaux des anciens événements, nous vous recommandons d'utiliser le champ createTime.

Représentation JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Champs
eventType

enum (MemoryEventType)

Type d'événement
createTime

string (Timestamp format)

Heure de création de l'événement.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

Nombre d'octets disponibles du support ou, pour EXTERNAL_STORAGE_DETECTED, la capacité totale en octets du support de stockage.

MemoryEventType

Type d'événement.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED URL indéterminée. Aucun événement de ce type.
RAM_MEASURED L'espace disponible dans la RAM a été mesuré.
INTERNAL_STORAGE_MEASURED L'espace disponible dans la mémoire de stockage interne a été mesuré.
EXTERNAL_STORAGE_DETECTED Un nouveau support de stockage externe a été détecté. Le nombre d'octets indiqué correspond à la capacité totale du support de stockage.
EXTERNAL_STORAGE_REMOVED Un support de stockage externe a été supprimé. Le nombre d'octets indiqué est de zéro.
EXTERNAL_STORAGE_MEASURED L'espace disponible sur un support de stockage externe a été mesuré.

PowerManagementEvent

Événement de gestion de l'alimentation

Représentation JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Champs
eventType

enum (PowerManagementEventType)

Type d'événement
createTime

string (Timestamp format)

Heure de création de l'événement.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
batteryLevel

number

Pour les événements BATTERY_LEVEL_COLLECTED, niveau de batterie en pourcentage.

PowerManagementEventType

Type d'événement.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED URL indéterminée. Aucun événement de ce type.
BATTERY_LEVEL_COLLECTED Le niveau de batterie a été mesuré.
POWER_CONNECTED L'appareil a commencé à se charger.
POWER_DISCONNECTED L'appareil a cessé de se recharger.
BATTERY_LOW L'appareil est passé en mode économie d'énergie.
BATTERY_OKAY L'appareil a quitté le mode économie d'énergie.
BOOT_COMPLETED L'appareil a démarré.
SHUTDOWN L'appareil s'est éteint.

HardwareStatus

État du matériel. Les températures peuvent être comparées aux seuils de température disponibles dans hardwareInfo pour déterminer l'état du matériel.

Représentation JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Champs
createTime

string (Timestamp format)

Heure de réalisation des mesures.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

Températures actuelles de la batterie de l'appareil, en degrés Celsius.
cpuTemperatures[]

number

Températures actuelles du processeur en degrés Celsius pour chaque processeur de l'appareil.
gpuTemperatures[]

number

Températures actuelles de GPU en degrés Celsius pour chaque GPU de l'appareil.
skinTemperatures[]

number

Températures cutanée actuelles de l'appareil en degrés Celsius.
fanSpeeds[]

number

Vitesses du ventilateur en tr/min pour chaque ventilateur de l'appareil. Le tableau vide signifie qu'il n'y a pas de ventilateurs ou que leur vitesse n'est pas prise en charge par le système.
cpuUsages[]

number

Utilisations du processeur en pourcentage pour chaque cœur disponible sur l'appareil. L'utilisation est de 0 pour chaque cœur débranché. Un tableau vide signifie que l'utilisation du processeur n'est pas prise en charge par le système.

DeviceSettings

Informations sur les paramètres de sécurité de l'appareil.

Représentation JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Champs
isDeviceSecure

boolean

Indique si l'appareil est sécurisé avec un code/mot de passe.
unknownSourcesEnabled

boolean

Indique si l'installation d'applications provenant de sources inconnues est activée.
developmentSettingsEnabled

boolean

Indique si le mode développeur est activé sur l'appareil.
adbEnabled

boolean

Indique si ADB est activé sur l'appareil.
isEncrypted

boolean

Indique si le chiffrement du stockage est activé.
encryptionStatus

enum (EncryptionStatus)

État du chiffrement provenant de DevicePolicyManager.
verifyAppsEnabled

boolean

Indique si la validation Google Play Protect est appliquée sur l'appareil.

EncryptionStatus

État du chiffrement d'un appareil.

Enums
ENCRYPTION_STATUS_UNSPECIFIED URL indéterminée. Aucun appareil ne doit avoir ce type.
UNSUPPORTED L'appareil n'est pas compatible avec le chiffrement.
INACTIVE L'appareil prend en charge le chiffrement, mais il n'est pas actif pour le moment.
ACTIVATING Le chiffrement n'est pas actif actuellement, mais il est en cours d'activation.
ACTIVE Le chiffrement est actif.
ACTIVE_DEFAULT_KEY Le chiffrement est actif, mais l'utilisateur n'a pas défini de clé de chiffrement.
ACTIVE_PER_USER Le chiffrement est actif, et la clé de chiffrement est liée au profil utilisateur.

SecurityPosture

Stratégie de sécurité de l'appareil, telle que déterminée par son état actuel et les règles appliquées.

Représentation JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Champs
devicePosture

enum (DevicePosture)

Valeur de la stratégie de sécurité de l'appareil.
postureDetails[]

object (PostureDetail)

Informations supplémentaires concernant la position de l'appareil en termes de sécurité.

DevicePosture

Valeurs possibles de la stratégie de sécurité d'un appareil géré.

Enums
POSTURE_UNSPECIFIED URL indéterminée. Aucun détail sur la stratégie n'est disponible pour cette valeur de la stratégie.
SECURE Cet appareil est sécurisé.
AT_RISK Cet appareil peut être plus vulnérable aux acteurs malveillants que nous recommandons de l'utiliser avec des données d'entreprise.
POTENTIALLY_COMPROMISED Il est possible que la sécurité de cet appareil ait été compromise et que des acteurs non autorisés aient accès aux données de l'entreprise.

PostureDetail

Informations supplémentaires concernant la position de l'appareil en termes de sécurité.

Représentation JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Champs
securityRisk

enum (SecurityRisk)

Risque de sécurité spécifique qui affecte négativement la stratégie de sécurité de l'appareil.
advice[]

object (UserFacingMessage)

Conseils aux administrateurs correspondants pour atténuer ce risque de sécurité et améliorer la stratégie de sécurité de l'appareil.

SecurityRisk

Risque qui fait que l'appareil n'est pas dans l'état le plus sécurisé.

Enums
SECURITY_RISK_UNSPECIFIED URL indéterminée.
UNKNOWN_OS L'API Play Integrity détecte que l'appareil exécute un OS inconnu (la vérification de l'intégrité de base réussit, mais ctsProfileMatch échoue).
COMPROMISED_OS L'API Play Integrity détecte que l'appareil exécute un OS dont la sécurité est compromise (la vérification de l'intégrité de base échoue).
HARDWARE_BACKED_EVALUATION_FAILED L'API Play Integrity détecte que l'appareil ne présente pas une bonne garantie de l'intégrité du système si le libellé MEETS_STRONG_INTEGRITY n'apparaît pas dans le champ Intégrité de l'appareil.

CommonCriteriaModeInfo

Informations sur le mode Critères communs, c'est-à-dire les normes de sécurité définies dans le document Common Criteria for Information Technology Security Evaluation (CC).

Ces informations ne sont disponibles que si statusReportingSettings.commonCriteriaModeEnabled est défini sur true dans la règle de l'appareil.

Représentation JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
Champs
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Indique si le mode Critères communs est activé.

CommonCriteriaModeStatus

Indique si le mode Critères communs est activé.

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN État inconnu.
COMMON_CRITERIA_MODE_DISABLED Le mode Critères communs est actuellement désactivé.
COMMON_CRITERIA_MODE_ENABLED Le mode Critères communs est actuellement activé.

DpcMigrationInfo

Informations indiquant si cet appareil n'est plus géré par un autre outil de contrôle des règles relatives aux appareils (DPC) après la migration.

Représentation JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Champs
previousDpc

string

Uniquement en sortie. Si cet appareil a été migré depuis un autre DPC, il s'agit du nom de son package. Non renseigné dans les autres cas.
additionalData

string

Uniquement en sortie. Si cet appareil a été migré depuis un autre DPC, le champ additionalData du jeton de migration est renseigné ici.

Méthodes

delete

 Supprime un appareil.

get

 Récupère un appareil.

issueCommand

 Envoie une commande à un appareil.

list

 Liste les appareils d'une entreprise donnée.

patch

 Met à jour un appareil.