REST Resource: enterprises.devices

{
  "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)
  }
}

string

O nome do dispositivo no formato enterprises/{enterpriseId}/devices/{deviceId}.

string

O nome do recurso do usuário proprietário do dispositivo no formato enterprises/{enterpriseId}/users/{userId}.

enum (ManagementMode)

O tipo de modo de gerenciamento que o Android Device Policy aceita no dispositivo. Isso influencia quais configurações de política são compatíveis.

enum (DeviceState)

O estado a ser aplicado ao dispositivo. Este campo pode ser modificado por uma solicitação de patch. Observe que, ao chamar enterprises.devices.patch, ACTIVE e DISABLED são os únicos valores permitidos. Para inserir o dispositivo no estado DELETED, chame enterprises.devices.delete.

enum (DeviceState)

O estado atualmente aplicado ao dispositivo.

boolean

Se o dispositivo está em conformidade com a política.

object (NonComplianceDetail)

Detalhes sobre as configurações de política com as quais o dispositivo não está em compliance.

string (Timestamp format)

O momento do registro do dispositivo.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

A última vez que o dispositivo enviou um relatório de status.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Obsoleto.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

A última vez que o dispositivo buscou a política.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string

O nome da política aplicada ao dispositivo, no formato enterprises/{enterpriseId}/policies/{policyId}. Se não for especificado, o policyName do usuário do dispositivo será aplicado. Este campo pode ser modificado por uma solicitação de patch. Só é possível especificar o policyId ao chamar enterprises.devices.patch, desde que o policyId não contenha barras. O restante do nome da política é inferido.

string

O nome da política aplicada ao dispositivo atualmente.

string (int64 format)

A versão da política aplicada ao dispositivo atualmente.

integer

O nível da API da versão da plataforma Android em execução no dispositivo.

string

Se o dispositivo tiver sido registrado com um token com dados adicionais, esse campo vai conter esses dados.

string

Se o dispositivo tiver sido registrado com um token de registro, esse campo conterá o nome do token.

object (UserFacingMessage)

Se o estado do dispositivo for DISABLED, uma mensagem opcional vai aparecer indicando o motivo da desativação. Este campo pode ser modificado por uma solicitação de patch.

object (SoftwareInfo)

Informações detalhadas sobre o software do dispositivo. Essas informações só estarão disponíveis se softwareInfoEnabled for verdadeiro na política do dispositivo.

object (HardwareInfo)

Informações detalhadas sobre o hardware do dispositivo.

object (Display)

Informações detalhadas sobre as telas do dispositivo. Essas informações só estarão disponíveis se displayInfoEnabled for verdadeiro na política do dispositivo.

object (ApplicationReport)

Informa os apps instalados no dispositivo. Essas informações só estão disponíveis quando applicationReportsEnabled é verdadeiro na política do dispositivo.

string

Se o mesmo dispositivo físico tiver sido registrado várias vezes, este campo conterá os nomes dos dispositivos anteriores. O número de série é usado como o identificador exclusivo para determinar se o mesmo dispositivo físico já foi registrado anteriormente. Os nomes são em ordem cronológica.

object (NetworkInfo)

Informações da rede do dispositivo. Essas informações só estarão disponíveis se networkInfoEnabled for verdadeiro na política do dispositivo.

object (MemoryInfo)

Informações sobre a memória: contém informações sobre a memória e o armazenamento do dispositivo.

object (MemoryEvent)

Eventos relacionados às medições de memória e armazenamento em ordem cronológica. Essas informações só estarão disponíveis se memoryInfoEnabled for verdadeiro na política do dispositivo.

Os eventos ficam retidos por um determinado período, e os antigos são excluídos.

object (PowerManagementEvent)

Eventos de gerenciamento de energia no dispositivo em ordem cronológica. Essas informações só estarão disponíveis se powerManagementEventsEnabled for verdadeiro na política do dispositivo.

object (HardwareStatus)

Exemplos de status de hardware em ordem cronológica. Essas informações só estarão disponíveis se hardwareStatusEnabled for verdadeiro na política do dispositivo.

