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

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,
    "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 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. "nunca" 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 (inclusive).
`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. "todos" não ativa a visibilidade automática da versão "Alfa" ou "Beta" rastros. "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 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 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 de estado ocioso 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. É 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 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 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 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, choice ou hidden.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	A lista de valores de string: estará presente apenas 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 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 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 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 as mudanças nos estados do app no dispositivo desde o último relatório foi gerado. É 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. 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 dispositivos estão ativados 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. 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 contas no Google Play.