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 tarefas comuns de grupo de API 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 de dispositivos móveis, 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. Se o app precisar da lista atual de nomes de proprietários de dispositivos, use o método get. Para saber mais sobre como recuperar informações do usuário do dispositivo móvel, consulte o Guia do desenvolvedor.

email[]

string

A lista de endereços de e-mail do proprietário. Se o aplicativo precisar 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 saber mais, consulte o Guia para desenvolvedores.

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 saber mais, consulte o Guia para desenvolvedores.

type

string

O tipo de dispositivo móvel.

status

string

O status do dispositivo.

hardwareId

string

O identificador exclusivo IMEI/MEID para hardware Android. Ele não é aplicável a dispositivos com o Google Sync. Essa é uma propriedade opcional ao adicionar um dispositivo móvel Android. Ao atualizar um desses dispositivos, essa é uma propriedade somente leitura.

firstSync

string

A data e a hora em que o dispositivo foi sincronizado inicialmente com as configurações de 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 da última sincronização do dispositivo com as configurações de 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 saber mais, consulte o Guia para desenvolvedores.

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

Operadora de rede ou de dispositivo móvel (se disponível) (somente leitura)

defaultLanguage

string

A localidade padrão usada no dispositivo.

managedAccountIsOnOwnerProfile

boolean

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

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 dispositivos móveis (somente leitura)

encryptionStatus

string

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

devicePasswordStatus

string

DevicePasswordStatus (somente leitura)

privilege

string

DMAgentPermission (somente leitura)

applications[]

object

Lista de apps instalados em um dispositivo móvel Android. Ela não se aplica ao Google Sync e aos dispositivos iOS. A lista inclui todos os aplicativos Android que acessam 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 e a API atualizar a lista com cinco aplicativos, essa será a lista atualizada de cinco aplicativos.

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 app. Elas podem ser uma permissão padrão do Android ou definida pelo aplicativo e são encontradas no manifesto 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 um usuário de uma conta.