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 a une incidence sur les paramètres de règles acceptés.
state

enum (DeviceState)

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

enum (DeviceState)

État actuellement appliqué à l'appareil.
policyCompliant

boolean

Indique si l'appareil est conforme à son règlement.
nonComplianceDetails[]

object (NonComplianceDetail)

Détails sur les paramètres des règles que l'appareil n'est pas conformes
enrollmentTime

string (Timestamp format)

Heure d'enregistrement de l'appareil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

Date et heure de la dernière fois où l'appareil a envoyé un rapport d'état.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsolète.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

Date et heure de la dernière récupération de la règle de l'appareil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 pour l'utilisateur de l'appareil est appliquée. Ce champ peut être modifié par une demande de correctif. Vous ne pouvez spécifier que policyId lorsque vous appelez enterprises.devices.patch, à condition que policyId ne contienne pas de barre oblique. Le reste du nom de la règle est inféré.
appliedPolicyName

string

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

string (int64 format)

Version de la stratégie 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é à l'aide d'un jeton d'enregistrement avec des données supplémentaires fournies, ces données figurent dans ce champ.
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 pour indiquer pourquoi il est désactivé. Ce champ peut être modifié par une demande de correctif.
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 les écrans 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 sur les applications installées sur l'appareil. Ces informations ne sont disponibles que lorsque applicationReportsEnabled est défini sur "True" dans la règle de l'appareil.
previousDeviceNames[]

string

Si un même appareil physique a été enregistré plusieurs fois, ce champ contient ses noms précédents. 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 affichés par 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: contient des informations sur la mémoire et le 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 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'états du matériel par 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)

Mappage du nom et de la valeur des propriétés système sélectionnées associées à 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 posture de sécurité de l'appareil qui reflète son niveau de sécurité.
ownership

enum (Ownership)

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

object (CommonCriteriaModeInfo)

Informations sur le mode Critères communs, normes de sécurité définies dans les critères communs pour l'évaluation de la sécurité des technologies de l'information (CC).

Ces informations ne sont disponibles que si statusReportingSettings.commonCriteriaModeEnabled est true dans la règle de l'appareil, ce qui signifie qu'il appartient à l'entreprise.
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 en fonction de passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Uniquement en sortie. Informations indiquant si cet appareil a été migré depuis la gestion par un autre outil de contrôle des règles relatives aux appareils (DPC).

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 confirme 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, l'état de l'appareil restera inconnu du serveur.
PROVISIONING L'appareil est en cours de provisionnement. Les appareils nouvellement enregistrés sont dans cet état jusqu'à ce qu'une règle leur 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 se prépare à passer à l'API Android Management. Aucune autre action n'est requise de votre part pour que la migration se poursuive.
DEACTIVATED_BY_DEVICE_FINANCE Il s'agit d'un appareil financé qui a été "verrouillé" par l'agent de financement. Cela signifie que certains paramètres de règles ont été appliqués, ce qui limite les fonctionnalités de l'appareil jusqu'à ce qu'il soit "déverrouillé" par l'agent de financement. L'appareil continuera d'appliquer les paramètres des règles, à l'exception de ceux remplacés par l'agent de financement. Lorsque l'appareil est "verrouillé", l'état est indiqué dans appliedState sous la forme DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Fournit des informations sur le non-respect d'un paramètre de stratégie.

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 avec des champs imbriqués, si un champ imbriqué particulier n'est pas conforme, le chemin d'accès complet au champ non conforme est spécifié. Le chemin d'accès est formaté de la même manière que le champ JSON de la règle 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'indice du tableau entre crochets. Par exemple, pour indiquer un problème avec le champ url du champ externalData de la 3e application, le chemin d'accès est applications[2].externalData.url.
currentValue

value (Value format)

Si le paramètre de stratégie n'a pas pu être appliqué, valeur actuelle du paramètre sur l'appareil.
installationFailureReason

enum (InstallationFailureReason)

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

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Contexte supplémentaire pour specificNonComplianceReason.

InstallationFailureReason

Raisons pour lesquelles l'installation d'une application peut échouer.

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'application. Cela peut être dû à un espace de stockage insuffisant, à une connexion réseau de l'appareil peu fiable ou à une installation qui 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 dans 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 attribuer à l'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, indisponible ou qu'il existe un problème de configuration réseau. Veuillez vous assurer que l'appareil dispose d'une connexion Internet complète sur un réseau conforme à Android Enterprise Network Requirements. L'installation ou la mise à jour de l'application reprendra automatiquement.
INSUFFICIENT_STORAGE L'espace de stockage de l'appareil est insuffisant pour installer l'application. Pour résoudre le problème, libérez de l'espace de stockage sur l'appareil. L'installation ou la mise à jour de l'application reprendra automatiquement une fois que l'appareil disposera d'espace de stockage suffisant.

SpecificNonComplianceReason