object (DeviceSettings)

Informações de configurações do dispositivo. Essas informações só estarão disponíveis se deviceSettingsEnabled for verdadeiro na política do dispositivo.

object (User)

O usuário proprietário do dispositivo.

map (key: string, value: string)

Mapa com o nome e o valor das propriedades do sistema selecionadas relacionadas ao dispositivo. Essas informações só estarão disponíveis se systemPropertiesEnabled for verdadeiro na política do dispositivo.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (SecurityPosture)

Valor de postura de segurança que reflete o nível de segurança do dispositivo.

enum (Ownership)

Propriedade do dispositivo gerenciado.

object (CommonCriteriaModeInfo)

Informações sobre o modo Common Criteria: padrões de segurança definidos no Common Criteria for Information Technology Security Avaliação (CC).

Essas informações só estarão disponíveis se statusReportingSettings.commonCriteriaModeEnabled for true na política do dispositivo que pertence à empresa.

object (PasswordRequirements)

Os requisitos de senha atualmente aplicados ao dispositivo.

• Os requisitos aplicados podem ser um pouco diferentes daqueles especificados em passwordPolicies em alguns casos.
• fieldPath é definido com base em passwordPolicies.

object (DpcMigrationInfo)

Apenas saída. Informações relacionadas ao fato de o dispositivo ter sido migrado do gerenciamento por outro controlador de política de dispositivo (DPC).

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

string

O nome da configuração da política. Este é o nome de campo JSON de um campo Policy de nível superior.

enum (NonComplianceReason)

O motivo pelo qual o dispositivo não está em compliance com a configuração.

string

O nome do pacote que indica qual app não está em conformidade, se aplicável.

string

Para configurações com campos aninhados, se um determinado campo aninhado não estiver em compliance, isso vai especificar o caminho completo para o campo ofensivo. O caminho é formatado da mesma forma que o campo JSON da política seria referenciado em JavaScript, ou seja: 1) Para campos do tipo objeto, o nome do campo é seguido por um ponto e depois por um nome de subcampo. 2) Para campos digitados em matriz, o nome do campo é seguido pelo índice da matriz entre colchetes. Por exemplo, para indicar um problema com o campo url no campo externalData no terceiro aplicativo, o caminho seria applications[2].externalData.url.

value (Value format)

Se a configuração da política não puder ser aplicada, o valor atual da configuração no dispositivo.

enum (InstallationFailureReason)

Se packageName estiver definido e o motivo da não conformidade for APP_NOT_INSTALLED ou APP_NOT_UPDATED, o motivo detalhado por que não é possível instalar ou atualizar o app.

enum (SpecificNonComplianceReason)

O motivo específico da política pelo qual o dispositivo não está em compliance com a configuração.

object (SpecificNonComplianceContext)

Contexto adicional para specificNonComplianceReason.

{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}

object (OncWifiContext)

Contexto adicional para a não conformidade relacionada à configuração de Wi-Fi. Consulte ONC_WIFI_INVALID_VALUE e ONC_WIFI_API_LEVEL

object (PasswordPoliciesContext)

Contexto adicional para a não conformidade relacionada a políticas de senha. Consulte PASSWORD_POLICIES_PASSWORD_EXPIRED e PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

{
  "wifiGuid": string
}

string

O GUID da configuração de Wi-Fi incompatível.

{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}

enum (PasswordPolicyScope)

O escopo da senha não compatível.

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

string

A string da versão do Android visível ao usuário. Por exemplo, 6.0.1.

integer

O código da versão do app Android Device Policy.

string

A versão do app Android Device Policy conforme exibida para o usuário.

string

String do ID da versão do Android destinada a ser exibida ao usuário. Por exemplo, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.

string

Versão do kernel, por exemplo, 2.6.32.9-g103d848.

string

O número da versão do carregador de inicialização do sistema, por exemplo, 0.6.7:

string (Timestamp format)

Tempo de build.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string

Nível do patch de segurança, por exemplo: 2016-05-01:

string

Um código de idioma IETF BCP 47 para a localidade principal no dispositivo.

string

Hash SHA-256 de android.content.pm.Signature associado ao pacote do sistema, que pode ser usado para verificar se o build do sistema não foi modificado.

object (SystemUpdateInfo)

Informações sobre uma possível atualização do sistema pendente.

{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}

enum (UpdateStatus)

O status de uma atualização: se ela existe e qual é o tipo.

string (Timestamp format)

A hora em que a atualização foi disponibilizada pela primeira vez. O valor zero indica que esse campo não está definido. Esse campo só será definido se houver uma atualização disponível (ou seja, updateStatus não é UPDATE_STATUS_UNKNOWN nem UP_TO_DATE).

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "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
}

string

Marca do dispositivo. Por exemplo, Google.

string

Nome do hardware. Por exemplo, Angler.

string

Versão da banda de base. Por exemplo, MDM9625_104662.22.05.34p.

string

Fabricante. Por exemplo, Motorola.

string

O número de série do dispositivo.

string

O modelo do dispositivo. Por exemplo, Asus Nexus 7.

number

Limites de temperatura de desligamento da bateria em Celsius para cada bateria no dispositivo.

number

Limites de temperatura de limitação de bateria em Celsius para cada bateria no dispositivo.

number

Limites de temperatura de desligamento da CPU em graus Celsius para cada CPU no dispositivo.

number

A CPU limita os limites de temperatura em Celsius para cada CPU no dispositivo.

number

Os limites de temperatura de desligamento da GPU em Celsius para cada GPU no dispositivo.

number

Limites de temperatura de limitação de GPU em graus Celsius para cada GPU no dispositivo.

number

Limites de temperatura de desligamento da skin do dispositivo em Celsius.

number

Limites de temperatura de limitação da pele do dispositivo em Celsius.

string

Apenas saída. ID que identifica exclusivamente um dispositivo pessoal em uma organização específica. Quando você faz o registro na mesma organização no mesmo dispositivo físico, esse ID persiste entre as configurações e até as redefinições para a configuração original. Esse ID está disponível em dispositivos pessoais com um perfil de trabalho em dispositivos com o Android 12 ou versões mais recentes.

{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}

string

Nome da tela.

integer

ID de exibição exclusivo.

integer

Taxa de atualização da tela em quadros por segundo.

enum (DisplayState)

Estado da tela.

integer

Mostra a largura em pixels.

integer

Mostra a altura em pixels.

integer

Densidade de exibição expressa como pontos por polegada.

{
  "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)
}

string

Nome do pacote do app.

string

A versão do app conforme exibida para o usuário.

integer

O código da versão do app, que pode ser usado para determinar se uma versão é mais recente que outra.

object (ApplicationEvent)

A lista de eventos do app que ocorreram nas últimas 30 horas.

string

O nome de exibição do app.

string

O hash SHA-256 do arquivo APK do app, que pode ser usado para verificar se o app não foi modificado. Cada byte do valor de hash é representado como um número hexadecimal de dois dígitos.

string

O hash SHA-1 de cada android.content.pm.Signature associado ao pacote do app. Cada byte de cada valor de hash é representado como um número hexadecimal de dois dígitos.

string

O nome do pacote do app que o instalou.

enum (ApplicationSource)

A origem do pacote.

enum (ApplicationState)

Estado do aplicativo.

object (KeyedAppState)

Lista de estados do app com chave informados por ele.

enum (UserFacingType)

Se o app é voltado ao usuário.

{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}

enum (ApplicationEventType)

Tipo de evento do app.

string (Timestamp format)

A hora de criação do evento.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}

string

A chave para o estado do app. Funciona como um ponto de referência para o que o app fornece o estado. Por exemplo, ao enviar feedback de configuração gerenciada, essa chave pode ser a chave de configuração gerenciada.

enum (Severity)

A gravidade do estado do app.

string

Opcionalmente, uma string de mensagem de formato livre para explicar o estado do app. Se o estado foi acionado por um valor específico (por exemplo, um valor de configuração gerenciada), ele precisa ser incluído na mensagem.

