REST Resource: enterprises.devices

Recurso: dispositivo

Um dispositivo que pertence a uma empresa. A menos que indicado o contrário, 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)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Campos
name

string

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

string

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

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

enum (DeviceState)

O estado a ser aplicado ao dispositivo. Esse campo pode ser modificado por uma solicitação de correção. Ao chamar enterprises.devices.patch, ACTIVE e DISABLED são os únicos valores permitidos. Para colocar o dispositivo em um estado DELETED, chame enterprises.devices.delete.
appliedState

enum (DeviceState)

O estado aplicado ao dispositivo.
policyCompliant

boolean

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

object (NonComplianceDetail)

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

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".
lastStatusReportTime

string (Timestamp format)

A última vez em 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".
lastPolicyComplianceReportTime
(deprecated)

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".
lastPolicySyncTime

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".
policyName

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. Esse campo pode ser modificado por uma solicitação de correção. É 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 aplicada ao dispositivo.
appliedPolicyVersion

string (int64 format)

A versão da política aplicada ao dispositivo atualmente.
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 com dados adicionais, esse campo vai conter esses dados.
enrollmentTokenName

string

Se o dispositivo foi registrado com um token de registro, esse campo contém o nome do token.
disabledReason

object (UserFacingMessage)

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

object (SoftwareInfo)

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

object (HardwareInfo)

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

object (Display)

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

object (ApplicationReport)

Relatórios de apps instalados no dispositivo. Essas informações só estão disponíveis quando applicationReportsEnabled é verdadeiro na política do dispositivo.
previousDeviceNames[]

string

Se o mesmo dispositivo físico foi registrado várias vezes, este campo contém os nomes anteriores do dispositivo. 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 de rede do dispositivo. Essas informações só estão disponíveis se networkInfoEnabled for verdadeiro na política do dispositivo.
memoryInfo

object (MemoryInfo)

Informações de 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ó estão disponíveis se memoryInfoEnabled for verdadeiro na política do dispositivo.

Os eventos são mantidos por um determinado período, e os antigos são excluídos.
powerManagementEvents[]

object (PowerManagementEvent)

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

object (HardwareStatus)

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

object (DeviceSettings)

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

object (User)

O usuário que é proprietário do dispositivo.
systemProperties

map (key: string, value: string)

Mapa do nome e valor das propriedades do sistema selecionadas relacionadas ao dispositivo. Essas informações só estã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" }.
securityPosture

object (SecurityPosture)

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

enum (Ownership)

Propriedade do dispositivo gerenciado.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informações sobre o modo Common Criteria: padrões de segurança definidos nos Common Criteria para avaliação de segurança da tecnologia da informação (CC).

Essas informações só estão disponíveis se statusReportingSettings.commonCriteriaModeEnabled for true na política do dispositivo e se o dispositivo for de propriedade da empresa.
appliedPasswordPolicies[]

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

object (DpcMigrationInfo)

Apenas saída. Informações relacionadas à migração do gerenciamento do dispositivo de outro controlador de política de dispositivo (DPC).

DeviceState

Estados que podem ser aplicados a um dispositivo.

Enums
DEVICE_STATE_UNSPECIFIED Esse 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 vai continuar desconhecido para o servidor.
PROVISIONING O dispositivo está sendo provisionado. Os dispositivos recém-registrados ficam nesse estado até uma política ser aplicada.
LOST O dispositivo foi perdido. Esse estado só é possível em dispositivos de propriedade da organização.
PREPARING_FOR_MIGRATION O dispositivo está se preparando para migrar para a API Android Management. Nenhuma outra ação é necessária para que a migração continue.
DEACTIVATED_BY_DEVICE_FINANCE Este é um dispositivo financiado que foi "bloqueado" pelo agente de financiamento. Isso significa que algumas configurações de política foram aplicadas para limitar a funcionalidade do dispositivo até que ele seja "desbloqueado" pelo agente de financiamento. O dispositivo continuará a aplicar as configurações de políticas, exceto aquelas substituídas pelo agente de financiamento. Quando o dispositivo está "bloqueado", o estado é informado em appliedState como DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Fornece detalhes sobre o não cumprimento de 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. É 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 conformidade com a configuração.
packageName

string

O nome do pacote que indica qual app está fora de conformidade, se aplicável.
fieldPath

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 maneira que o campo JSON da política seria referenciado no JavaScript, ou seja: 1) Para campos do tipo 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 da não conformidade for APP_NOT_INSTALLED ou APP_NOT_UPDATED, o motivo detalhado de não instalação ou atualização do app.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Contexto adicional para specificNonComplianceReason.

InstallationFailureReason

Motivos para uma instalação de app falhar.

