REST Resource: enterprises.devices

Recurso: dispositivo

Um dispositivo de propriedade de uma empresa. A menos que indicado de outra forma, todos os campos são somente leitura e não podem ser modificados por enterprises.devices.patch.

Representação 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)
    }
  ]
}
Campos
name

string

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

string

O nome do recurso do usuário que tem o dispositivo no formato enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

O tipo de modo de gerenciamento do Android Device Policy usado no dispositivo. Isso influencia as configurações de política compatíveis.
state

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 em um estado DELETED, chame enterprises.devices.delete.
appliedState

enum (DeviceState)

O estado atualmente aplicado ao dispositivo.
policyCompliant

boolean

Indica se o dispositivo está em compliance com a política.
nonComplianceDetails[]

object (NonComplianceDetail)

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

string (Timestamp format)

A hora de registro do dispositivo.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
lastStatusReportTime

string (Timestamp format)

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

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsoleto.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
lastPolicySyncTime

string (Timestamp format)

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

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
policyName

string

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

string

O nome da política atualmente aplicada ao dispositivo.
appliedPolicyVersion

string (int64 format)

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

integer

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

string

Se o dispositivo tiver sido registrado com um token de registro com dados adicionais fornecidos, este campo conterá esses dados.
enrollmentTokenName

string

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

object (UserFacingMessage)

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

object (SoftwareInfo)

Informações detalhadas sobre o software do dispositivo. Essas informações só ficam disponíveis quando softwareInfoEnabled é verdadeiro na política do dispositivo.
hardwareInfo

object (HardwareInfo)

Informações detalhadas sobre o hardware do dispositivo.
displays[]

object (Display)

Informações detalhadas sobre telas no dispositivo. Essas informações só ficam disponíveis quando displayInfoEnabled é verdadeiro na política do dispositivo.
applicationReports[]

object (ApplicationReport)

Relatórios de apps instalados no dispositivo. Essa informação só fica disponível quando applicationReportsEnabled é verdadeiro na política do dispositivo.
previousDeviceNames[]

string

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

object (NetworkInfo)

Informações da rede do dispositivo. Essas informações só ficam disponíveis quando networkInfoEnabled é verdadeiro na política do dispositivo.
memoryInfo

object (MemoryInfo)

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

object (MemoryEvent)

Eventos relacionados a medições de memória e armazenamento em ordem cronológica. Essas informações só ficam disponíveis quando memoryInfoEnabled é verdadeiro na política do dispositivo.
powerManagementEvents[]

object (PowerManagementEvent)

Eventos de gerenciamento de energia no dispositivo em ordem cronológica. Essas informações só ficam disponíveis quando powerManagementEventsEnabled é verdadeiro na política do dispositivo.
hardwareStatusSamples[]

object (HardwareStatus)

Amostras de status de hardware em ordem cronológica Essas informações só ficam disponíveis quando hardwareStatusEnabled é verdadeiro na política do dispositivo.
deviceSettings

object (DeviceSettings)

Informações de configurações do dispositivo. Essas informações só ficam disponíveis quando deviceSettingsEnabled é verdadeiro na política do dispositivo.
user

object (User)

O usuário proprietário do dispositivo.
systemProperties

map (key: string, value: string)

Mapa do nome e do valor das propriedades do sistema selecionados relacionados ao dispositivo. Essas informações só ficam disponíveis quando systemPropertiesEnabled é verdadeiro na política do dispositivo.

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

object (SecurityPosture)

Valor de postura de segurança do dispositivo que reflete a segurança do aparelho.
ownership

enum (Ownership)

Propriedade do dispositivo gerenciado.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

Essas informações só ficam disponíveis quando statusReportingSettings.commonCriteriaModeEnabled é true na política do dispositivo.
appliedPasswordPolicies[]

object (PasswordRequirements)

Os requisitos de senha aplicados ao dispositivo no momento.

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

Modo de gerenciamento

O tipo de modo de gerenciamento do Android Device Policy usado no dispositivo.

