REST Resource: enterprises.devices

Ressource: Appareil

Un 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 requête patch. Notez que lorsque vous appelez enterprises.devices.patch, ACTIVE et DISABLED sont les seules valeurs autorisées. Pour activer l'état DELETED sur l'appareil, appelez enterprises.devices.delete.

appliedState

enum (DeviceState)

État actuellement appliqué à l'appareil.

policyCompliant

boolean

Indique si l'appareil est conforme aux règles définies.

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)

Dernière fois que 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)

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

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 requête patch. Vous ne pouvez spécifier que policyId lorsque vous appelez enterprises.devices.patch, à condition que policyId ne contienne aucune barre oblique. 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é à 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 le motif de désactivation. 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 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 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 présentés 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: contient des informations sur la mémoire et l'espace de stockage de l'appareil.

memoryEvents[]

object (MemoryEvent)

Événements liés aux mesures de mémoire et de 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'é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 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 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 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 défini sur true dans les règles de l'appareil, si celui-ci est détenu par l'entreprise.

appliedPasswordPolicies[]

object (PasswordRequirements)

Exigences relatives aux mots 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é transféré ou non depuis 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, le serveur ne connaît pas l'état de l'appareil.
PROVISIONING L'appareil est en cours de provisionnement. Cet état s'applique aux appareils nouvellement enregistrés 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 à migrer vers l'API Android Management. Aucune autre action n'est requise de votre part pour que la migration se poursuive.
DEACTIVATED_BY_DEVICE_FINANCE Cet appareil financé a été "verrouillé" par l'agent financier. 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 financier. 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 comme DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Fournit des détails sur le non-respect 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 d'un champ Policy de niveau supérieur au format JSON.

nonComplianceReason

enum (NonComplianceReason)

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

packageName

string

Nom du package indiquant quelle application n'est pas conforme, le cas échéant.

fieldPath

string

Pour les paramètres comportant des champs imbriqués, si un champ imbriqué particulier n'est pas conforme, indique le chemin d'accès complet vers ce champ. 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 ARRAY, 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 de la troisième application, le chemin d'accès est applications[2].externalData.url.

currentValue

value (Value format)

Valeur actuelle du paramètre sur l'appareil, si le paramètre de la 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, il s'agit du motif détaillé de l'impossibilité d'installer ou de mettre à jour l'application.

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'appli. Cela peut être dû au fait que l'espace de stockage de l'appareil est insuffisant, que la connexion réseau de l'appareil 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 Impossible de trouver l'appli 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 comporte 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 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. Le compte 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é la réussite de l'installation. Cela se produit généralement lorsque la connectivité Internet de l'appareil est dégradée, indisponible ou qu'il y a un problème de configuration du réseau. Veuillez vous assurer que l'appareil dispose d'une connexion Internet complète sur un réseau conforme à 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. Ce problème peut être résolu en libérant de l'espace de stockage sur l'appareil. L'installation ou la mise à jour de l'application reprendra automatiquement lorsque l'appareil disposera d'un espace de stockage suffisant.

SpecificNonComplianceReason

Découvrez pourquoi 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 Le motif de non-conformité n'est pas précisé. Les champs de specificNonComplianceContext ne sont pas définis.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED L'utilisateur doit confirmer ses identifiants en saisissant le 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 les mots de passe. passwordPoliciesContext est défini. nonComplianceReason est défini sur USER_ACTION.
ONC_WIFI_INVALID_VALUE La configuration Wi-Fi de l'ONC présente une valeur 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 indique quelle valeur de champ n'est pas 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 sur le 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 ne s'applique qu'aux profils professionnels des 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 de 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 sur 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 de 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 sur 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 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 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)

