Importante: não aceitamos mais novos registros para a API Play EMM. Saiba mais.

Esta página foi traduzida pela API Cloud Translation.

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
`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 "device" em 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 com um perfil gerenciado pelo DPC (o DPC é o proprietário do perfil) e um perfil pessoal separado que não está disponível para o DPC. "`containerApp`", que não é mais usado (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 no dispositivo podem ser aplicadas. 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. Importante:as mudanças nas políticas de atualização de apps não afetam as atualizações em andamento. Todas as mudanças na política serão aplicadas às atualizações do app. 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 a 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 for instalada, o app 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 WebView do Android. 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 de posição, 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. Ela só vai estar presente se o tipo da propriedade for multiseleção.
`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 a visibilidade do dispositivo para as 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 chave 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. Esse 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. Esse 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. É possível chamar esse método até três 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 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ó entra 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.