Informations supplémentaires sur la raison pour laquelle un appareil ne respecte pas un paramètre de règle. De nouvelles valeurs pourront être ajoutées à l'énumération à l'avenir.

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Le motif spécifique de non-conformité n'est pas spécifié. Les champs de specificNonComplianceContext ne sont pas définis.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED L'utilisateur doit confirmer ses identifiants en saisissant le code de dé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. passwordPoliciesContext est défini. nonComplianceReason est défini sur USER_ACTION.
ONC_WIFI_INVALID_VALUE Une valeur incorrecte est définie dans la configuration du Wi-Fi ONC. 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 Le réseau Wi-Fi d'entreprise ne comporte pas de certificat d'autorité racine ou de nom de domaine. 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é. Cette fonctionnalité ne s'applique qu'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 concernant le non-respect lié à la configuration du Wi-Fi. Voir ONC_WIFI_INVALID_VALUE et ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Contexte supplémentaire concernant le non-respect des règles relatives aux mots de passe. Consultez PASSWORD_POLICIES_PASSWORD_EXPIRED et PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contexte supplémentaire concernant le non-respect lié à la configuration du Wi-Fi.

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

string

GUID de la configuration Wi-Fi non conforme.

PasswordPoliciesContext

Contexte supplémentaire concernant le non-respect des règles relatives aux mots de passe.

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

enum (PasswordPolicyScope)

Portée 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 Android visible par l'utilisateur. Par exemple, 6.0.1.
androidDevicePolicyVersionCode

integer

Code de version de l'application Android Device Policy.
androidDevicePolicyVersionName

string

Version de l'application Android Device Policy telle qu'elle s'affiche pour 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 kernel, par exemple 2.6.32.9-g103d848.
bootloaderVersion

string

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

string (Timestamp format)

Durée de la compilation.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 du système n'a pas été modifié.
systemUpdateInfo

object (SystemUpdateInfo)

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

SystemUpdateInfo

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

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

enum (UpdateStatus)

État d'une mise à jour: indique si une mise à jour existe et de quel type il s'agit.
updateReceivedTime

string (Timestamp format)

Heure à laquelle 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).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

UpdateStatus

État d'une mise à jour: indique si une mise à jour existe et de quel type il s'agit.

Enums
UPDATE_STATUS_UNKNOWN On ne sait pas 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 de la stratégie Android pour les appareils 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 système est disponible, mais son type n'est pas connu.
SECURITY_UPDATE_AVAILABLE Une mise à jour de sécurité est en attente.
OS_UPDATE_AVAILABLE Une mise à jour de l'OS est disponible.

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 les règles 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 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 température de limitation du processeur 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 température de limitation du GPU en degrés Celsius pour chaque GPU de l'appareil.
skinShutdownTemperatures[]

number

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

number

Seuils de température de régulation de la température cutanée 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 ID persiste entre les configurations et même après un rétablissement 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 sur l'écran de 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 d'affichage unique.
refreshRate

integer

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

enum (DisplayState)

État de l'écran.
width

integer

Largeur de l'écran en pixels.
height

integer

Hauteur d'affichage 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 train de dormir, alors qu'il consomme peu d'énergie
SUSPENDED L'écran est en veille dans un état d'économie d'énergie suspendu.

ApplicationReport

Informations sur 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 s'affiche pour 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é sous la forme d'un nombre hexadécimal à deux chiffres.
signingKeyCertFingerprints[]

string

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é sous la forme d'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 avec clé signalés par l'application.
userFacingType

enum (UserFacingType)

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

ApplicationEvent

Événement lié à une application.

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

enum (ApplicationEventType)

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

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 (par exemple, un composant a été activé ou désactivé).
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, remplaçant l'ancienne.
RESTARTED L'application a été redémarrée.
PINNED L'application a été épinglée au premier plan.
UNPINNED L'application a été retirée.

ApplicationSource

Source ayant fourni une application.

Enums
APPLICATION_SOURCE_UNSPECIFIED L'application a été téléchargée indépendamment à partir d'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'appli a été installée depuis le Google Play Store.

ApplicationState

État actuel de l'installation.

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 l'état fourni par l'application. Par exemple, lorsque vous fournissez 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

Facultatif : chaîne de message au 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), elle doit être incluse dans le message.
data

string

Facultatif : valeur lisible par machine à lire par l'EMM. Par exemple, définir des valeurs sur lesquelles l'administrateur peut choisir d'effectuer des requêtes dans la console EMM (par exemple, "M'avertir si les données battery_warning sont inférieures à 10").
createTime

string (Timestamp format)

Heure de création de l'état de l'application sur l'appareil.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 conditions d'erreur 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 de l'application visible par l'utilisateur n'est pas spécifié.
NOT_USER_FACING L'application n'est pas destinée aux utilisateurs.
USER_FACING L'application est visible par l'utilisateur.

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

Numéro 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 enregistré actuel. (par exemple, Vodafone).
telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

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

Représentation JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": 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.
iccId

string

Uniquement en sortie. L'ICCID associé à cette carte SIM.

MemoryInfo

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

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

string (int64 format)