string

Opcionalmente, um valor legível por máquina a ser lido pelo EMM. Por exemplo, definir valores que o administrador pode optar por consultar no console de EMM, como "notificar-me se os dados de Battery_warning forem menores que 10".

string (Timestamp format)

O horário de criação do estado do app no dispositivo.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

O horário em que o estado do app foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}

string

Número IMEI do dispositivo GSM. Por exemplo, A1000031212.

string

Número MEID do dispositivo CDMA. Por exemplo, A00000292788E1.

string

Endereço MAC Wi-Fi do dispositivo. Por exemplo, 7c:11:11:11:11:11.

string

Nome em ordem alfabética do operador registrado atual. Por exemplo, Vodafone.

object (TelephonyInfo)

Fornece informações de telefonia associadas a cada chip no dispositivo. Compatível apenas com dispositivos totalmente gerenciados a partir do nível 23 da API do Android.

{
  "phoneNumber": string,
  "carrierName": string
}

string

O número de telefone associado a este chip.

string

O nome da operadora associada a este chip.

{
  "totalRam": string,
  "totalInternalStorage": string
}

string (int64 format)

Total de RAM no dispositivo em bytes.

string (int64 format)

Armazenamento interno total no dispositivo em bytes.

{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}

enum (MemoryEventType)

Tipo de evento.

string (Timestamp format)

A hora de criação do evento.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (int64 format)

O número de bytes livres na mídia ou, para EXTERNAL_STORAGE_DETECTED, a capacidade total em bytes da mídia de armazenamento.

{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}

enum (PowerManagementEventType)

Tipo de evento.

string (Timestamp format)

A hora de criação do evento.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

number

Para eventos BATTERY_LEVEL_COLLECTED, é o nível da bateria em porcentagem.

{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}

string (Timestamp format)

A hora em que as medições foram feitas.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

number

Temperaturas atuais em graus Celsius para cada bateria do dispositivo.

number

As temperaturas atuais da CPU em graus Celsius para cada CPU do dispositivo.

number

As temperaturas atuais da GPU em graus Celsius para cada GPU no dispositivo.

number

Temperaturas da pele atuais do dispositivo em graus Celsius.

number

Velocidades do ventilador (em RPM) para cada ventilador no dispositivo. Uma matriz vazia significa que não há ventiladores ou que a velocidade do ventilador não é compatível com o sistema.

number

Usos da CPU em porcentagem para cada núcleo disponível no dispositivo. O uso é 0 para cada núcleo desconectado. Uma matriz vazia indica que o uso da CPU não é suportado no sistema.

{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}

boolean

Se o dispositivo está protegido com PIN/senha.

boolean

Indica se a instalação de apps de fontes desconhecidas está ativada.

boolean

Se o modo de desenvolvedor está ativado no dispositivo.

boolean

Indica se o ADB está ativado no dispositivo.

boolean

Indica se a criptografia de armazenamento está ativada.

enum (EncryptionStatus)

Status de criptografia do DevicePolicyManager.

boolean

Indica se a verificação do Google Play Protect foi aplicada ao dispositivo.

{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}

enum (DevicePosture)

Valor da postura de segurança do dispositivo.

object (PostureDetail)

Detalhes adicionais sobre a postura de segurança do dispositivo.

{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}

enum (SecurityRisk)

Risco de segurança específico que afeta negativamente a postura de segurança do dispositivo.

object (UserFacingMessage)

Orientações correspondentes aos administradores para reduzir esse risco e melhorar a segurança do dispositivo.

{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}

enum (CommonCriteriaModeStatus)

Indica se o modo Common Criteria está ativado.

{
  "previousDpc": string,
  "additionalData": string
}

string

Apenas saída. Se o dispositivo foi migrado de outro DPC, este é o nome do pacote dele. Caso contrário, não será preenchido.

string

Apenas saída. Se o dispositivo tiver sido migrado de outro DPC, o campo additionalData do token de migração será preenchido aqui.