MCP Tools Reference: Android Device Management MCP Server

Outil : list_devices

Liste les appareils d'une entreprise donnée. Nécessite l'ID d'entreprise dans le champ parent (par exemple, enterprises/{enterpriseId}).

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_devices.

Requête curl 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Demande à lister les appareils pour une entreprise donnée.

ListDevicesRequest

Représentation JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Champs
parent

string

Nom de l'entreprise au format enterprises/{enterpriseId}.
pageSize

integer

La taille de page demandée. Si aucune valeur n'est spécifiée, 10 appareils au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100. Les limites peuvent changer au fil du temps.
pageToken

string

Jeton identifiant une page de résultats renvoyée par le serveur.

Schéma de sortie

Réponse à une demande de liste des appareils pour une entreprise donnée.

ListDevicesResponse

Représentation JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
Champs
devices[]

object (Device)

Liste des appareils.
nextPageToken

string

Si d'autres résultats sont disponibles, un jeton permettant de récupérer la page de résultats suivante.

Appareil

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
Champs
name

string

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

string

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

enum (ManagementMode)

Type de mode de gestion qu'Android Device Policy applique à l'appareil. Cela a une incidence sur les paramètres de règles compatibles.
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 faire passer l'appareil à l'état DELETED, appelez enterprises.devices.delete.
appliedState

enum (DeviceState)

État actuellement appliqué à l'appareil.
policyCompliant

boolean

Indique si l'appareil est conforme à sa règle.
nonComplianceDetails[]

object (NonComplianceDetail)

Informations sur les paramètres de règles auxquels l'appareil n'est pas conforme.
enrollmentTime

string (Timestamp format)

Heure d'enregistrement de l'appareil.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

Date et heure du dernier rapport d'état envoyé par l'appareil.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsolète.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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, le policy_name de l'utilisateur de l'appareil est appliqué. 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 le 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é avec un jeton d'enregistrement et des données supplémentaires, 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 pour indiquer 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 les règles 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 les règles de l'appareil.
applicationReports[]

object (ApplicationReport)

Rapports pour les applications installées sur l'appareil. Ces informations ne sont disponibles que lorsque application_reports_enabled 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 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 classé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 les règles 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 mémoire et de stockage dans l'ordre chronologique. Ces informations ne sont disponibles que si memoryInfoEnabled est défini sur "True" dans les règles de l'appareil.

Les événements sont conservés pendant une certaine période, puis 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 les règles de l'appareil.
hardwareStatusSamples[]

object (HardwareStatus)

Exemples d'état du matériel par ordre chronologique. Ces informations ne sont disponibles que si hardwareStatusEnabled est défini sur "True" dans les règles 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 les règles 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 les règles 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 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 : 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 et que l'appareil appartient à l'entreprise.
appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • Ce champ existe, car les exigences appliquées peuvent être légèrement différentes de celles spécifiées dans passwordPolicies dans certains cas.
  • Notez que ce champ ne fournit pas d'informations sur la conformité des mots de passe. Pour en savoir plus sur le non-respect des règles, consultez nonComplianceDetails.
  • NonComplianceDetail.fieldPath est défini en fonction de passwordPolicies, et non de ce champ.
dpcMigrationInfo

object (DpcMigrationInfo)

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

object (DefaultApplicationInfo)

Uniquement en sortie. Informations sur l'application par défaut pour DefaultApplicationType. Ces informations ne sont disponibles que si defaultApplicationInfoReportingEnabled est défini sur "True" dans les règles de l'appareil. Disponible sur Android 16 et versions ultérieures.

Tous les types d'applications sont signalés sur les appareils entièrement gérés. Les types DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING et DEFAULT_DIALER sont signalés pour les profils professionnels sur les appareils appartenant à l'entreprise et dotés d'un profil professionnel, ainsi que sur les appareils personnels. DEFAULT_WALLET est également signalé pour les appareils appartenant à l'entreprise et dotés d'un profil professionnel, mais n'inclut que les informations du profil professionnel.

NonComplianceDetail

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 règle. Il s'agit du nom de champ JSON d'un champ Policy de premier niveau.
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 concerné est indiqué. Le chemin est mis en forme de la même manière que le champ JSON de la règle serait référencé en JavaScript, c'est-à-dire : 1) Pour les champs de type objet, le nom du champ est suivi d'un point, puis du nom d'un 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 dans le champ externalData de 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 package_name 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 ni 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 specific_non_compliance_reason.

Valeur

Représentation JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente une valeur nulle.
numberValue

number

Représente une valeur double.
stringValue

string

Représente une valeur de chaîne.
boolValue

boolean

Représente une valeur booléenne.
structValue

object (Struct format)

Représente une valeur structurée.
listValue

array (ListValue format)

Représente un Value répété.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

map (key: string, value: value (Value format))

Carte non ordonnée de valeurs typées de manière dynamique.

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

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

SpecificNonComplianceContext

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

object (OncWifiContext)

