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 que pertence 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
`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 interno do hardware 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 da versão do dispositivo, se conhecida.
`maker`	`string`	Fabricante do dispositivo. Isso vem de `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Identifica até que ponto o dispositivo é controlado por um EMM do Google Play gerenciado 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. "`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 usado (descontinuado). "`unmanagedProfile`", um dispositivo que tem permissão (pelo administrador do domínio, usando o Admin Console para ativar o privilégio) para usar o Google Play gerenciado, mas o perfil não pertence a um DPC. Estes são os valores aceitáveis: "`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 e 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 de apps. "sempre" ativa as atualizações automáticas. "Nunca" desativa as atualizações automáticas. "wifiOnly" ativa atualizações automáticas apenas quando o dispositivo está conectado a uma rede Wi-Fi. Estes são os valores aceitáveis: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	Se o dispositivo informa estados do app para o EMM. O valor padrão é "deviceReportDisabled". Os valores aceitáveis são: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	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 abranger a meia-noite.
`policy.productAvailabilityPolicy`	`string`	A disponibilidade concedida ao dispositivo para os produtos especificados. A opção "all" dá ao dispositivo acesso a todos os produtos, independentemente do status de aprovação. A opção "all" não ativa a visibilidade automática das faixas "Alfa" ou "Beta". "checklist" concede ao dispositivo o acesso aos produtos especificados em productPolicy[]. Somente produtos aprovados ou aprovados anteriormente pela empresa (produtos com aprovação revogada) podem ser incluídos na lista de permissões. Se nenhum valor for informado, a disponibilidade definida no nível do usuário vai ser aplicada por padrão. Os valores aceitáveis são: "`all`" "`whitelist`"
`policy.productPolicy[]`	`list`	Lista de políticas de produtos. O `productAvailabilityPolicy` precisa ser definido como `WHITELIST` ou `ALL` para que as políticas de produtos sejam aplicadas.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	A política de instalação automática do produto.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	São 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 de 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 é "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 sem assinatura. Quanto menor o número, maior a prioridade.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	É a versão mínima do app. Se uma versão anterior estiver instalada, o app vai ser atualizado automaticamente de acordo com as restrições de instalação automática, em vez de esperar pela atualização automática regular. Você pode 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 o `autoUpdateMode` é usado, ele sempre tem precedência sobre a escolha do usuário. Quando um usuário faz alterações manuais nas configurações do dispositivo, elas são ignoradas. Estes são os valores aceitáveis: "`autoUpdateDefault`" "`autoUpdateHighPriority`" "`autoUpdatePostponed`"
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	Uma configuração do 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 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 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 definiçõ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 do marcador, 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`	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 - estará presente apenas se o tipo da propriedade for booleano.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	O pacote de propriedades gerenciadas: só estará presente se o tipo da propriedade for um pacote.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	Lista de propriedades gerenciadas.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	A lista de pacotes de propriedades: ela só estará presente se o tipo da propriedade for bundle_array.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	Lista de propriedades gerenciadas.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	O valor inteiro: só estará presente se o tipo da propriedade for número inteiro.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	O valor da string: só estará presente se o tipo da propriedade for string, escolha ou oculto.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	A lista de valores de string. Ela só 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`	ID do produto. Por exemplo, `"app:com.google.android.gm"`.
`policy.productPolicy[].trackIds[]`	`list`	Concede ao dispositivo visibilidade para as faixas de lançamento do produto especificadas, identificadas por `trackIds`. Para acessar a lista de controles de lançamento de um produto, chame 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 de dispositivos é atualizado com os estados mais recentes do app.
`report.appState[]`	`list`	Lista de estados do app definidos por 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 de apps codificados. 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 que o app fornece 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 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 o início da era Unix. 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 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 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 a dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado e todos os dispositivos terão permissão para acessar os Serviços do Google. Somente usuários gerenciados pelo Google têm suporte.
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 a dispositivos Android estiver ativada no Google Admin Console. Caso contrário, o estado do dispositivo será ignorado e todos os dispositivos terão permissão para acessar os Serviços do Google. Somente usuários gerenciados pelo Google têm suporte.
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. Para isso, defina allowed_accounts na configuração gerenciada do pacote do Google Play. Consulte como restringir contas no Google Play.