Enums
MANAGEMENT_MODE_UNSPECIFIED Este valor não é permitido.
DEVICE_OWNER Proprietário do dispositivo. O Android Device Policy tem controle total sobre o dispositivo.
PROFILE_OWNER Proprietário do perfil. O Android Device Policy tem controle sobre um perfil gerenciado no dispositivo.

DeviceState

Estados que podem ser aplicados a um dispositivo.

Enums
DEVICE_STATE_UNSPECIFIED Este valor não é permitido.
ACTIVE O dispositivo está ativo.
DISABLED O dispositivo está desativado.
DELETED O dispositivo foi excluído. Esse estado nunca é retornado por uma chamada de API, mas é usado no relatório de status final quando o dispositivo reconhece a exclusão. Se o dispositivo for excluído pela chamada de API, esse estado será publicado no Pub/Sub. Se o usuário excluir o perfil de trabalho ou redefinir o dispositivo, o estado do dispositivo permanecerá desconhecido para o servidor.
PROVISIONING O dispositivo está sendo provisionado. Os dispositivos registrados recentemente ficam nesse estado até que uma política seja aplicada.

Detalhes da não conformidade

Mostra detalhes sobre a não conformidade com uma configuração de política.

Representação JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Campos
settingName

string

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

enum (NonComplianceReason)

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

string

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

string

Para configurações com campos aninhados, se um campo aninhado específico estiver fora de conformidade, isso 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 digitados por objeto, o nome do campo é seguido por um ponto e por um nome de subcampo. 2) Para campos do tipo 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
currentValue

value (Value format)

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

enum (InstallationFailureReason)

Se packageName estiver definido e o motivo de não conformidade for APP_NOT_INSTALLED ou APP_NOT_UPDATED, o motivo detalhado não vai poder ser instalado ou atualizado.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Contexto adicional para specificNonComplianceReason.

Motivo da falha na instalação

Motivos de falhas na instalação de um app.

Enums
INSTALLATION_FAILURE_REASON_UNSPECIFIED Este valor não é permitido.
INSTALLATION_FAILURE_REASON_UNKNOWN Uma condição desconhecida impede que o app seja instalado. Alguns possíveis motivos são: o dispositivo não tem armazenamento suficiente, a conexão de rede do dispositivo não é confiável ou a instalação está demorando mais do que o esperado. Uma nova tentativa de instalação vai ser automática.
IN_PROGRESS A instalação ainda está em andamento.
NOT_FOUND O app não foi encontrado no Google Play.
NOT_COMPATIBLE_WITH_DEVICE O app é incompatível com o dispositivo.
NOT_APPROVED O app não foi aprovado pelo administrador.
PERMISSIONS_NOT_ACCEPTED O app tem novas permissões que não foram aceitas pelo administrador.
NOT_AVAILABLE_IN_COUNTRY O aplicativo não está disponível no país do usuário.
NO_LICENSES_REMAINING Não há licenças disponíveis para atribuir ao usuário.
NOT_ENROLLED A empresa não está mais inscrita no Google Play gerenciado ou o administrador não aceitou os novos Termos de Serviço.
USER_INVALID O usuário não é mais válido. O usuário pode ter sido excluído ou desativado.

Motivo da não conformidade específico

Mais detalhes sobre o motivo pelo qual um dispositivo não está em compliance com uma configuração de política. Novos valores podem ser adicionados ao tipo enumerado no futuro.

Enums
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Um motivo específico de não conformidade não foi informado. Os campos em specificNonComplianceContext não estão definidos.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED O usuário precisa confirmar as credenciais digitando o bloqueio de tela. Os campos em specificNonComplianceContext não estão definidos. nonComplianceReason está definido como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED A senha do dispositivo ou do perfil expirou. passwordPoliciesContext foi definido. nonComplianceReason está definido como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT A senha do dispositivo não atende aos requisitos de senha. passwordPoliciesContext foi definido. nonComplianceReason está definido como USER_ACTION.
ONC_WIFI_INVALID_VALUE Há um valor incorreto na configuração de Wi-Fi do ONC. fieldPath especifica qual valor de campo está incorreto. oncWifiContext foi definido. nonComplianceReason está definido como INVALID_VALUE.
ONC_WIFI_API_LEVEL A configuração Wi-Fi do ONC não é compatível com o nível da API da versão do Android em execução no dispositivo. fieldPath especifica qual valor de campo não é compatível. oncWifiContext foi definido. nonComplianceReason está definido como API_LEVEL.

