- Recurso: dispositivo
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- EuiccChipInfo
- Display
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravidade
- UserFacingType
- NetworkInfo
- TelephonyInfo
- ActivationState
- ConfigMode
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- DpcMigrationInfo
- Métodos
Recurso: Device
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 ( |
Campos | |
---|---|
name |
O nome do dispositivo no formato |
userName |
O nome do recurso do usuário proprietário deste dispositivo no formato |
managementMode |
O tipo de modo de gerenciamento que o Android Device Policy assume no dispositivo. Isso influencia quais configurações de política são compatíveis. |
state |
O estado a ser aplicado ao dispositivo. Esse 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 que o dispositivo não está em compliance. |
enrollmentTime |
O horário do registro do dispositivo. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
lastStatusReportTime |
A última vez que o dispositivo enviou um relatório de status. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
lastPolicyComplianceReportTime |
Obsoleto. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
lastPolicySyncTime |
A última vez que o dispositivo buscou a política. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
policyName |
O nome da política aplicada ao dispositivo, no formato |
appliedPolicyName |
O nome da política aplicada ao dispositivo no momento. |
appliedPolicyVersion |
A versão da política aplicada ao dispositivo. |
apiLevel |
O nível da API da versão da plataforma Android em execução no dispositivo. |
enrollmentTokenData |
Se o dispositivo foi registrado com um token de registro com dados adicionais, esse campo vai conter esses dados. |
enrollmentTokenName |
Se o dispositivo foi registrado com um token de registro, esse 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ó estão disponíveis se |
hardwareInfo |
Informações detalhadas sobre o hardware do dispositivo. |
displays[] |
Informações detalhadas sobre as telas do dispositivo. Essas informações só estão disponíveis se |
applicationReports[] |
Relatórios para 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, esse campo vai conter os nomes anteriores dele. O número de série é usado como identificador exclusivo para determinar se o mesmo dispositivo físico já foi registrado. Os nomes estão em ordem cronológica. |
networkInfo |
Informações da rede do dispositivo. Essas informações só estão disponíveis se |
memoryInfo |
Informações de memória: contém informações sobre a memória e o armazenamento do dispositivo. |
memoryEvents[] |
Eventos relacionados a medições de memória e armazenamento em ordem cronológica. Essas informações só estão disponíveis se Os eventos são mantidos por um determinado período, e os mais antigos são excluídos. |
powerManagementEvents[] |
Eventos de gerenciamento de energia no dispositivo em ordem cronológica. Essas informações só estão disponíveis se |
hardwareStatusSamples[] |
Exemplos de status de hardware em ordem cronológica. Essas informações só estão disponíveis se |
deviceSettings |
Informações sobre as configurações do dispositivo. Essas informações só estão disponíveis se |
user |
O usuário proprietário do dispositivo. |
systemProperties |
Mapa do nome e valor das propriedades do sistema selecionadas relacionadas ao dispositivo. Essas informações só estão disponíveis se Um objeto com uma lista de pares |
securityPosture |
Valor da postura de segurança do dispositivo que reflete o nível de segurança dele. |
ownership |
Propriedade do dispositivo gerenciado. |
commonCriteriaModeInfo |
Informações sobre o modo Common Criteria: padrões de segurança definidos nos Critérios comuns para avaliação de segurança de tecnologia da informação (CC, na sigla em inglês). Essas informações só estão disponíveis se |
appliedPasswordPolicies[] |
Os requisitos de senha aplicados ao dispositivo no momento.
|
dpcMigrationInfo |
Apenas saída. Informações relacionadas à migração deste 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 confirma 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 dele vai permanecer desconhecido para o servidor. |
PROVISIONING |
O dispositivo está sendo provisionado. Os dispositivos recém-registrados ficam nesse estado até que uma política seja 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 |
É um dispositivo financiado que foi "bloqueado" pelo agente financeiro. Isso significa que algumas configurações de política foram aplicadas e limitam a funcionalidade do dispositivo até que ele seja "desbloqueado" pelo agente financeiro. O dispositivo vai continuar aplicando as configurações de política, exceto aquelas substituídas pelo agente financeiro. 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 ( |
Campos | |
---|---|
settingName |
O nome da configuração de política. Esse é o nome do campo JSON de um campo |
nonComplianceReason |
O motivo pelo qual o dispositivo não está em conformidade com a configuração. |
packageName |
O nome do pacote que indica qual app está fora da conformidade, se aplicável. |
fieldPath |
Para configurações com campos aninhados, se um campo aninhado específico estiver fora da conformidade, isso vai especificar o caminho completo até o campo em questão. O caminho é formatado da mesma forma que o campo JSON da política seria referenciado em JavaScript. Ou seja: 1) Para campos do tipo objeto, o nome do campo é seguido por um ponto e depois por um nome de subcampo. 2) Para campos 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 conformidade com a configuração. |
specificNonComplianceContext |
Contexto adicional para |
InstallationFailureReason
Motivos para a falha na instalação de um app.
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 motivos possíveis 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á repetida 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 atende a |
INSUFFICIENT_STORAGE |
O dispositivo do usuário não tem espaço de armazenamento suficiente para instalar o app. Isso pode ser resolvido liberando espaço no dispositivo. A instalação ou atualização do app será retomada automaticamente quando o dispositivo tiver espaço de armazenamento suficiente. |
SpecificNonComplianceReason
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 à enumeração 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. , definida como . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
A senha do dispositivo ou do perfil expirou. está definido. , definida como . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
A senha do dispositivo não atende aos requisitos. está definido. , definida como . |
ONC_WIFI_INVALID_VALUE |
Há um valor incorreto na configuração de Wi-Fi do ONC. especifica qual valor de campo está incorreto. está definido. , definida 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. , definida como . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
A rede Wi-Fi empresarial não tem a CA raiz ou o nome de domínio. é definido como . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
O usuário precisa remover manualmente a rede Wi-Fi configurada. Isso se aplica 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. , definida como . |
PERMISSIBLE_USAGE_RESTRICTION |
Essa configuração de política é restrita e não pode ser definida para este projeto do Google Cloud Platform. Mais detalhes (incluindo como ativar o uso dessa configuração de política) estão disponíveis na Política de uso permitido. , definida como . |
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE |
A conta de trabalho exigida pela configuração de política não faz mais parte da empresa. , definida como . |
NEW_ACCOUNT_NOT_IN_ENTERPRISE |
A conta de trabalho adicionada pelo usuário não faz parte da empresa. é definido como . |
SpecificNonComplianceContext
Contexto adicional para
.SpecificNonComplianceReason
Representação JSON |
---|
{ "oncWifiContext": { object ( |
Campos | |
---|---|
oncWifiContext |
Contexto adicional para não conformidade relacionada à configuração de Wi-Fi. Consulte |
passwordPoliciesContext |
Contexto adicional para não conformidade relacionada às políticas de senhas. Consulte |
OncWifiContext
Contexto adicional para não conformidade 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 conformidade relacionada às políticas de senhas.
Representação JSON |
---|
{
"passwordPolicyScope": enum ( |
Campos | |
---|---|
passwordPolicyScope |
O escopo da senha em não conformidade. |
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 |
O código da versão do app Android Device Policy. |
androidDevicePolicyVersionName |
A versão do app Android Device Policy exibida ao usuário. |
androidBuildNumber |
String de ID de build do Android destinada à exibição para o 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. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
securityPatchLevel |
Nível do patch de segurança, por exemplo, |
primaryLanguageCode |
Um código de idioma IETF BCP 47 para a localidade principal no 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 |
O status de uma atualização: se ela existe e qual é o tipo. |
updateReceivedTime |
A data e 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ó é definido se uma atualização estiver disponível (ou seja, Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
UpdateStatus
O status de uma atualização: se ela existe e qual é o tipo.
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 é inferior a 26 ou se a versão da Política do dispositivo Android está desatualizada. |
UP_TO_DATE |
Não há nenhuma atualização do sistema pendente disponível 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 pendente do SO 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,
"euiccChipInfo": [
{
object ( |
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 graus Celsius para cada bateria no dispositivo. |
batteryThrottlingTemperatures[] |
Limites de temperatura de redução da bateria em graus Celsius para cada bateria no dispositivo. |
cpuShutdownTemperatures[] |
Limites de temperatura de desligamento da CPU em graus Celsius para cada CPU no dispositivo. |
cpuThrottlingTemperatures[] |
Limites de temperatura de limitação de CPU em graus Celsius para cada CPU no dispositivo. |
gpuShutdownTemperatures[] |
Limites de temperatura de desligamento da GPU em graus Celsius para cada GPU no dispositivo. |
gpuThrottlingTemperatures[] |
Limites de temperatura de redução da GPU em graus Celsius para cada GPU no dispositivo. |
skinShutdownTemperatures[] |
Limiares de temperatura de desligamento da pele do dispositivo em Celsius. |
skinThrottlingTemperatures[] |
Limites de temperatura de restriçã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 em redefinições de fábrica. Esse ID está disponível em dispositivos pessoais com um perfil de trabalho em aparelhos com Android 12 e versões mais recentes. |
euiccChipInfo[] |
Apenas saída. Informações relacionadas ao chip eUICC. |
EuiccChipInfo
Informações relacionadas ao chip eUICC.
Representação JSON |
---|
{ "eid": string } |
Campos | |
---|---|
eid |
Apenas saída. O documento de identidade incorporado (EID) que identifica o chip eUICC para cada chip eUICC no dispositivo. Esse recurso está disponível em dispositivos da empresa com Android 13 e versões mais recentes. |
Display
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 frames por segundo. |
state |
Estado da exibição. |
width |
Largura da tela em pixels. |
height |
Altura da tela em pixels. |
density |
Densidade de exibição expressa como pontos por polegada. |
DisplayState
O estado de uma exibição.
Enums | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
Esse valor não é permitido. |
OFF |
A tela está desligada. |
ON |
A tela está ligada. |
DOZE |
O display está em modo de espera com baixo consumo de energia |
SUSPENDED |
O display está em um estado suspenso de baixo consumo de 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 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 de eventos do 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 se 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 de app com chaves informados pelo app. |
userFacingType |
Se o app é voltado para o usuário. |
ApplicationEvent
Um evento relacionado a apps.
Representação JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento do app. |
createTime |
A hora de criação do evento. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
ApplicationEventType
Um tipo de evento relacionado a apps.
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 limpos. |
REMOVED |
O app foi removido. |
REPLACED |
Uma nova versão do app foi instalada, substituindo a antiga. |
RESTARTED |
O app foi reiniciado. |
PINNED |
O app foi fixado em primeiro plano. |
UNPINNED |
O app foi liberado. |
ApplicationSource
A origem 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 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 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 do estado do app. Age como um ponto de referência para o estado que o app está fornecendo. Por exemplo, ao fornecer feedback sobre a configuração gerenciada, essa chave pode ser a chave da configuração gerenciada. |
severity |
A gravidade do estado do app. |
message |
Opcional. 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 |
Opcional: um valor legível por máquina para ser lido pelo EMM. Por exemplo, definir valores que o administrador pode consultar no console da EMM (por exemplo, "me avise se os dados de battery_warning < 10"). |
createTime |
A hora de criação do estado do app no dispositivo. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
lastUpdateTime |
O horário em que o estado do app foi atualizado pela última vez. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
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 para o usuário.
Enums | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
O tipo de usuário do app não foi especificado. |
NOT_USER_FACING |
O app não é voltado para o 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 ( |
Campos | |
---|---|
imei |
Número IMEI do dispositivo GSM. Por exemplo, |
meid |
Número MEID do dispositivo CDMA. Por exemplo, |
wifiMacAddress |
Endereço MAC do Wi-Fi do dispositivo. Por exemplo, |
networkOperatorName |
Nome alfabético do operador registrado no momento. 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, "iccId": string, "activationState": enum ( |
Campos | |
---|---|
phoneNumber |
O número de telefone associado a este chip. |
carrierName |
O nome da operadora associada a este chip. |
iccId |
Apenas saída. O ICCID associado a este chip. |
activationState |
Apenas saída. Estado de ativação do chip no dispositivo. Isso se aplica apenas a eSIMs. Essa opção é aceita em todos os dispositivos com API de nível 35 e versões mais recentes. Esse valor é sempre |
configMode |
Apenas saída. O modo de configuração do chip no dispositivo. Isso se aplica apenas a eSIMs. Essa opção é aceita em todos os dispositivos com API de nível 35 e versões mais recentes. Esse valor é sempre |
ActivationState
Estado de ativação do chip no dispositivo.
Enums | |
---|---|
ACTIVATION_STATE_UNSPECIFIED |
O estado de ativação não foi especificado. |
ACTIVATED |
O chip está ativado. |
NOT_ACTIVATED |
O chip não está ativado. |
ConfigMode
O modo de configuração do chip no dispositivo.
Enums | |
---|---|
CONFIG_MODE_UNSPECIFIED |
O modo de configuração não foi especificado. |
ADMIN_CONFIGURED |
O administrador configurou este chip. |
USER_CONFIGURED |
O usuário configurou este SIM. |
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 |
Total do armazenamento interno no dispositivo em bytes. |
MemoryEvent
Um evento relacionado a 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. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
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 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 dispositivo de armazenamento externo foi detectado. A contagem de bytes informada é a capacidade total do meio de armazenamento. |
EXTERNAL_STORAGE_REMOVED |
Um dispositivo de armazenamento externo foi removido. A contagem de bytes informada é zero. |
EXTERNAL_STORAGE_MEASURED |
O espaço livre em um dispositivo 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. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
batteryLevel |
Para eventos |
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 economia de bateria. |
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 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 |
O momento em que as medições foram feitas. Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, |
batteryTemperatures[] |
Temperaturas atuais da bateria em graus Celsius para cada bateria no dispositivo. |
cpuTemperatures[] |
Temperaturas atuais da CPU em graus Celsius para cada CPU no dispositivo. |
gpuTemperatures[] |
Temperaturas atuais da GPU em graus Celsius para cada GPU no dispositivo. |
skinTemperatures[] |
Temperaturas atuais da pele do dispositivo em graus Celsius. |
fanSpeeds[] |
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[] |
Uso 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 é compatível com o sistema. |
DeviceSettings
Informações sobre configurações de segurança relacionadas ao 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 |
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 da criptografia do DevicePolicyManager. |
verifyAppsEnabled |
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 |
A criptografia não é compatível com o dispositivo. |
INACTIVE |
A criptografia é compatível com o 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. |
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 ( |
Campos | |
---|---|
devicePosture |
Valor da postura de segurança do dispositivo. |
postureDetails[] |
Detalhes adicionais sobre a postura de segurança do dispositivo. |
DevicePosture
Valores possíveis da postura de segurança de um dispositivo gerenciado.
Enums | |
---|---|
POSTURE_UNSPECIFIED |
Não especificado. Não há detalhes para esse valor de postura. |
SECURE |
Este dispositivo está seguro. |
AT_RISK |
Esse dispositivo pode ser mais vulnerável a pessoas mal-intencionadas do que o recomendado para uso com dados corporativos. |
POTENTIALLY_COMPROMISED |
Este dispositivo pode estar comprometido, e os dados corporativos podem estar acessíveis a atores não autorizados. |
PostureDetail
Detalhes adicionais 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ções correspondentes para administradores sobre como mitigar 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 (a verificação basicIntegrity falha). |
HARDWARE_BACKED_EVALUATION_FAILED |
A API Play Integrity detecta que o dispositivo não tem uma garantia forte de integridade do sistema se o rótulo 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 Critérios comuns para avaliação de segurança de tecnologia da informação (CC, na sigla em inglês).
Essas informações só estão disponíveis se statusReportingSettings.commonCriteriaModeEnabled
estiver true
na política do dispositivo.
Representação JSON |
---|
{ "commonCriteriaModeStatus": enum ( |
Campos | |
---|---|
commonCriteriaModeStatus |
Se o modo Common Criteria está ativado. |
policySignatureVerificationStatus |
Apenas saída. O status da verificação de assinatura da política. |
CommonCriteriaModeStatus
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 de assinatura da política.
Enums | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
Não especificado. O status da verificação não foi informado. Isso só será definido se for falso. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
A verificação de assinatura da política está desativada no dispositivo porque está definido como "false". |
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 da política não é compatível, por exemplo, porque o dispositivo foi registrado com uma versão do CloudDPC que não é compatível com a verificação de assinatura da política. |
POLICY_SIGNATURE_VERIFICATION_FAILED |
A verificação da assinatura da política falhou. A política não foi aplicada. |
DpcMigrationInfo
Informações relacionadas à migração deste dispositivo de outro controlador de política de dispositivo (DPC).
Representação JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Campos | |
---|---|
previousDpc |
Apenas saída. Se o dispositivo foi migrado de outra DPC, este é o nome do pacote. Caso contrário, não será preenchido. |
additionalData |
Apenas saída. Se o dispositivo foi migrado de outra DPC, o campo |
Métodos |
|
---|---|
|
Exclui um dispositivo. |
|
Recebe um dispositivo. |
|
Envia um comando para um dispositivo. |
|
Lista os dispositivos de uma determinada empresa. |
|
Atualiza um dispositivo. |