- Recurso: dispositivo
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Tela
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravidade
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- Métodos
Recurso: Device
Um dispositivo que pertence a 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 ( |
Campos | |
---|---|
name |
O nome do dispositivo no formato |
userName |
O nome do recurso do usuário proprietário desse dispositivo no formato |
managementMode |
O tipo de modo de gerenciamento que o Android Device Policy assume no dispositivo. Isso influencia as configurações de política compatíveis. |
state |
O estado a ser aplicado ao dispositivo. Este campo pode ser modificado por uma solicitação de patch. Ao chamar |
appliedState |
O estado aplicado ao dispositivo no momento. |
policyCompliant |
Se o dispositivo está em compliance com a política. |
nonComplianceDetails[] |
Detalhes sobre as configurações de política com as quais o dispositivo não está em compliance. |
enrollmentTime |
O horário do 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: |
lastStatusReportTime |
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: |
lastPolicyComplianceReportTime |
Obsoleto. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
lastPolicySyncTime |
A última vez que o dispositivo buscou a política dele. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
policyName |
O nome da política aplicada ao dispositivo, no formato |
appliedPolicyName |
O nome da política atualmente aplicada ao dispositivo. |
appliedPolicyVersion |
A versão da política atualmente aplicada ao dispositivo. |
apiLevel |
O nível da API da versão da plataforma Android em execução no dispositivo. |
enrollmentTokenData |
Se o dispositivo tiver sido registrado com um token de registro com dados adicionais fornecidos, esse campo vai conter esses dados. |
enrollmentTokenName |
Se o dispositivo tiver sido registrado com um token, este campo vai conter o nome do token. |
disabledReason |
Se o estado do dispositivo for |
softwareInfo |
Informações detalhadas sobre o software do dispositivo. Essas informações só estarão disponíveis se |
hardwareInfo |
Informações detalhadas sobre o hardware do dispositivo |
displays[] |
Informações detalhadas sobre telas no dispositivo. Essas informações só estarão disponíveis se |
applicationReports[] |
Relatórios dos apps instalados no dispositivo. Essas informações só estão disponíveis quando |
previousDeviceNames[] |
Se o mesmo dispositivo físico tiver sido registrado várias vezes, o campo vai mostrar os nomes anteriores dos dispositivos. O número de série é usado como identificador exclusivo para determinar se o mesmo dispositivo físico foi registrado anteriormente. Os nomes estão em ordem cronológica. |
networkInfo |
Informações da rede do dispositivo Essas informações só estarão disponíveis se |
memoryInfo |
Informações sobre a memória: contém informações sobre a memória e o armazenamento do dispositivo. |
memoryEvents[] |
Eventos relacionados a medidas de memória e armazenamento em ordem cronológica. Essas informações só estarão disponíveis se Os eventos são retidos por um determinado período e os antigos são excluídos. |
powerManagementEvents[] |
Eventos de gerenciamento de energia no dispositivo em ordem cronológica. Essas informações só estarão disponíveis se |
hardwareStatusSamples[] |
Exemplos de status de hardware em ordem cronológica. Essas informações só estarão disponíveis se |
deviceSettings |
Informações de configurações do dispositivo. Essas informações só estarão disponíveis se |
user |
O usuário que é o proprietário do dispositivo. |
systemProperties |
Mapa do nome e valor das propriedades do sistema selecionadas relacionados ao dispositivo. Essas informações só estarão disponíveis se Um objeto com uma lista de pares |
securityPosture |
Valor da postura de segurança que reflete o nível de segurança do dispositivo. |
ownership |
Propriedade do dispositivo gerenciado. |
commonCriteriaModeInfo |
Informações sobre o modo Common Criteria: padrões de segurança definidos na Avaliação de segurança da tecnologia da informação (CC, na sigla em inglês). Essa informação só estará disponível se |
appliedPasswordPolicies[] |
Os requisitos de senha atualmente aplicados ao dispositivo.
|
dpcMigrationInfo |
Apenas saída. Informações relacionadas à migração do dispositivo, que deixou de ser gerenciado por 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 confirma a exclusão. Se o dispositivo for excluído pela chamada de API, esse estado é 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 recém-registrados permanecem nesse estado até que uma política seja aplicada. |
LOST |
o dispositivo for perdido; Esse estado só é possível em dispositivos 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. |
NonComplianceDetail
Apresenta detalhes sobre a não conformidade com uma configuração de política.
Representação JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campos | |
---|---|
settingName |
O nome da configuração da política. Este é o nome do campo JSON de um campo |
nonComplianceReason |
O motivo pelo qual o dispositivo não está em compliance com a configuração. |
packageName |
O nome do pacote indicando qual app não está em compliance, se aplicável. |
fieldPath |
Em configurações com campos aninhados, se um campo aninhado específico não estiver em compliance, isso vai especificar o caminho completo para o campo que não está em conformidade. O caminho é formatado da mesma forma que o campo JSON da política seria referenciado em JavaScript, ou seja: 1) Para campos tipados de objeto, o nome do campo é seguido por um ponto e, em seguida, 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 |
currentValue |
Se a configuração da política não puder ser aplicada, o valor atual da configuração no dispositivo. |
installationFailureReason |
Se |
specificNonComplianceReason |
O motivo específico da política para o dispositivo não estar em compliance com a configuração. |
specificNonComplianceContext |
Contexto adicional para |
InstallationFailureReason
Motivos pelos quais uma instalação de app pode falhar.
Enums | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Esse 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 que 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. Uma nova tentativa de instalação será feita 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 registrada 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 conclusão da instalação. Isso geralmente acontece quando a conectividade de Internet do dispositivo está degradada, indisponível ou há um problema de configuração da rede. Verifique se o dispositivo tem acesso à conectividade total com a Internet em uma rede que atenda a |
INSUFFICIENT_STORAGE |
O dispositivo do usuário não tem espaço de armazenamento suficiente para instalar o app. Para resolver isso, libere espaço de armazenamento no dispositivo. A instalação ou atualização do app será retomada automaticamente assim que o dispositivo tiver espaço de armazenamento suficiente. |
SpecificNonComplianceReason
Confira mais detalhes sobre o motivo de um dispositivo não estar em conformidade com uma configuração de política. Novos valores podem ser adicionados ao enum no futuro.
Enums | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
O motivo específico da não conformidade não foi especificado. Os campos em não estão definidos. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
O usuário precisa confirmar as credenciais inserindo o bloqueio de tela. Os campos em não estão definidos. está definido como . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
A senha do dispositivo ou do perfil expirou. está definido. está definido como . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
A senha do dispositivo não atende aos requisitos de senha. está definido. está definido como . |
ONC_WIFI_INVALID_VALUE |
Há um valor incorreto na configuração do Wi-Fi do ONC. especifica o valor do campo incorreto. está definido. está definido como . |
ONC_WIFI_API_LEVEL |
A configuração de Wi-Fi do ONC não é compatível com o nível da API da versão do Android em execução no dispositivo. especifica qual valor de campo não é compatível. está definido. está definido como . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
A rede Wi-Fi da empresa não tem a CA raiz ou o nome do domínio. é definido como . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
O usuário precisa remover a rede Wi-Fi configurada manualmente. Isso é aplicável apenas a perfis de trabalho em dispositivos pessoais. é definido como . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
O alias do par de chaves especificado pelo campo ClientCertKeyPairAlias em não corresponde a uma chave instalada no dispositivo. está definido como . |
SpecificNonComplianceContext
Contexto adicional para
.SpecificNonComplianceReason
Representação JSON |
---|
{ "oncWifiContext": { object ( |
Campos | |
---|---|
oncWifiContext |
Contexto adicional para não compliance relacionada à configuração de Wi-Fi. Consulte |
passwordPoliciesContext |
Contexto adicional para não compliance relacionado às políticas de senha. Consulte |
OncWifiContext
Contexto adicional para não compliance relacionada à configuração de Wi-Fi.
Representação JSON |
---|
{ "wifiGuid": string } |
Campos | |
---|---|
wifiGuid |
O GUID da configuração de Wi-Fi não compatível. |
PasswordPoliciesContext
Contexto adicional para não compliance relacionado às políticas de senha.
Representação JSON |
---|
{
"passwordPolicyScope": enum ( |
Campos | |
---|---|
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 ( |
Campos | |
---|---|
androidVersion |
É a string da versão do Android visível para o usuário. Por exemplo, |
androidDevicePolicyVersionCode |
Código da versão do app Android Device Policy. |
androidDevicePolicyVersionName |
A versão do app Android Device Policy conforme exibida ao usuário. |
androidBuildNumber |
String do ID do build do Android que vai ser mostrada ao usuário. Por exemplo, |
deviceKernelVersion |
Versão do kernel, por exemplo, |
bootloaderVersion |
O número da versão do carregador de inicialização do sistema. Por exemplo, |
androidBuildTime |
Tempo de build. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
securityPatchLevel |
Nível do patch de segurança, por exemplo, |
primaryLanguageCode |
Um código de idioma IETF BCP 47 para a localidade principal do dispositivo. |
deviceBuildSignature |
Hash SHA-256 de |
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 ( |
Campos | |
---|---|
updateStatus |
Status de uma atualização: se ela existe e o tipo dela. |
updateReceivedTime |
A hora em que a atualização foi disponibilizada pela primeira vez. Um valor zero indica que esse campo não está definido. Este campo será definido apenas se uma atualização estiver disponível, ou seja, Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
UpdateStatus
Status de uma atualização: se ela existe e o tipo dela.
Enums | |
---|---|
UPDATE_STATUS_UNKNOWN |
Não se sabe 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ções de sistema pendentes disponíveis 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 pendente do SO disponível. |
HardwareInfo
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 |
Marca do dispositivo. Por exemplo, |
hardware |
Nome do hardware. Por exemplo, |
deviceBasebandVersion |
Versão da banda de base. Por exemplo, |
manufacturer |
Fabricante. Por exemplo, |
serialNumber |
O número de série do dispositivo. |
model |
O modelo do dispositivo. Por exemplo, |
batteryShutdownTemperatures[] |
Limites de temperatura de desligamento da bateria em Celsius para cada bateria do dispositivo. |
batteryThrottlingTemperatures[] |
Limites de temperatura de limitação de bateria em Celsius para cada bateria no dispositivo. |
cpuShutdownTemperatures[] |
Limites de temperatura de desligamento da CPU em Celsius para cada CPU no dispositivo. |
cpuThrottlingTemperatures[] |
Limites de temperatura de limitação de CPU em Celsius para cada CPU no dispositivo. |
gpuShutdownTemperatures[] |
Limites de temperatura de desligamento da GPU em Celsius para cada GPU no dispositivo. |
gpuThrottlingTemperatures[] |
Limites de temperatura de limitação de GPU em Celsius para cada GPU no dispositivo. |
skinShutdownTemperatures[] |
Limites de temperatura de desligamento da pele do dispositivo em graus Celsius. |
skinThrottlingTemperatures[] |
Limites de temperatura de limitação da pele do dispositivo em graus Celsius. |
enterpriseSpecificId |
Apenas saída. ID que identifica exclusivamente 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 nas redefinições para a configuração original. Esse ID está disponível para dispositivos pessoais com um perfil de trabalho em dispositivos com o Android 12 ou versões mais recentes. |
Tela
Informações de exibição do dispositivo.
Representação JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Campos | |
---|---|
name |
Nome da tela. |
displayId |
ID de exibição exclusivo. |
refreshRate |
Taxa de atualização da tela em quadros por segundo. |
state |
Estado da tela. |
width |
Exibir largura em pixels. |
height |
Exibir altura em pixels. |
density |
Densidade de exibição expressa como 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á travando em um estado de baixa energia |
SUSPENDED |
A tela está em modo de soneca em um estado suspenso de baixa energia. |
ApplicationReport
Informações relatadas sobre um app instalado.
Representação JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
Campos | |
---|---|
packageName |
Nome do pacote do app. |
versionName |
A versão do app conforme exibida ao usuário. |
versionCode |
o código da versão do app, que pode ser usado para determinar se uma versão é mais recente que outra. |
events[] |
A lista dos eventos de app que ocorreram nas últimas 30 horas. |
displayName |
O nome de exibição do app. |
packageSha256Hash |
O hash SHA-256 do arquivo APK do app, que pode ser usado para verificar o app não foi modificado. Cada byte do valor de hash é representado como um número hexadecimal de dois dígitos. |
signingKeyCertFingerprints[] |
O hash SHA-1 de cada |
installerPackageName |
O nome do pacote do app que instalou este app. |
applicationSource |
A origem do pacote. |
state |
Estado do aplicativo. |
keyedAppStates[] |
Lista de estados do app com chave informados pelo app. |
userFacingType |
Se o app é voltado ao usuário. |
ApplicationEvent
Um evento relacionado ao app.
Representação JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento do app. |
createTime |
A hora 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: |
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 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 em primeiro plano. |
UNPINNED |
O app foi liberado. |
ApplicationSource
A fonte que forneceu um app.
Enums | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
O app foi transferido por sideload de uma fonte não especificada. |
SYSTEM_APP_FACTORY_VERSION |
Este é um app do sistema com base na imagem de fábrica do dispositivo. |
SYSTEM_APP_UPDATED_VERSION |
Este é um app atualizado do sistema. |
INSTALLED_FROM_PLAY_STORE |
O app foi instalado pela 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 ( |
Campos | |
---|---|
key |
A chave para o estado do app. atua como um ponto de referência para o que o app está informando. Por exemplo, ao enviar feedback sobre a configuração gerenciada, essa chave pode ser a de configuração gerenciada. |
severity |
Gravidade do estado do app. |
message |
Opcionalmente, uma string de mensagem em 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 |
Opcionalmente, um valor legível por máquina para ser lido pelo EMM. Por exemplo, definir valores que o administrador pode consultar no console de EMM (como "notificar-me se os dados de Battery_warning < 10"). |
createTime |
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: |
lastUpdateTime |
A hora em que o estado do app foi atualizado mais recentemente. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
Gravidade
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 tomar para corrigir. |
UserFacingType
Se o app é voltado ao usuário.
Enums | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
O tipo do app voltado para o usuário não foi especificado. |
NOT_USER_FACING |
O app não é voltado para o usuário. |
USER_FACING |
O app é voltado para o usuário. |
NetworkInfo
Informações da rede do dispositivo
Representação JSON |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
Campos | |
---|---|
imei |
Número IMEI do dispositivo GSM. Por exemplo, |
meid |
Número MEID do dispositivo CDMA. Por exemplo, |
wifiMacAddress |
Endereço MAC Wi-Fi do dispositivo. Por exemplo, |
networkOperatorName |
Nome alfabético do operador registrado atual. Por exemplo, Vodafone. |
telephonyInfos[] |
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. |
TelephonyInfo
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 |
O número de telefone associado a este chip. |
carrierName |
O nome da operadora associada a este chip. |
MemoryInfo
Informações sobre a memória e o armazenamento do dispositivo.
Representação JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Campos | |
---|---|
totalRam |
Total de RAM no dispositivo em bytes. |
totalInternalStorage |
Armazenamento interno total do dispositivo em bytes. |
MemoryEvent
Evento relacionado às medições de memória e armazenamento.
Para distinguir entre eventos novos e antigos, recomendamos usar o campo
.createTime
Representação JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
A hora 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: |
byteCount |
O número de bytes livres na mídia ou, para |
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. |
PowerManagementEvent
Um evento de gerenciamento de energia.
Representação JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
A hora 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: |
batteryLevel |
Para eventos |
PowerManagementEventType
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 ser carregado. |
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. |
HardwareStatus
Status de 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 |
A hora em que as medições foram realizadas. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
batteryTemperatures[] |
Temperaturas atuais da bateria em graus Celsius para cada bateria do dispositivo. |
cpuTemperatures[] |
Temperaturas atuais da CPU em Celsius para cada CPU no dispositivo. |
gpuTemperatures[] |
Temperaturas atuais da GPU em graus Celsius para cada GPU no dispositivo. |
skinTemperatures[] |
Temperaturas da pele atuais do dispositivo em graus Celsius. |
fanSpeeds[] |
Velocidade do ventilador em RPM para cada ventilador no dispositivo. Uma matriz vazia significa que não há ventiladores ou que a velocidade dos ventiladores não é compatível com o sistema. |
cpuUsages[] |
Usos da CPU em porcentagem para cada núcleo disponível no dispositivo. O uso é 0 para cada núcleo desconectado. Uma matriz vazia significa que o sistema não oferece suporte ao uso da CPU. |
DeviceSettings
Informações sobre as configurações relacionadas à segurança do dispositivo.
Representação JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
Campos | |
---|---|
isDeviceSecure |
Se o dispositivo está protegido com PIN/senha. |
unknownSourcesEnabled |
Indica se a instalação de apps de fontes desconhecidas está ativada. |
developmentSettingsEnabled |
Se o modo de desenvolvedor está ativado no dispositivo. |
adbEnabled |
Se o adb está ativado no dispositivo. |
isEncrypted |
Se a criptografia de armazenamento está ativada. |
encryptionStatus |
Status de criptografia do DevicePolicyManager. |
verifyAppsEnabled |
Define 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 |
A criptografia é suportada pelo dispositivo, mas não está ativa no momento. |
ACTIVATING |
A criptografia não está ativa no momento, mas está sendo ativada. |
ACTIVE |
A criptografia está ativa. |
ACTIVE_DEFAULT_KEY |
A criptografia está ativa, mas o usuário não definiu uma chave de criptografia. |
ACTIVE_PER_USER |
A criptografia está ativa e a chave de criptografia está vinculada ao perfil de usuário. |
SecurityPosture
A postura de segurança do dispositivo, como determinada pelo estado atual do dispositivo e as políticas aplicadas.
Representação JSON |
---|
{ "devicePosture": enum ( |
Campos | |
---|---|
devicePosture |
Valor da postura de segurança do dispositivo. |
postureDetails[] |
Mais detalhes sobre a postura de segurança do dispositivo. |
DevicePosture
Possíveis valores de postura de segurança de um dispositivo gerenciado.
Enums | |
---|---|
POSTURE_UNSPECIFIED |
Não especificado. Não há detalhes de postura para esse valor. |
SECURE |
Este dispositivo é seguro. |
AT_RISK |
Este dispositivo pode estar mais vulnerável a agentes maliciosos do que o recomendado para uso com dados corporativos. |
POTENTIALLY_COMPROMISED |
Este dispositivo pode estar comprometido e os dados corporativos podem ficar acessíveis a usuários não autorizados. |
PostureDetail
Mais detalhes sobre a postura de segurança do dispositivo.
Representação JSON |
---|
{ "securityRisk": enum ( |
Campos | |
---|---|
securityRisk |
Um risco de segurança específico que afeta negativamente a postura de segurança do dispositivo. |
advice[] |
Orientação adequada do administrador para mitigar esse risco de segurança e melhorar a postura de segurança do dispositivo. |
SecurityRisk
É o risco que deixa o dispositivo não 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 debasicIntegrity é bem-sucedida, mas o ctsProfileMatch falha. |
COMPROMISED_OS |
A API Play Integrity detecta que o dispositivo está executando um SO comprometido (falha na verificação debasicIntegrity). |
HARDWARE_BACKED_EVALUATION_FAILED |
A API Play Integrity detecta que o dispositivo não tem uma garantia forte de integridade do sistema quando o identificador MEETS_STRONG_INTEGRITY não é mostrado no campo de integridade do dispositivo. |
CommonCriteriaModeInfo
Informações sobre o modo Common Criteria: padrões de segurança definidos na Avaliação de segurança da tecnologia da informação (CC, na sigla em inglês).
Essa informação só vai estar disponível se statusReportingSettings.commonCriteriaModeEnabled
for true
na política do dispositivo.
Representação JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
Campos | |
---|---|
commonCriteriaModeStatus |
Indica se o modo Common Criteria está ativado. |
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 no momento. |
DpcMigrationInfo
Informações relacionadas à migração do dispositivo, que deixou de ser gerenciado por outro controlador de política de dispositivo (DPC).
Representação JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Campos | |
---|---|
previousDpc |
Apenas saída. Se o dispositivo tiver sido migrado de outro DPC, esse vai ser o nome do pacote. Caso contrário, não será preenchido. |
additionalData |
Apenas saída. Se o dispositivo tiver sido migrado de outro DPC, o campo |
Métodos |
|
---|---|
|
Exclui um dispositivo. |
|
Recebe um dispositivo. |
|
Emite um comando para um dispositivo. |
|
Lista os dispositivos de uma determinada empresa. |
|
Atualiza um dispositivo. |