Contexto específico de não conformidade

Contexto adicional para SpecificNonComplianceReason.

Representação JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Campos
oncWifiContext

object (OncWifiContext)

Contexto adicional para não conformidade relacionado à configuração de Wi-Fi. Ver ONC_WIFI_INVALID_VALUE e ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

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

OncWifiContext

Contexto adicional para não conformidade relacionado à configuração de Wi-Fi.

Representação JSON 
{
  "wifiGuid": string
}
Campos
wifiGuid

string

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

Contexto da política de senhas

Contexto adicional para casos de não conformidade relacionados a políticas de senha.

Representação JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Campos
passwordPolicyScope

enum (PasswordPolicyScope)

O escopo da senha não compatível.

Informações de software

Informações sobre o software do dispositivo.

Representação JSON 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Campos
androidVersion

string

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

integer

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

string

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

string

String do ID do build do Android criada para exibição ao usuário. Por exemplo, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

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

string

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

string (Timestamp format)

Tempo de compilação.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
securityPatchLevel

string

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

string

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

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

object (SystemUpdateInfo)

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

SystemUpdateInfo

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

Representação JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Campos
updateStatus

enum (UpdateStatus)

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

string (Timestamp format)

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

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".

Status da atualização

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

Enums
UPDATE_STATUS_UNKNOWN Não se sabe se há uma atualização pendente do sistema. Isso acontece quando, por exemplo, o nível da API do dispositivo é inferior a 26 ou se a versão do Android Device Policy está desatualizada.
UP_TO_DATE Não há atualizações do sistema pendentes disponíveis no dispositivo.
UNKNOWN_UPDATE_AVAILABLE Há uma atualização pendente do sistema disponível, mas o tipo dela é desconhecido.
SECURITY_UPDATE_AVAILABLE Há uma atualização de segurança pendente disponível.
OS_UPDATE_AVAILABLE Há uma atualização de SO pendente disponível.

Informações de hardware

Informações sobre o hardware do dispositivo. Os campos relacionados aos limites de temperatura só estarão disponíveis se hardwareStatusEnabled for verdadeiro na política do dispositivo.

Representação 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
}
Campos
brand

string

Marca do dispositivo. Por exemplo, Google.
hardware

string

Nome do hardware. Por exemplo, Angler.
deviceBasebandVersion

string

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

string

Fabricante. Por exemplo, Motorola.
serialNumber

string

O número de série do dispositivo.
model

string

O modelo do dispositivo. Por exemplo, Asus Nexus 7.
batteryShutdownTemperatures[]

number

Limites de temperatura de desligamento da bateria em Celsius para cada bateria do dispositivo.
batteryThrottlingTemperatures[]

number

Limite de temperatura em Celsius para cada bateria do dispositivo.
cpuShutdownTemperatures[]

number

Limites de temperatura de desligamento da CPU em Celsius para cada CPU no dispositivo.
cpuThrottlingTemperatures[]

number

Limite de temperatura em CPU em Celsius para cada CPU no dispositivo.
gpuShutdownTemperatures[]

number

Limites de temperatura de desligamento da GPU em Celsius para cada GPU no dispositivo.
gpuThrottlingTemperatures[]

number

Limitação de temperatura em GPU em Celsius para cada GPU no dispositivo.
skinShutdownTemperatures[]

number

Limites de temperatura de encerramento da pele do dispositivo em Celsius.
skinThrottlingTemperatures[]

number

Limites de temperatura na tela do dispositivo em Celsius.
enterpriseSpecificId

string