Enums
INSTALLATION_FAILURE_REASON_UNSPECIFIED Este valor não é permitido.
INSTALLATION_FAILURE_REASON_UNKNOWN Uma condição desconhecida está impedindo a instalação do app. Alguns possíveis motivos são: o dispositivo não tem armazenamento suficiente, a conexão de rede não é confiável ou a instalação está demorando mais do que o esperado. A instalação será tentada novamente automaticamente.
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 não é compatí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 Termos de Serviço mais recentes do Google Play gerenciado.
USER_INVALID O usuário não é mais válido. O usuário pode ter sido excluído ou desativado.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Um erro de rede no dispositivo do usuário impediu a instalação. Isso geralmente acontece quando a conectividade de Internet do dispositivo está degradada, indisponível ou há um problema de configuração de rede. Confira se o dispositivo tem acesso à conectividade total da Internet em uma rede que atenda aos requisitos de Android Enterprise Network Requirements. A instalação ou atualização do app será retomada automaticamente quando isso acontecer.
INSUFFICIENT_STORAGE O dispositivo do usuário não tem espaço de armazenamento suficiente para instalar o app. Para resolver esse problema, libere espaço de armazenamento no dispositivo. A instalação ou atualização do app será retomada automaticamente quando o dispositivo tiver armazenamento suficiente.

SpecificNonComplianceReason

Mais detalhes sobre por que um dispositivo pode não estar 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 O motivo específico de não conformidade não foi especificado. Os campos em specificNonComplianceContext não estão definidos.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED O usuário precisa digitar o bloqueio de tela para confirmar as credenciais. Os campos em specificNonComplianceContext não estão definidos. nonComplianceReason está definida como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED A senha do dispositivo ou do perfil expirou. passwordPoliciesContext está definido. nonComplianceReason está definida como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT A senha do dispositivo não atende aos requisitos de senha. passwordPoliciesContext está definido. nonComplianceReason é definido como USER_ACTION.
ONC_WIFI_INVALID_VALUE Há um valor incorreto na configuração do Wi-Fi do ONC. fieldPath especifica qual valor de campo está incorreto. oncWifiContext está definido. nonComplianceReason está definida como INVALID_VALUE.
ONC_WIFI_API_LEVEL A configuração de Wi-Fi do ONC não tem suporte no 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 está definido. nonComplianceReason está definida como API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG A rede Wi-Fi corporativa não tem a AC raiz ou o nome de domínio. nonComplianceReason é definido como INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK O usuário precisa remover a rede Wi-Fi configurada manualmente. Isso se aplica apenas a perfis de trabalho em dispositivos pessoais. nonComplianceReason é definido como USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY O alias do par de chaves especificado pelo campo ClientCertKeyPairAlias em openNetworkConfiguration não corresponde a uma chave instalada no dispositivo. nonComplianceReason está definida como INVALID_VALUE.

SpecificNonComplianceContext

Contexto adicional para SpecificNonComplianceReason.

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

object (OncWifiContext)

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

object (PasswordPoliciesContext)

Contexto adicional sobre a não conformidade com as políticas de senha. Consulte PASSWORD_POLICIES_PASSWORD_EXPIRED e PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contexto adicional para não conformidade relacionada à configuração do Wi-Fi.

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

string

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

PasswordPoliciesContext

Contexto adicional sobre a não conformidade com as políticas de senha.

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

enum (PasswordPolicyScope)

O escopo da senha não compatível.

SoftwareInfo

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 para o 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 de ID de build do Android destinada a ser exibida para o 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 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".
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 pendente do sistema.

SystemUpdateInfo

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

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

string (Timestamp format)

A hora em que a atualização ficou disponível pela primeira vez. Um 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".

UpdateStatus

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

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

HardwareInfo

Informações sobre o hardware do dispositivo. Os campos relacionados aos limites de temperatura só estã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 no dispositivo.
batteryThrottlingTemperatures[]

number

Limites de temperatura de limitação da bateria em graus Celsius para cada bateria no dispositivo.
cpuShutdownTemperatures[]

number

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

number

Limites de temperatura de limitação de CPU em graus Celsius para cada CPU no dispositivo.
gpuShutdownTemperatures[]

number

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

number

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

number

Limites de temperatura de desligamento da skin do dispositivo em Celsius.
skinThrottlingTemperatures[]

number

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

string

Apenas saída. ID que identifica de forma exclusiva um dispositivo pessoal em uma organização específica. No mesmo dispositivo físico, quando registrado na mesma organização, esse ID persiste em todas as configurações e até mesmo em redefinições para a configuração original. Esse ID está disponível em dispositivos pessoais com um perfil de trabalho e o Android 12 ou mais recente.