Contexte supplémentaire pour le non-respect lié à la configuration du Wi-Fi. Consultez ONC_WIFI_INVALID_VALUE et ONC_WIFI_API_LEVEL.
passwordPoliciesContext

object (PasswordPoliciesContext)

Contexte supplémentaire en cas de non-respect des règles relatives aux mots de passe. Consultez les PASSWORD_POLICIES_PASSWORD_EXPIRED et l'PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.
defaultApplicationContext

object (DefaultApplicationContext)

Uniquement en sortie. Informations supplémentaires sur le non-respect des règles concernant les paramètres d'application par défaut. Consultez les DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

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

string

GUID de la configuration Wi-Fi non conforme.

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

Champ d'application du mot de passe non conforme.

DefaultApplicationContext

Représentation JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Champs
defaultApplicationScope

enum (DefaultApplicationScope)

Uniquement en sortie. Champ d'application du paramètre d'application par défaut non conforme.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

UserFacingMessage

Représentation JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Champs
localizedMessages

map (key: string, value: string)

Map contenant des paires <locale, message>, où "locale" est un code de langue BCP 47 bien formé, tel que en-US, es-ES ou fr.

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

string

Message par défaut affiché si aucun message localisé n'est spécifié ou si le code de langue de l'utilisateur ne correspond à aucun des messages localisés. Un message par défaut doit être fourni si des messages localisés sont fournis.

LocalizedMessagesEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

SoftwareInfo

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 compilation Android destinée à être affiché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 système, par exemple 0.6.7.
androidBuildTime

string (Timestamp format)

Durée de compilation.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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 peut être utilisé pour vérifier que la compilation du système n'a pas été modifiée.
systemUpdateInfo

object (SystemUpdateInfo)

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

SystemUpdateInfo

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 elle est.
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 si updateStatus n'est ni UPDATE_STATUS_UNKNOWN ni UP_TO_DATE).

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

HardwareInfo

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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
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. Toutefois, pour les appareils personnels équipés d'Android 12 ou version ultérieure, cela correspond à enterpriseSpecificId.
model

string

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

number

Seuils de température de mise hors tension 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 cutanée de l'appareil en degrés Celsius.
skinThrottlingTemperatures[]

number

Seuils de température de limitation 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 spécifique. Sur le même appareil physique, lorsque l'utilisateur est inscrit dans la même organisation, cet ID est conservé lors des 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 et équipés d'Android 12 ou version ultérieure.
euiccChipInfo[]

object (EuiccChipInfo)

Uniquement en sortie. Informations liées à la puce eUICC.

EuiccChipInfo

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

string

Uniquement en sortie. Document d'identité intégré (EID, Embedded Identity Document) qui identifie la puce eUICC pour chaque puce eUICC de l'appareil. Cette fonctionnalité est disponible sur les appareils appartenant à l'entreprise et équipés d'Android 13 ou version ultérieure.

Écran

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'écran 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 de l'écran en pixels.
density

integer

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

ApplicationReport

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 affichée à l'utilisateur.
versionCode

integer

Code de 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 peut être utilisé pour 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

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 la demande.
keyedAppStates[]

object (KeyedAppState)

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

enum (UserFacingType)

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

ApplicationEvent

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

KeyedAppState

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

Chaîne de message au format libre (facultative) permettant d'expliquer l'état de l'application. Si l'état a été déclenché par une valeur spécifique (par exemple, une valeur de configuration gérée), il doit être inclus dans le message.
data

string

Valeur lisible par une machine, à lire par l'EMM (facultatif). Par exemple, en définissant des valeurs que l'administrateur peut choisir d'interroger 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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

NetworkInfo

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 des informations sur la 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 23 d'Android.

TelephonyInfo

Représentation JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
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. ICCID associé à cette carte SIM.
activationState

enum (ActivationState)

Uniquement en sortie. État d'activation de la carte SIM sur l'appareil. Cela ne s'applique qu'aux eSIM. Cette fonctionnalité est compatible avec tous les appareils pour le niveau d'API 35 et versions ultérieures. Il s'agit toujours de ACTIVATION_STATE_UNSPECIFIED pour les cartes SIM physiques et pour les appareils dont le niveau d'API est inférieur à 35.
configMode

enum (ConfigMode)

Uniquement en sortie. Mode de configuration de la carte SIM sur l'appareil. Cela ne s'applique qu'aux eSIM. Cette fonctionnalité est compatible avec tous les appareils pour le niveau d'API 35 et versions ultérieures. Il s'agit toujours de CONFIG_MODE_UNSPECIFIED pour les cartes SIM physiques et pour les appareils dont le niveau d'API est inférieur à 35.

MemoryInfo

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 sur l'appareil, en octets.

MemoryEvent

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

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

PowerManagementEvent

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
batteryLevel

number

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

HardwareStatus

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.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

Températures actuelles de chaque 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 des 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

Vitesse de rotation par minute 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 sur 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éconnecté. Un tableau vide signifie que l'utilisation du processeur n'est pas prise en charge dans le système.

DeviceSettings

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é par un code ou un 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 à partir de DevicePolicyManager.
verifyAppsEnabled

