REST Resource: mobiledevices

Recurso: MobileDevice

O Gerenciamento de dispositivos móveis do Google Workspace inclui dispositivos Android, Google Sync e iOS. Para mais informações sobre as tarefas comuns da API em grupo para dispositivos móveis, consulte o Guia para desenvolvedores.

Representação JSON
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
Campos
kind

string

O tipo do recurso da API. Para recursos Mobiledevices, o valor é admin#directory#mobiledevice.

etag

string

ETag do recurso.

resourceId

string

O ID exclusivo que o serviço da API usa para identificar o dispositivo móvel.

deviceId

string

O número de série de um dispositivo móvel do Google Sync. Para dispositivos Android e iOS, é um identificador exclusivo gerado por software.

name[]

string

A lista dos nomes de usuário do proprietário. Caso seu aplicativo precise da lista atual de nomes de proprietários de dispositivos, use o método get. Para mais informações sobre como recuperar informações de usuários de dispositivos móveis, consulte o Guia do desenvolvedor.

email[]

string

A lista de endereços de e-mail do proprietário. Caso seu aplicativo precise da lista atual de e-mails do usuário, use o método get. Para mais informações, consulte o método recuperar um usuário.

model

string

O nome do modelo do dispositivo móvel, por exemplo, Nexus S. Essa propriedade pode ser atualizada. Para mais informações, consulte o Guia do desenvolvedor.

os

string

O sistema operacional do dispositivo móvel, por exemplo, IOS 4.3 ou Android 2.3.5. Essa propriedade pode ser atualizada. Para mais informações, consulte o Guia do desenvolvedor.

type

string

O tipo de dispositivo móvel.

status

string

O status do dispositivo.

hardwareId

string

O identificador exclusivo IMEI/MEID para o hardware do Android. Ela não se aplica a dispositivos Google Sync. Ao adicionar um dispositivo móvel Android, essa propriedade é opcional. Ao atualizar um desses dispositivos, esta é uma propriedade somente leitura.

firstSync

string

Mostra a data e a hora em que o dispositivo foi sincronizado inicialmente com as configurações da política no Admin Console. O valor está no formato de data e hora ISO 8601. A hora é a data completa mais horas, minutos e segundos no formato <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Por exemplo, 2010-04-05T17:30:04+01:00.

lastSync

string

a data e a hora em que o dispositivo foi sincronizado pela última vez com as configurações da política no Admin Console; O valor está no formato de data e hora ISO 8601. A hora é a data completa mais horas, minutos e segundos no formato <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Por exemplo, 2010-04-05T17:30:04+01:00.

userAgent

string

Fornece informações sobre o dispositivo, como a versão do os. Essa propriedade pode ser atualizada. Para mais informações, consulte o Guia do desenvolvedor.

serialNumber

string

O número de série do dispositivo.

imei

string

O número IMEI do dispositivo.

meid

string

O número MEID do dispositivo.

wifiMacAddress

string

O endereço MAC do dispositivo em redes Wi-Fi.

networkOperator

string

Dispositivo móvel móvel ou operadora de rede (se disponível) (somente leitura)

defaultLanguage

string

A localidade padrão usada no dispositivo.

managedAccountIsOnOwnerProfile

boolean

Booleano que indica se a conta está ou não no perfil de proprietário/principal.

deviceCompromisedStatus

string

O status do dispositivo comprometido.

buildNumber

string

O número da versão do sistema operacional do dispositivo.

kernelVersion

string

A versão do kernel do dispositivo.

basebandVersion

string

A versão da banda de base do dispositivo.

unknownSourcesStatus

boolean

Fontes desconhecidas ativadas ou desativadas no dispositivo (somente leitura)

developerOptionsStatus

boolean

Opções do desenvolvedor ativadas ou desativadas no dispositivo (somente leitura)

otherAccountsInfo[]

string

A lista de contas adicionadas ao dispositivo (somente leitura)

adbStatus

boolean

Adb (depuração USB) ativada ou desativada no dispositivo (somente leitura)

supportsWorkProfile

boolean

Perfil de trabalho compatível com o dispositivo (somente leitura)

manufacturer

string

Fabricante do dispositivo móvel (somente leitura)

releaseVersion

string

Versão de lançamento do dispositivo móvel (somente leitura)

securityPatchLevel

string (int64 format)

Nível do patch de segurança do dispositivo móvel (somente leitura)

brand

string

Marca do dispositivo móvel (somente leitura)

bootloaderVersion

string

Versão do carregador de inicialização do dispositivo móvel (somente leitura)

hardware

string

Hardware de dispositivo móvel (somente leitura)

encryptionStatus

string

Status de criptografia do dispositivo móvel (somente leitura)

devicePasswordStatus

string

DevicePasswordStatus (somente leitura)

privilege

string

DMAgentPermission (somente leitura)

applications[]

object

A lista de aplicativos instalados em um dispositivo móvel Android. Ela não se aplica ao Google Sync e aos dispositivos iOS. Ela inclui todos os apps Android que acessam os dados do Google Workspace.

Ao atualizar uma lista de aplicativos, é importante observar que as atualizações substituem a lista existente. Se o dispositivo Android tiver dois aplicativos existentes e a API atualizar a lista com cinco aplicativos, a lista dos cinco aplicativos será atualizada.

applications[].packageName

string

O nome do pacote do aplicativo. Um exemplo é com.android.browser.

applications[].displayName

string

O nome de exibição do aplicativo. Um exemplo é Browser.

applications[].versionName

string

O nome da versão do aplicativo. Um exemplo é 3.2-140714.

applications[].versionCode

integer

O código da versão do aplicativo. Um exemplo é 13.

applications[].permission[]

string

A lista de permissões deste aplicativo. Elas podem ser uma permissão padrão do Android ou uma definida pelo app e são encontradas no manifesto do Android de um app. Exemplos de permissões do aplicativo Agenda são READ_CALENDAR ou MANAGE_ACCOUNTS.

Métodos

action

realiza uma ação que afeta um dispositivo móvel.

delete

Remove um dispositivo móvel.

get

Recupera as propriedades de um dispositivo móvel.

list

Recupera uma lista paginada de todos os dispositivos móveis de usuários de uma conta.