Date et heure 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é (ex. : 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, permettant de vérifier que la compilation du système n'a pas été modifiée.

systemUpdateInfo

object (SystemUpdateInfo)

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

SystemUpdateInfo

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

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 lorsque 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 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 limitation 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 enregistré auprès de la même organisation, cet ID persiste entre les configurations et même le 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'appareil affiché.

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

string

Nom de l'affichage.

displayId

integer

Identifiant unique à afficher.

refreshRate

integer

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

state

enum (DisplayState)

État de l'écran.

width

integer

Largeur d'affichage 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 train de dormir, alors que sa consommation d'énergie est suspendue.

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 de package de l'application.

versionName

string

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

versionCode

integer

Le code de la version de l'application, qui peut être utilisé pour 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 l'a installée.

applicationSource

enum (ApplicationSource)

Source du package.

state

enum (ApplicationState)

État de l'application

keyedAppStates[]

object (KeyedAppState)

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

userFacingType

enum (UserFacingType)

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

ApplicationEvent

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

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 pour remplacer l'ancienne.
RESTARTED L'application a redémarré.
PINNED L'appli 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 ce à quoi l'application fournit un état. Par exemple, lors de l'envoi de commentaires sur la configuration gérée, il peut s'agir de 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 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

Éventuellement, valeur lisible par l'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 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. Cette règle ne doit être définie que pour les conditions d'erreur réelles qu'une organisation de gestion doit corriger pour résoudre le problème.

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 visible par l'utilisateur.
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. Disponible uniquement 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. Disponible uniquement 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)

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

MemoryEvent

Événement lié aux mesures de mémoire et de 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.

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

Un é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 : niveau de batterie en pourcentage.

PowerManagementEventType

Type d'événement.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Non spécifié. Aucun événement de ce type.
BATTERY_LEVEL_COLLECTED Le niveau de la batterie a été mesuré.
POWER_CONNECTED L'appareil a commencé à se recharger.
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)

L'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ératures actuelles de chaque batterie de l'appareil, en degrés Celsius.

cpuTemperatures[]

number

Températures actuelles des processeurs en degrés Celsius pour chaque processeur de l'appareil.

gpuTemperatures[]

number

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

skinTemperatures[]

number

Températures cutanées actuelles de l'appareil en degrés Celsius.

fanSpeeds[]

number

Vitesses des ventilateurs en tr/min pour chaque ventilateur de l'appareil. Une matrice vide signifie qu'il n'y a pas de ventilateur ou que sa 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

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

unknownSourcesEnabled

boolean

Permet d'activer ou de désactiver l'installation d'applications provenant de sources inconnues.

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 de chiffrement d'un appareil.

Enums
ENCRYPTION_STATUS_UNSPECIFIED Non spécifié. Aucun appareil ne doit présenter ce type.
UNSUPPORTED Le chiffrement n'est pas compatible avec l'appareil.
INACTIVE Le chiffrement est compatible avec l'appareil, mais il n'est pas actif pour le moment.
ACTIVATING Le chiffrement n'est pas actif pour le moment, mais il est en cours d'activation.
ACTIVE Le chiffrement est actif.
ACTIVE_DEFAULT_KEY Le chiffrement est actif, mais aucune clé de chiffrement n'est définie par l'utilisateur.
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 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é. Aucun détail sur la stratégie n'est associé à cette valeur de stratégie.
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 le niveau de sécurité de l'appareil.

advice[]

object (UserFacingMessage)

Conseils destinés aux administrateurs 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 Non spécifié.
UNKNOWN_OS L'API Play Integrity détecte que l'appareil exécute un OS inconnu (la vérification de base Integrity réussit, mais ctsProfileMatch échoue).
COMPROMISED_OS L'API Play Integrity détecte que l'appareil exécute un OS compromis (échec de la vérification de l'intégrité de base).
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 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 a été transféré ou non depuis 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é depuis un autre DPC, il s'agit du nom de son package. Pas 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

Émet une commande à un appareil.

list

Liste les appareils d'une entreprise donnée.

patch

Met à jour un appareil.