Apenas saída. ID que identifica exclusivamente um dispositivo pessoal em uma organização específica. No mesmo dispositivo físico, ele é registrado na mesma organização e é mantido nas configurações e até mesmo nas 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 mais recente.

Tela

Informações de exibição do dispositivo.

Representação JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Campos
name

string

Nome da tela.
displayId

integer

ID da tela exclusivo.
refreshRate

integer

É a taxa de atualização da tela em quadros por segundo.
state

enum (DisplayState)

Estado da tela.
width

integer

Largura da exibição em pixels.
height

integer

Altura da tela em pixels.
density

integer

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

Estado de exibição

O estado de uma tela.

Enums
DISPLAY_STATE_UNSPECIFIED Este valor não é permitido.
OFF O visor está desativado.
ON O visor está ligado.
DOZE O visor está no modo de baixa energia
SUSPENDED A tela está Soneca em um estado suspenso de baixo consumo de energia.

Relatório do aplicativo

Informações relatadas sobre um app instalado.

Representação 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)
    }
  ]
}
Campos
packageName

string

Nome do pacote do app.
versionName

string

A versão do app exibida ao usuário.
versionCode

integer

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

object (ApplicationEvent)

A lista de eventos de apps que ocorreram nas últimas 30 horas.
displayName

string

O nome de exibição do app.
packageSha256Hash

string

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.
signingKeyCertFingerprints[]

string

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

string

O nome do pacote do app que o instalou.
applicationSource

enum (ApplicationSource)

A origem do pacote.
state

enum (ApplicationState)

Estado do aplicativo.
keyedAppStates[]

object (KeyedAppState)

Lista de estados de app com chave informados pelo app.

Evento de aplicativo

Um evento relacionado ao app.

Representação JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Campos
eventType

enum (ApplicationEventType)

Tipo de evento do aplicativo.
createTime

string (Timestamp format)

É o horário de criação do evento.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".

Tipo de evento de aplicativo

É um tipo de evento relacionado ao app.

Enums
APPLICATION_EVENT_TYPE_UNSPECIFIED Este valor não é permitido.
INSTALLED O app foi instalado.
CHANGED O app foi alterado, por exemplo, um componente foi ativado ou desativado.
DATA_CLEARED Os dados do app foram apagados.
REMOVED O app foi removido.
REPLACED Uma nova versão do app foi instalada, substituindo a versão antiga.
RESTARTED O app foi reiniciado.
PINNED O app foi fixado ao primeiro plano.
UNPINNED O app foi liberado.

Origem do aplicativo

É a fonte que forneceu um app.

Enums
APPLICATION_SOURCE_UNSPECIFIED O app foi transferido por sideload de uma origem não especificada.
SYSTEM_APP_FACTORY_VERSION Esse é um app do sistema com a imagem de fábrica do dispositivo.
SYSTEM_APP_UPDATED_VERSION Este é um app do sistema atualizado.
INSTALLED_FROM_PLAY_STORE O app foi instalado pela Google Play Store.

Estado do aplicativo

O status da instalação atual.

Enums
APPLICATION_STATE_UNSPECIFIED O estado do app não foi especificado
REMOVED O app foi removido do dispositivo
INSTALLED O app está instalado no dispositivo

EstadoDoAppChave

Estado do app codificado informado pelo app.

Representação JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Campos
key

string

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

enum (Severity)

A gravidade do estado do app.
message

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

string

Opcionalmente, um valor legível por máquina para ser lido pelo EMM. Por exemplo, configurar valores que o administrador pode escolher para consultar no console de EMM (por exemplo, "notifique-me se os dados da bateria_warning abaixo de 10").
createTime

string (Timestamp format)

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

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
lastUpdateTime

string (Timestamp format)

A hora em que o estado do app foi atualizado pela última vez.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".

Gravidade

A gravidade do estado do app.

Enums
SEVERITY_UNSPECIFIED Nível de gravidade não especificado.
INFO Nível de gravidade das informações.
ERROR Nível de gravidade do erro. Isso deve ser definido apenas para condições de erro genuínas que uma organização de gerenciamento precisa realizar para corrigir isso.