Mémoire RAM totale de l'appareil, en octets.
totalInternalStorage

string (int64 format)

Espace de stockage interne total de l'appareil, en octets.

MemoryEvent

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

Pour distinguer les nouveaux événements des anciens, 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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

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

MemoryEventType

Type d'événement.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED Non spécifié. Aucun événement de ce type.
RAM_MEASURED L'espace disponible en RAM a été mesuré.
INTERNAL_STORAGE_MEASURED L'espace disponible dans l'espace 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 nul.
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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
batteryLevel

number

Pour les événements BATTERY_LEVEL_COLLECTED, le niveau de la batterie sous forme de pourcentage.

PowerManagementEventType

Type d'événement.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Non spécifié. Aucun événement n'est associé à ce type.
BATTERY_LEVEL_COLLECTED Le niveau de la batterie a été mesuré.
POWER_CONNECTED L'appareil a commencé à se charger.
POWER_DISCONNECTED L'appareil a cessé de se charger.
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 à laquelle les mesures ont été effectuées.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

Température actuelle de la batterie en degrés Celsius pour chaque batterie de l'appareil.
cpuTemperatures[]

number

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

number

Température actuelle du GPU en degrés Celsius pour chaque GPU de l'appareil.
skinTemperatures[]

number

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

number

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

number

Utilisation 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 implique que l'utilisation du processeur n'est pas prise en charge dans 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

Si l'appareil est sécurisé par un code/mot de passe.
unknownSourcesEnabled

boolean

Indique si l'installation d'applications à partir 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

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 Non spécifié. Aucun appareil ne doit avoir ce type.
UNSUPPORTED L'appareil n'est pas compatible avec le chiffrement.
INACTIVE Le chiffrement est compatible avec l'appareil, mais n'est pas actuellement actif.
ACTIVATING Le chiffrement n'est pas encore actif, 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 associée au profil utilisateur.

SecurityPosture

État de sécurité de l'appareil, déterminé 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 sur la stratégie de sécurité de l'appareil.

DevicePosture

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

Enums
POSTURE_UNSPECIFIED Non spécifié. Aucune information n'est disponible pour cette valeur de posture.
SECURE Cet appareil est sécurisé.
AT_RISK Cet appareil peut être plus vulnérable aux activités malveillantes que ce qui est recommandé pour une utilisation avec des données d'entreprise.
POTENTIALLY_COMPROMISED Il est possible que la sécurité de cet appareil ait été compromise et que des personnes non autorisées puissent accéder aux données d'entreprise.

PostureDetail

Informations supplémentaires sur la stratégie de sécurité de l'appareil.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Conseils correspondants destinés aux administrateurs pour atténuer ce risque de sécurité et améliorer le niveau 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 Non spécifié.
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 celle de ctsProfileMatch échoue).
COMPROMISED_OS L'API Play Integrity détecte que l'appareil exécute un OS compromis (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 forte garantie d'intégrité du système si le libellé MEETS_STRONG_INTEGRITY n'apparaît pas dans le champ d'intégrité de l'appareil.

CommonCriteriaModeInfo

Informations sur le mode Critères communs, c'est-à-dire les normes de sécurité définies dans les Critères communs pour l'évaluation de la sécurité des technologies de l'information (CC).

Ces informations ne sont disponibles que si statusReportingSettings.commonCriteriaModeEnabled est true dans la stratégie de l'appareil.

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

enum (CommonCriteriaModeStatus)

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

enum (PolicySignatureVerificationStatus)

Uniquement en sortie. État de la validation de la signature de la stratégie.

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é.

PolicySignatureVerificationStatus

État de la validation de la signature de la stratégie.

Enums
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Non spécifié. L'état de validation n'a pas été indiqué. Cette valeur n'est définie que si la valeur de statusReportingSettings.commonCriteriaModeEnabled est "false".
POLICY_SIGNATURE_VERIFICATION_DISABLED La validation de la signature de la règle est désactivée sur l'appareil, car commonCriteriaMode est défini sur "False".
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED La signature de la règle a bien été validée.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED La validation de la signature de la stratégie n'est pas prise en charge, par exemple parce que l'appareil a été enregistré avec une version de CloudDPC qui n'est pas compatible avec la validation de la signature de la stratégie.
POLICY_SIGNATURE_VERIFICATION_FAILED La validation de la signature de la stratégie a échoué. La règle n'a pas été appliquée.

DpcMigrationInfo

Informations indiquant si cet appareil a été migré depuis la gestion par un autre outil de contrôle des règles relatives aux appareils (DPC).

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

string

Uniquement en sortie. Si cet appareil a été migré à partir d'un autre DPC, il s'agit de son nom de package. Sinon, elle n'est pas renseignée.
additionalData

string

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

Méthodes

delete

 Supprime un appareil.

get

 Permet d'obtenir un appareil.

issueCommand

 Émet une commande à un appareil.

list

 Liste les appareils d'une entreprise donnée.

patch

 Met à jour un appareil.