boolean

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

Utilisateur

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

string

Identifiant unique que vous créez pour cet utilisateur, par exemple user342 ou asset#44418. Ce champ doit être défini lors de la création de l'utilisateur et ne peut pas être modifié. Ce champ ne doit pas contenir d'informations permettant d'identifier personnellement l'utilisateur. Cet identifiant ne doit pas comporter plus de 1 024 caractères. Sinon, la demande de mise à jour des règles échouera.

SystemPropertiesEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

SecurityPosture

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 le niveau de sécurité de l'appareil.

PostureDetail

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 destinés aux administrateurs pour atténuer ce risque de sécurité et améliorer la sécurité de l'appareil.

CommonCriteriaModeInfo

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 règle.

PasswordRequirements

Représentation JSON 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Champs
passwordMinimumLength

integer

Longueur minimale autorisée du mot de passe. Une valeur de 0 signifie qu'il n'y a aucune restriction. N'est appliqué que lorsque password_quality est défini sur NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC ou COMPLEX.
passwordMinimumLetters

integer

Nombre minimal de lettres requises dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordMinimumLowerCase

integer

Nombre minimal de lettres minuscules requises dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordMinimumNonLetter

integer

Nombre minimal de caractères autres que des lettres (chiffres ou symboles) requis dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordMinimumNumeric

integer

Nombre minimal de chiffres requis dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordMinimumSymbols

integer

Nombre minimal de symboles requis dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordMinimumUpperCase

integer

Nombre minimal de lettres majuscules requises dans le mot de passe. N'est appliqué que lorsque password_quality est défini sur COMPLEX.
passwordQuality

enum (PasswordQuality)

Qualité requise du mot de passe.
passwordHistoryLength

integer

Longueur de l'historique des mots de passe. Une fois ce champ défini, l'utilisateur ne pourra pas saisir un nouveau mot de passe identique à un mot de passe de l'historique. Une valeur de 0 signifie qu'il n'y a aucune restriction.
maximumFailedPasswordsForWipe

integer

Nombre de mots de passe incorrects pouvant être saisis pour déverrouiller un appareil avant que ses données ne soient effacées. Une valeur de 0 signifie qu'il n'y a aucune restriction.
passwordExpirationTimeout

string (Duration format)

Délai avant expiration du mot de passe.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
passwordScope

enum (PasswordPolicyScope)

Champ d'application de l'exigence relative au mot de passe.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Durée pendant laquelle un appareil ou un profil professionnel déverrouillé à l'aide d'une méthode d'authentification forte (mot de passe, code, schéma) peut être déverrouillé à l'aide d'une autre méthode d'authentification (empreinte digitale, agents de confiance, reconnaissance faciale, par exemple). Une fois le délai spécifié écoulé, seules les méthodes d'authentification forte peuvent être utilisées pour déverrouiller l'appareil ou le profil professionnel.
unifiedLockSettings

enum (UnifiedLockSettings)

Contrôle si un verrouillage unifié est autorisé pour l'appareil et le profil professionnel sur les appareils équipés d'Android 9 ou version ultérieure avec un profil professionnel. Cette option ne peut être définie que si password_scope est défini sur SCOPE_PROFILE. Sinon, la règle sera refusée. Si l'utilisateur n'a pas défini de verrouillage distinct pour le profil professionnel et que ce champ est défini sur REQUIRE_SEPARATE_WORK_LOCK, un NonComplianceDetail est signalé avec nonComplianceReason défini sur USER_ACTION.

Durée

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Secondes signées de la durée. La valeur doit être comprise entre -315 576 000 000 et +315 576 000 000 (inclus). Remarque : Ces limites sont calculées à partir de : 60 s/min * 60 min/h * 24 h/jour * 365,25 jours/an * 10 000 ans
nanos

integer

Fractions de secondes signées avec une précision de l'ordre de la nanoseconde pour la durée. Les durées inférieures à une seconde sont représentées par un champ seconds égal à 0 et un champ nanos positif ou négatif. Pour les durées d'une seconde ou plus, une valeur non nulle pour le champ nanos doit avoir le même signe que le champ seconds. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus.

DpcMigrationInfo

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

string

Uniquement en sortie. Nom du package de l'appareil s'il a été migré depuis un autre DPC. Sinon, elle n'est pas renseignée.
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.

DefaultApplicationInfo

Représentation JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Champs
defaultApplicationType

enum (DefaultApplicationType)

Uniquement en sortie. Type d'application par défaut.
packageName

string

Uniquement en sortie. Nom du package de l'application par défaut actuelle.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Uniquement en sortie. Détails sur les tentatives de paramètre d'application par défaut, dans le même ordre que ceux listés dans defaultApplications.

DefaultApplicationSettingAttempt

Représentation JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Champs
packageName

string

Uniquement en sortie. Nom du package de l'application concernée.
attemptOutcome

enum (AttemptOutcome)

Uniquement en sortie. Résultat de la définition de l'application comme application par défaut.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