REST Resource: mobiledevices

Recurso: MobileDevice

La Administración de dispositivos móviles de Google Workspace incluye dispositivos Android, iOS y Google Sync. Para obtener más información sobre las tareas comunes de la API de grupos para dispositivos móviles, consulta la Guía para desarrolladores.

Representación 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

Tipo de recurso de la API. Para los recursos de dispositivos móviles, el valor es admin#directory#mobiledevice.

etag

string

ETag del recurso.

resourceId

string

El ID único que utiliza el servicio de API para identificar el dispositivo móvil.

deviceId

string

El número de serie de un dispositivo móvil de Google Sync. Para dispositivos iOS y Android, se trata de un identificador único generado por software.

name[]

string

La lista de los nombres de usuario del propietario. Si tu aplicación necesita la lista actual de nombres de propietarios de dispositivos, usa el método get. Para obtener más información sobre cómo recuperar la información del usuario de dispositivos móviles, consulte la Guía para desarrolladores.

email[]

string

La lista de direcciones de correo electrónico del propietario. Si tu aplicación necesita la lista actual de correos electrónicos de usuarios, usa el método get. Si deseas obtener información adicional, consulta el método para recuperar un usuario.

model

string

El nombre del modelo del dispositivo móvil, por ejemplo, Nexus S. Esta propiedad se puede actualizar. Si deseas obtener más información, consulta la Guía para desarrolladores.

os

string

El sistema operativo del dispositivo móvil, por ejemplo, iOS 4.3 o Android 2.3.5. Esta propiedad se puede actualizar. Si deseas obtener más información, consulta la Guía para desarrolladores.

type

string

Indica el tipo de dispositivo móvil.

status

string

Estado del dispositivo.

hardwareId

string

Es el identificador único IMEI/MEID para hardware de Android. No se aplica a los dispositivos de Google Sync. Cuando se agrega un dispositivo móvil Android, esta es una propiedad opcional. Cuando actualizas uno de estos dispositivos, esta es una propiedad de solo lectura.

firstSync

string

Fecha y hora en que el dispositivo se sincronizó inicialmente con la configuración de la política en la Consola del administrador. El valor debe estar en el formato de fecha y hora ISO 8601. La hora es la fecha completa más las horas, los minutos y los segundos en el formato <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Por ejemplo, 2010-04-05T17:30:04+01:00.

lastSync

string

Fecha y hora en que el dispositivo se sincronizó por última vez con la configuración de la política en la Consola del administrador. El valor debe estar en el formato de fecha y hora ISO 8601. La hora es la fecha completa más las horas, los minutos y los segundos en el formato <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Por ejemplo, 2010-04-05T17:30:04+01:00.

userAgent

string

Brinda información sobre el dispositivo, como la versión de os. Esta propiedad se puede actualizar. Si deseas obtener más información, consulta la Guía para desarrolladores.

serialNumber

string

El número de serie del dispositivo.

imei

string

El número IMEI del dispositivo

meid

string

Es el número MEID del dispositivo.

wifiMacAddress

string

Es la dirección MAC del dispositivo en redes Wi-Fi.

networkOperator

string

Operador de red o de telefonía celular del dispositivo móvil (si está disponible) (solo lectura)

defaultLanguage

string

La configuración regional predeterminada que se usa en el dispositivo.

managedAccountIsOnOwnerProfile

boolean

Es un valor booleano que indica si esta cuenta está en el perfil principal o de propietario.

deviceCompromisedStatus

string

El estado del dispositivo vulnerado.

buildNumber

string

El número de compilación del sistema operativo del dispositivo.

kernelVersion

string

La versión de kernel del dispositivo.

basebandVersion

string

La versión de banda base del dispositivo.

unknownSourcesStatus

boolean

Fuentes desconocidas habilitadas o inhabilitadas en el dispositivo (solo lectura)

developerOptionsStatus

boolean

Opciones para desarrolladores habilitadas o inhabilitadas en el dispositivo (solo lectura)

otherAccountsInfo[]

string

La lista de cuentas agregadas al dispositivo (solo lectura)

adbStatus

boolean

adb (depuración por USB) habilitado o inhabilitado en el dispositivo (solo lectura)

supportsWorkProfile

boolean

Perfil de trabajo compatible con el dispositivo (solo lectura)

manufacturer

string

Fabricante del dispositivo móvil (solo lectura)

releaseVersion

string

Versión de actualización para dispositivos móviles (solo lectura)

securityPatchLevel

string (int64 format)

Nivel de parche de seguridad de dispositivos móviles (solo lectura)

brand

string

Marca del dispositivo móvil (solo lectura)

bootloaderVersion

string

Versión del bootloader del dispositivo móvil (solo lectura)

hardware

string

Hardware del dispositivo móvil (solo lectura)

encryptionStatus

string

Estado de encriptación del dispositivo móvil (solo lectura)

devicePasswordStatus

string

DevicePasswordStatus (solo lectura)

privilege

string

DMAgentPermission (solo lectura)

applications[]

object

Es la lista de aplicaciones instaladas en un dispositivo móvil Android. No se aplica a Google Sync ni a dispositivos iOS. La lista incluye todas las aplicaciones para Android que acceden a datos de Google Workspace.

Al actualizar una lista de aplicaciones, es importante tener en cuenta que las actualizaciones reemplazan la lista existente. Si el dispositivo Android tiene dos aplicaciones existentes y la API actualiza la lista con cinco aplicaciones, ahora será la lista actualizada de las cinco aplicaciones.

applications[].packageName

string

El nombre del paquete de la aplicación. Un ejemplo es com.android.browser.

applications[].displayName

string

El nombre visible de la aplicación. Un ejemplo es Browser.

applications[].versionName

string

El nombre de la versión de la aplicación. Un ejemplo es 3.2-140714.

applications[].versionCode

integer

El código de versión de la aplicación. Un ejemplo es 13.

applications[].permission[]

string

La lista de permisos de esta aplicación. Pueden ser un permiso estándar de Android o uno definido por la aplicación, y se encuentran en el manifiesto de Android de una aplicación. Algunos ejemplos de permisos de una app de Calendario son READ_CALENDAR o MANAGE_ACCOUNTS.

Métodos

action

Realiza una acción que afecta a un dispositivo móvil.

delete

Quita un dispositivo móvil.

get

Recupera las propiedades de un dispositivo móvil.

list

Recupera una lista paginada de todos los dispositivos móviles que son propiedad del usuario de una cuenta.