Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
O recurso Dispositivos representa um dispositivo móvel gerenciado pelo EMM e pertencente a um usuário corporativo específico.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
Nome da propriedade | Valor | Descrição | Observações |
---|---|---|---|
androidId |
string |
O ID do Android do Google Play Services para o dispositivo codificado como uma string hexadecimal em letras minúsculas. Por exemplo, "123456789abcdef0" . |
|
device |
string |
Codinome de hardware interno do dispositivo. Isso vem de android.os.Build.DEVICE . (campo chamado "device" de acordo com logs/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
A impressão digital do build do dispositivo, se conhecida. | |
maker |
string |
O fabricante do dispositivo. Isso vem de android.os.Build.MANUFACTURER . |
|
managementType |
string |
Identifica até que ponto o dispositivo é controlado por um EMM gerenciado do Google Play em várias configurações de implantação. Os valores possíveis incluem:
Os valores aceitáveis são os seguintes:
|
|
model |
string |
O nome do modelo do dispositivo. Isso vem de android.os.Build.MODEL . |
|
policy |
nested object |
A política aplicada ao dispositivo. | |
policy.autoUpdatePolicy |
string |
Controla quando as atualizações automáticas de apps podem ser aplicadas no dispositivo. Alternativa recomendada: autoUpdateMode , que é definido por app, oferece maior flexibilidade em relação à frequência de atualização. Quando autoUpdateMode é definido como AUTO_UPDATE_POSTPONED ou AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy não tem efeito. "choiceToTheUser" permite que o usuário do dispositivo configure a política de atualização do app. "sempre" ativa atualizações automáticas. "nunca" desativa as atualizações automáticas. "WiFiOnly" ativa atualizações automáticas apenas quando o dispositivo está conectado ao Wi-Fi. Os valores aceitáveis são os seguintes:
|
|
policy.deviceReportPolicy |
string |
Se o dispositivo informa os estados do app ao EMM. O valor padrão é "deviceReportDisabled".
Os valores aceitáveis são:
|
|
policy.maintenanceWindow |
nested object |
A janela de manutenção que define quando os apps executados em primeiro plano precisam ser atualizados. | |
policy.maintenanceWindow.durationMs |
long |
Duração da janela de manutenção, em milissegundos. A duração precisa ser de 30 minutos a 24 horas (inclusive). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
É o horário de início da janela de manutenção, em milissegundos após a meia-noite no dispositivo. As janelas podem abranger a meia-noite. | |
policy.productAvailabilityPolicy |
string |
A disponibilidade concedida ao dispositivo para os produtos especificados. "todos" concede ao dispositivo acesso a todos os produtos, seja qual for o status de aprovação. "todos" não ativa a visibilidade automática da versão "Alfa" ou "Beta" rastros. "lista de permissões" concede ao dispositivo acesso aos produtos especificados em productPolicy[]. Somente produtos aprovados ou previamente aprovados (produtos com aprovação revogada) pela empresa podem ser incluídos na lista de permissões. Se nenhum valor for fornecido, a disponibilidade definida no nível do usuário será aplicada por padrão.
Os valores aceitáveis são:
|
|
policy.productPolicy[] |
list |
A lista de políticas de produtos. O productAvailabilityPolicy precisa ser definido como WHITELIST ou ALL para que as políticas do produto sejam aplicadas. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
A política de instalação automática do produto. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
As restrições para instalação automática do app. É possível especificar no máximo uma restrição. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Restrição do estado de carregamento.
Os valores aceitáveis são:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Restrição de estado inativo do dispositivo.
Os valores aceitáveis são:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Restrição de tipo de rede.
Os valores aceitáveis são:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
O modo de instalação automática. Se não for definido, o padrão será "doNotAutoInstall". Um app é instalado automaticamente, independentemente de uma janela de manutenção definida.
Os valores aceitáveis são:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
A prioridade da instalação, como um número inteiro não assinado. Um número menor significa maior prioridade. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
A versão mínima do app. Se uma versão anterior do app estiver instalada, ele será atualizado automaticamente de acordo com as restrições de instalação automática, em vez de esperar pela atualização automática normal. Você pode definir um código de versão mínimo para no máximo 20 apps por dispositivo. | |
policy.productPolicy[].autoUpdateMode |
string |
O modo de atualização automática do produto. Quando autoUpdateMode é usado, ele sempre tem precedência sobre a escolha do usuário. Quando um usuário faz mudanças nas configurações do dispositivo manualmente, elas são ignoradas.
Os valores aceitáveis são os seguintes:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Uma configuração de URL de autenticação para o app autenticador de um provedor de identidade. Isso ajuda a iniciar o app autenticador do provedor de identidade durante a autenticação em um app particular usando o Android WebView. O app Google Authenticator já deve ser o gerenciador padrão do URL de autenticação no dispositivo. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
Um URL de autenticação. | |
policy.productPolicy[].managedConfiguration |
nested object |
A configuração gerenciada do produto. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
Contém o ID do perfil de configuração gerenciada e o conjunto de variáveis de configuração (se houver) definidos para o usuário. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
O ID das configurações gerenciadas. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
O conjunto de variáveis atribuído ao usuário. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
A string do marcador de posição definido pelo EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
O valor do marcador, específico para o usuário. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Obsoleto. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
O conjunto de propriedades gerenciadas para esta configuração. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
A chave exclusiva que identifica a propriedade. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
O valor booleano - só estará presente se o tipo da propriedade for booleano. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
O pacote de propriedades gerenciadas: estará presente apenas se o tipo de propriedade for pacote. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
A lista de propriedades gerenciadas. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
A lista de pacotes de propriedades: só vai estar presente se o tipo da propriedade for bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
A lista de propriedades gerenciadas. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
O valor inteiro: só estará presente se o tipo da propriedade for inteiro. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
O valor da string: só estará presente se o tipo da propriedade for string, option ou oculto. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
A lista de valores de string: só vai estar presente se o tipo da propriedade for de seleção múltipla. | |
policy.productPolicy[].managedConfiguration.productId |
string |
O ID do produto referente à configuração gerenciada, por exemplo, "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
O ID do produto. Por exemplo, "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
Concede ao dispositivo visibilidade às faixas de lançamento de produto especificadas, identificadas por trackIds . A lista de faixas de lançamento de um produto pode ser recebida chamando Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Obsoleto. Use trackIds |
|
product |
string |
O nome do produto do dispositivo. Isso vem de android.os.Build.PRODUCT . |
|
report |
nested object |
O relatório do dispositivo foi atualizado com os estados mais recentes do app. | |
report.appState[] |
list |
Lista de estados definidos pelos apps gerenciados no dispositivo. Os estados do app são definidos pelos desenvolvedores. Este campo sempre estará presente. | |
report.appState[].keyedAppState[] |
list |
Lista de estados do app com chave. Este campo sempre estará presente. | |
report.appState[].keyedAppState[].data |
string |
Campo adicional destinado a dados legíveis por máquina. Por exemplo, um número ou objeto JSON. Para evitar o XSS, recomendamos remover qualquer HTML dos dados antes de exibi-los. | |
report.appState[].keyedAppState[].key |
string |
Chave indicando para que o app está fornecendo um estado. O conteúdo da chave é definido pelo desenvolvedor do app. Para evitar XSS, recomendamos remover qualquer HTML da chave antes de exibi-la. Este campo sempre estará presente. | |
report.appState[].keyedAppState[].message |
string |
Mensagem de formato livre legível por humanos que descreve o estado do app. Por exemplo, uma mensagem de erro. Para evitar XSS, recomendamos remover qualquer HTML da mensagem antes de exibi-la. | |
report.appState[].keyedAppState[].severity |
string |
Gravidade do estado do app. Este campo sempre estará presente.
Os valores aceitáveis são:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Carimbo de data/hora de quando o app definiu o estado em milissegundos desde a época. Este campo sempre estará presente. | |
report.appState[].packageName |
string |
O nome do pacote do app. Este campo sempre estará presente. | |
report.lastUpdatedTimestampMillis |
long |
É o carimbo de data/hora da última atualização do relatório em milissegundos desde o período. Este campo sempre estará presente. | |
retailBrand |
string |
Marca de varejo do dispositivo, se definida. Consulte android.os.Build.BRAND . |
|
sdkVersion |
integer |
Versão de compatibilidade da API. |
Métodos
- forceReportUpload
- Faz o upload de um relatório com as mudanças nos estados do app no dispositivo desde o último relatório foi gerado. Esse método pode ser chamado até 3 vezes a cada 24 horas para um determinado dispositivo.
- get
- Recupera os detalhes de um dispositivo.
- getState
- Recupera se o acesso de um dispositivo aos serviços do Google está ativado ou desativado. O estado do dispositivo só entra em vigor se as políticas de EMM forem aplicadas no Android está ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado, e todos os dispositivos terão acesso permitido aos serviços do Google. Isso só é compatível com usuários gerenciados pelo Google.
- list
- Recupera os IDs de todos os dispositivos de um usuário.
- setState
- Define se o acesso de um dispositivo aos serviços do Google fica ativado ou desativado. O estado do dispositivo só entra em vigor se as políticas de EMM forem aplicadas no Android está ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado, e todos os dispositivos terão acesso permitido aos serviços do Google. Isso só é compatível com usuários gerenciados pelo Google.
- update
- Atualiza a política do dispositivo.
Para garantir que a política seja aplicada corretamente, é preciso impedir que as políticas de acessar o Google Play configurandoallowed_accounts
na configuração gerenciada do Google Google Play. Consulte restringir no Google Play.