Display

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 de exibição exclusivo.
refreshRate

integer

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

enum (DisplayState)

Estado da tela.
width

integer

Largura da tela em pixels.
height

integer

Altura da tela em pixels.
density

integer

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

DisplayState

O estado de uma tela.

Enums
DISPLAY_STATE_UNSPECIFIED Esse valor não é permitido.
OFF A tela está desligada.
ON A tela está ligada.
DOZE A tela está em modo de suspensão em um estado de baixo consumo de energia
SUSPENDED A tela está em suspensão no estado de baixo consumo.

ApplicationReport

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)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
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)

Lista de eventos do app que ocorreram nas últimas 30 horas.
displayName

string

O nome de exibição do app.
packageSha256Hash

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 do hash é representado como um número hexadecimal de dois dígitos.
signingKeyCertFingerprints[]

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

string

O nome do pacote do app que instalou este app.
applicationSource

enum (ApplicationSource)

A origem do pacote.
state

enum (ApplicationState)

Estado do aplicativo.
keyedAppStates[]

object (KeyedAppState)

Lista de estados de chaves de apps informados pelo app.
userFacingType

enum (UserFacingType)

Se o app é voltado ao usuário.

ApplicationEvent

Um evento relacionado a um app.

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

enum (ApplicationEventType)

Tipo de evento do app.
createTime

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

ApplicationEventType

Um tipo de evento relacionado ao app.

Enums
APPLICATION_EVENT_TYPE_UNSPECIFIED Esse valor não é permitido.
INSTALLED O app foi instalado.
CHANGED O app mudou, 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 para substituir a antiga.
RESTARTED O app foi reiniciado.
PINNED O app foi fixado em primeiro plano.
UNPINNED O app foi desfixado.

ApplicationSource

A origem que forneceu um app.

Enums
APPLICATION_SOURCE_UNSPECIFIED O app foi transferido de uma fonte não especificada.
SYSTEM_APP_FACTORY_VERSION Esse é um app do sistema da imagem de fábrica do dispositivo.
SYSTEM_APP_UPDATED_VERSION Este é um app do sistema atualizado.
INSTALLED_FROM_PLAY_STORE O app foi instalado na Google Play Store.

ApplicationState

O status atual da instalação.

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

KeyedAppState

Estado do app com chave informado pelo app.

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

string

A chave do estado do app. Age como um ponto de referência para o estado fornecido pelo app. Por exemplo, ao fornecer feedback sobre a 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 aplicativo. 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 a ser lido pelo EMM. Por exemplo, definir valores que o administrador pode consultar no console do EMM (por exemplo, "notifique-me se os dados de battery_warning forem < 10").
createTime

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".
lastUpdateTime

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

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 só deve ser definido para condições de erro genuínas que uma organização de gerenciamento precisa corrigir.

UserFacingType

Se o app é voltado ao usuário.

Enums
USER_FACING_TYPE_UNSPECIFIED O tipo voltado ao usuário do app não foi especificado.
NOT_USER_FACING O app não é voltado ao usuário.
USER_FACING O app é voltado ao usuário.

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 do Wi-Fi do dispositivo. Por exemplo, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

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

object (TelephonyInfo)

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

TelephonyInfo

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

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

string

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

string

O nome da operadora associada a este chip.
iccId

string

Apenas saída. O ICCID associado a esse chip.

MemoryInfo

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

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

string (int64 format)

Total de RAM 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.

Para diferenciar eventos novos e antigos, recomendamos usar o campo createTime.

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

enum (MemoryEventType)

Tipo de evento.
createTime

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".
byteCount

string (int64 format)

O número de bytes livres no meio ou, para EXTERNAL_STORAGE_DETECTED, a capacidade total em bytes do meio de armazenamento.

MemoryEventType

O tipo de evento.

Enums
MEMORY_EVENT_TYPE_UNSPECIFIED Não especificado. Nenhum evento tem esse 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 Um novo meio de armazenamento externo foi detectado. A contagem de bytes informada é a capacidade total da mídia de armazenamento.
EXTERNAL_STORAGE_REMOVED Um meio de armazenamento externo foi removido. A contagem de bytes informada é zero.
EXTERNAL_STORAGE_MEASURED O espaço livre em um meio de armazenamento externo foi medido.

PowerManagementEvent

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)

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".
batteryLevel

number

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

PowerManagementEventType

O tipo de evento.

Enums
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Não especificado. Nenhum evento tem esse 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 baixa energia.
BATTERY_OKAY O dispositivo saiu do modo de baixa energia.
BOOT_COMPLETED O dispositivo foi inicializado.
SHUTDOWN O dispositivo foi desligado.