NetworkInfo

Informações da rede do dispositivo.

Representação JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Campos
imei

string

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

string

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

string

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

string

Nome alfabético do operador registrado atualmente. Por exemplo, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Mostra as 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.

Informações de telefonia

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

Representação JSON 
{
  "phoneNumber": string,
  "carrierName": string
}
Campos
phoneNumber

string

O número de telefone associado a este chip.
carrierName

string

Nome da operadora associado ao chip.

Informações da memória

Informações sobre memória e armazenamento do dispositivo.

Representação JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Campos
totalRam

string (int64 format)

RAM total no dispositivo em bytes.
totalInternalStorage

string (int64 format)

Armazenamento interno total no dispositivo em bytes.

MemoryEvent

Um evento relacionado às medições de memória e armazenamento.

Representação JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Campos
eventType

enum (MemoryEventType)

Tipo de evento.
createTime

string (Timestamp format)

É o horário de criação do evento.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
byteCount

string (int64 format)

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

MemoryEventType

O tipo de evento.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED Não especificado. Nenhum evento tem este tipo.
RAM_MEASURED O espaço livre na RAM foi medido.
INTERNAL_STORAGE_MEASURED O espaço livre no armazenamento interno foi medido.
EXTERNAL_STORAGE_DETECTED Uma nova mídia de armazenamento externo foi detectada. A contagem de bytes informada é a capacidade total da mídia de armazenamento.
EXTERNAL_STORAGE_REMOVED Uma mídia de armazenamento externo foi removida. A contagem de bytes informada é zero.
EXTERNAL_STORAGE_MEASURED O espaço livre em uma mídia de armazenamento externo foi medido.

Evento PowerManagement

Um evento de gerenciamento de energia.

Representação JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Campos
eventType

enum (PowerManagementEventType)

Tipo de evento.
createTime

string (Timestamp format)

É o horário de criação do evento.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
batteryLevel

number

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

Tipode evento de gerenciamento de energia

O tipo de evento.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Não especificado. Nenhum evento tem este tipo.
BATTERY_LEVEL_COLLECTED O nível da bateria foi medido.
POWER_CONNECTED O dispositivo começou a carregar.
POWER_DISCONNECTED O dispositivo parou de carregar.
BATTERY_LOW O dispositivo entrou no modo de baixo consumo de energia.
BATTERY_OKAY O dispositivo saiu do modo de baixo consumo de energia.
BOOT_COMPLETED O dispositivo foi inicializado.
SHUTDOWN O dispositivo foi desligado.

Status do hardware

Status do hardware. As temperaturas podem ser comparadas aos limites de temperatura disponíveis no hardwareInfo para determinar a integridade do hardware.

Representação JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Campos
createTime

string (Timestamp format)

A hora em que as medidas foram feitas.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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".
batteryTemperatures[]

number

Temperaturas atuais da bateria em Celsius para cada bateria do dispositivo.
cpuTemperatures[]

number

Temperaturas atuais da CPU em Celsius para cada CPU no dispositivo.
gpuTemperatures[]

number

Temperaturas atuais da GPU em Celsius para cada GPU no dispositivo.
skinTemperatures[]

number

Temperaturas da pele do dispositivo atual em Celsius.
fanSpeeds[]

number

A velocidade do ventilador em RPM para cada ventilador do dispositivo. Uma matriz vazia significa que não há ventiladores ou que a velocidade do ventilador não é compatível com o sistema.
cpuUsages[]

number

Usos de CPU em porcentagem para cada núcleo disponível no dispositivo. O uso é 0 para cada núcleo desconectado. Uma matriz vazia implica que o uso de CPU não é compatível com o sistema.

Configurações do dispositivo

São informações sobre as configurações do dispositivo relacionadas à segurança.

Representação JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Campos
isDeviceSecure

boolean

Se o dispositivo está protegido por PIN/senha.
unknownSourcesEnabled

