Devices

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:
  • "managedDevice", um dispositivo que tem o controlador de política de dispositivo (DPC) do EMM como proprietário do dispositivo.
  • "managedProfile", um dispositivo que tem um perfil gerenciado pelo DPC (o DPC é o proprietário do perfil), além de um perfil pessoal separado que não está disponível para o DPC.
  • "containerApp" não é mais usada (descontinuado).
  • "unmanagedProfile", é um dispositivo autorizado (pelo administrador do domínio, usando o Admin Console para ativar o privilégio) a usar o Google Play gerenciado, mas o perfil não pertence a um DPC.
.

Os valores aceitáveis são os seguintes:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
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:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string Se o dispositivo informa os estados do app ao EMM. O valor padrão é "deviceReportDisabled".

Os valores aceitáveis são:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
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:
  • "all"
  • "whitelist"
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:
  • "chargingNotRequired"
  • "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string Restrição de estado inativo do dispositivo.

Os valores aceitáveis são:
  • "deviceIdleNotRequired"
  • "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string Restrição de tipo de rede.

Os valores aceitáveis são:
  • "anyNetwork"
  • "unmeteredNetwork"
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:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
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:
  • "autoUpdateDefault"
  • "autoUpdateHighPriority"
  • "autoUpdatePostponed"
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:
  • "severityError"
  • "severityInfo"
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 configurando allowed_accounts na configuração gerenciada do Google Google Play. Consulte restringir no Google Play.