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 da API para dispositivos móveis em grupos, 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, esse é 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 saber mais 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 de usuários, use o método get. Para saber mais, 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 do IMEI/MEID do hardware Android. Ela não é aplicável a dispositivos Google Sync. Ao adicionar um dispositivo móvel Android, essa é uma propriedade opcional. Ao atualizar um desses dispositivos, esta é uma propriedade somente leitura.

firstSync

string

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 da última sincronização do dispositivo 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, por exemplo, 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 nas redes Wi-Fi.

networkOperator

string

Operadora de rede móvel ou 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á ou não no perfil de proprietário/principal.

deviceCompromisedStatus

string

Status do dispositivo comprometido.

buildNumber

string

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

Lista de contas adicionadas ao dispositivo (somente leitura)

adbStatus

boolean

Adb (depuração USB) ativado ou desativado 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 é aplicável aos dispositivos Google Sync e iOS. Ela inclui todos os apps Android que acessam os dados do Google Workspace.

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

applications[].packageName

string

O nome do pacote do aplicativo. Por exemplo, com.android.browser.

applications[].displayName

string

O nome de exibição do aplicativo. Por exemplo, Browser.

applications[].versionName

string

O nome da versão do aplicativo. Por exemplo, 3.2-140714.

applications[].versionCode

integer

O código da versão do aplicativo. Por exemplo, 13.

applications[].permission[]

string

A lista de permissões do aplicativo. Ela pode ser uma permissão padrão do Android ou definida pelo aplicativo e é encontrada no manifesto do Android. Os exemplos de permissões de um aplicativo do Google Agenda são READ_CALENDAR ou MANAGE_ACCOUNTS.

Métodos

action

Faz 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 do usuário em uma conta.