HardwareStatus

Status do hardware. As temperaturas podem ser comparadas aos limites de temperatura disponíveis em 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)

O horário 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".
batteryTemperatures[]

number

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

number

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

number

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

number

Temperaturas atuais da pele do dispositivo em graus Celsius.
fanSpeeds[]

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

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 implica que o uso da CPU não tem suporte no sistema.

DeviceSettings

Informações sobre as configurações de segurança relacionadas ao dispositivo.

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

Se o ADB está ativado no dispositivo.
isEncrypted

boolean

Indica se a criptografia de armazenamento está ativada.
encryptionStatus

enum (EncryptionStatus)

Status de criptografia do DevicePolicyManager.
verifyAppsEnabled

boolean

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

EncryptionStatus

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 O dispositivo oferece suporte à criptografia, mas ela não está ativa no momento.
ACTIVATING A criptografia não está ativa, mas está sendo ativada.
ACTIVE A criptografia está ativa.
ACTIVE_DEFAULT_KEY A criptografia está ativa, mas uma chave de criptografia não foi definida pelo usuário.
ACTIVE_PER_USER A criptografia está ativa e a chave de criptografia está vinculada ao perfil do usuário.

SecurityPosture

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

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

enum (DevicePosture)

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

object (PostureDetail)

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

DevicePosture

Possíveis valores de postura de segurança de um dispositivo em gerenciamento.

Enums
POSTURE_UNSPECIFIED Não especificado. Não há detalhes de postura para esse valor.
SECURE Este dispositivo está protegido.
AT_RISK Este dispositivo pode estar mais vulnerável a agentes maliciosos do que o recomendado para uso com dados corporativos.
POTENTIALLY_COMPROMISED Esse dispositivo pode estar comprometido, e os dados corporativos podem ser acessados por pessoas não autorizadas.

PostureDetail

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)

Conselhos correspondentes para administradores para reduzir esse risco de segurança e melhorar a postura de segurança do dispositivo.

SecurityRisk

O risco que faz com que o dispositivo não esteja no estado mais seguro.

Enums
SECURITY_RISK_UNSPECIFIED Não especificado.
UNKNOWN_OS A API Play Integrity detecta que o dispositivo está executando um SO desconhecido (a verificação basicIntegrity é bem-sucedida, mas a ctsProfileMatch falha).
COMPROMISED_OS A API Play Integrity detecta que o dispositivo está executando um SO comprometido (falha na verificação da BasicIntegrity).
HARDWARE_BACKED_EVALUATION_FAILED A API Play Integrity detecta que o dispositivo não tem uma garantia forte de integridade do sistema se o identificador MEETS_STRONG_INTEGRITY não aparecer no campo de integridade do dispositivo.

CommonCriteriaModeInfo

Informações sobre o modo Common Criteria: padrões de segurança definidos nos Common Criteria para avaliação de segurança da tecnologia da informação (CC).

Essa informação só vai estar disponível se statusReportingSettings.commonCriteriaModeEnabled for true na política do dispositivo.

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

enum (CommonCriteriaModeStatus)

Indica se o modo Common Criteria está ativado.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Apenas saída. O status da verificação de assinatura da política.

CommonCriteriaModeStatus

Indica se o modo Common Criteria está ativado.

Enums
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Status desconhecido.
COMMON_CRITERIA_MODE_DISABLED O modo Common Criteria está desativado no momento.
COMMON_CRITERIA_MODE_ENABLED O modo Common Criteria está ativado.

PolicySignatureVerificationStatus

O status da verificação da assinatura da política.

Enums
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED Não especificado. O status de verificação não foi informado. Isso é definido apenas se statusReportingSettings.commonCriteriaModeEnabled for falso.
POLICY_SIGNATURE_VERIFICATION_DISABLED A verificação de assinatura de política está desativada no dispositivo porque commonCriteriaMode está definido como falso.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED A verificação de assinatura da política foi concluída.
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED A verificação de assinatura de política não é compatível, por exemplo, porque o dispositivo foi registrado com uma versão do CloudDPC que não oferece suporte a essa verificação.
POLICY_SIGNATURE_VERIFICATION_FAILED A verificação da assinatura da política falhou. A política não foi aplicada.

DpcMigrationInfo

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

Representação JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Campos
previousDpc

string

Apenas saída. Se o dispositivo foi migrado de outro DPC, esse é o nome do pacote. Não é preenchido de outra forma.
additionalData

string

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

Métodos

delete

 Exclui um dispositivo.

get

 Recebe um dispositivo.

issueCommand

 Envia um comando para um dispositivo.

list

 Lista os dispositivos de uma determinada empresa.

patch

 Atualiza um dispositivo.