Devices

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Um recurso de dispositivos representa um dispositivo móvel gerenciado pelo EMM e pertencente a um usuário empresarial 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,
    "policyId": 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 O codinome do 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 o nível em que 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 do dispositivo (DPC) do EMM como proprietário.
  • "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 que foi 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 é de um DPC.


Os valores aceitáveis são:
  • "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.
  • always ativa as atualizações automáticas.
  • never desativa as atualizações automáticas.
  • wifiOnly ativa as atualizações automáticas somente quando o dispositivo está conectado ao Wi-Fi.


Os valores aceitáveis são:
  • "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 em execução 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.
policy.maintenanceWindow.startTimeAfterMidnightMs long Horário de início da janela de manutenção, em milissegundos após a meia-noite no dispositivo. As janelas podem se estender até a meia-noite.
policy.policyId string Um identificador da política que será transmitido com o feedback de instalação do app enviado pela Play Store.
policy.productAvailabilityPolicy string A disponibilidade concedida ao dispositivo para os produtos especificados. "all" dá ao dispositivo acesso a todos os produtos, independentemente do status de aprovação. "all" não ativa a visibilidade automática de faixas "alpha" ou "beta". "whitelist" concede ao dispositivo acesso aos produtos especificados em productPolicy[]. Somente os produtos aprovados ou que foram aprovados anteriormente (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 de 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 do estado de inatividade 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 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. É possível definir um código de versão mínima 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. Portanto, quando um usuário faz alterações nas configurações do dispositivo manualmente, elas são ignoradas.

Os valores aceitáveis são:
  • "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 autenticador já precisa 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 gerenciado e o conjunto de variáveis de configuração (se houver) definido para o usuário.
policy.productPolicy[].managedConfiguration.configurationVariables.kind string
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId string O ID das configurações de 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 de marcador de posição, definida pelo EMM.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue string O valor do marcador, específico para o usuário.
policy.productPolicy[].managedConfiguration.kind string Descontinuado.

policy.productPolicy[].managedConfiguration.managedProperty[] list O conjunto de propriedades gerenciadas para essa 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 bool.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle nested object O pacote de propriedades gerenciadas. Ele só vai estar presente se o tipo da 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. Ela 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, que só vai 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, choice ou hidden.
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] list A lista de valores de string: só estará presente se o tipo da propriedade for de seleção múltipla.
policy.productPolicy[].managedConfiguration.productId string O ID do produto para o qual a configuração gerenciada é destinada, 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 acessada 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 atualizado com os estados mais recentes do app.
report.appState[] list Lista de estados de apps definidos por apps gerenciados no dispositivo. Os estados do app são definidos pelos desenvolvedores. Esse campo sempre estará presente.
report.appState[].keyedAppState[] list Lista de estados de chaves do app. Esse 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 XSS, recomendamos remover qualquer HTML dos dados antes de exibi-los.
report.appState[].keyedAppState[].key string Chave que indica para qual estado 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. Esse 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. Esse campo sempre estará presente.
report.appState[].packageName string O nome do pacote do app. Esse campo sempre estará presente.
report.lastUpdatedTimestampMillis long O carimbo de data/hora da última atualização do relatório em milissegundos desde a época. 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 todas as mudanças nos estados do app no dispositivo desde a geração do último relatório. Você pode chamar esse método até três vezes a cada 24 horas em 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ó entrará em vigor se a aplicação de políticas de EMM em dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado e todos os dispositivos poderão acessar os serviços do Google. Esse recurso 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 está ativado ou desativado. O estado do dispositivo só entrará em vigor se a aplicação de políticas de EMM em dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado e todos os dispositivos poderão acessar os serviços do Google. Esse recurso 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, é necessário impedir que contas não gerenciadas acessem o Google Play definindo o allowed_accounts na configuração gerenciada do pacote do Google Play. Consulte restringir contas no Google Play.