boolean

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

boolean

Indica se o modo de desenvolvedor está ativado no dispositivo.
adbEnabled

boolean

Indica se o adb está ativado no dispositivo.
isEncrypted

boolean

Se a criptografia do armazenamento está ativada.
encryptionStatus

enum (EncryptionStatus)

Status da criptografia do DevicePolicyManager.
verifyAppsEnabled

boolean

Indica se a verificação do Google Play Protect é aplicada no dispositivo.

Status da criptografia

Status de criptografia de um dispositivo.

Enums
ENCRYPTION_STATUS_UNSPECIFIED Não especificado. Nenhum dispositivo deve ter esse tipo.
UNSUPPORTED O dispositivo não oferece suporte à criptografia.
INACTIVE A criptografia é compatível com o dispositivo, mas não está ativa no momento.
ACTIVATING A criptografia não está ativa, mas está sendo ativada no momento.
ACTIVE A criptografia está ativa.
ACTIVE_DEFAULT_KEY A criptografia está ativa, mas o usuário não configurou uma chave de criptografia.
ACTIVE_PER_USER A criptografia está ativa, e a chave de criptografia está vinculada ao perfil do usuário.

Postura de segurança

A postura de segurança do dispositivo, conforme determinado pelo estado atual do dispositivo e pelas políticas aplicadas.

Representação JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Campos
devicePosture

enum (DevicePosture)

Valor de postura de segurança do dispositivo.
postureDetails[]

object (PostureDetail)

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

Postura do dispositivo

Valores de postura de segurança possíveis de um dispositivo sob gerenciamento.

Enums
POSTURE_UNSPECIFIED Não especificado. Não há detalhes de posição para esse valor.
SECURE Este dispositivo é seguro.
AT_RISK Este dispositivo pode estar mais vulnerável a agentes mal-intencionados do que o recomendado para uso com dados corporativos.
POTENTIALLY_COMPROMISED Este dispositivo pode estar comprometido, e os dados corporativos podem ser acessados por agentes não autorizados.

Detalhe da postura

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

Representação JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Campos
securityRisk

enum (SecurityRisk)

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

object (UserFacingMessage)

Orientações aos administradores para mitigar esse risco de segurança e melhorar a postura de segurança do dispositivo.

Risco de segurança

O risco que torna o dispositivo não no estado mais seguro.

Enums
SECURITY_RISK_UNSPECIFIED Não especificado.
UNKNOWN_OS O SafetyNet detecta que o dispositivo está executando um SO desconhecido (a verificação de BasicIntegrity é concluída, mas o ctsProfileMatch falha).
COMPROMISED_OS O SafetyNet detecta que o dispositivo está executando um SO comprometido (a verificação de BasicIntegrity falha).
HARDWARE_BACKED_EVALUATION_FAILED O SafetyNet detecta que o dispositivo não tem uma garantia forte de integridade do sistema, como um armazenamento de chaves protegido por hardware.

Responsabilidade

Propriedade do dispositivo gerenciado.

Enums
OWNERSHIP_UNSPECIFIED A propriedade não está especificada.
COMPANY_OWNED O dispositivo é da empresa.
PERSONALLY_OWNED O dispositivo é de propriedade pessoal.

CommonModeModeInfo

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

Essas informações só ficam disponíveis quando o statusReportingSettings.commonCriteriaModeEnabled é true na política do dispositivo.

Representação JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
Campos
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Indica se o modo Common Criteria está ativado.

CommonCritériosModeStatus

Indica se o modo Common Criteria está ativado.

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Status desconhecido.
COMMON_CRITERIA_MODE_DISABLED O modo de critérios comuns está desativado no momento.
COMMON_CRITERIA_MODE_ENABLED O modo de critérios comuns está ativado.

Métodos

delete

 Exclui um dispositivo.

get

 Recebe um dispositivo.

issueCommand

 Emite um comando para um dispositivo.

list

 Lista os dispositivos de uma determinada empresa.

patch

 Atualiza um dispositivo.