REST Resource: mobiledevices

Recurso: MobileDevice

La Administración de dispositivos móviles de Google Workspace incluye dispositivos iOS, Android y Google Sync. Para obtener más información sobre las tareas comunes de la API de grupos de 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. En el caso de los recursos para dispositivos móviles, el valor es admin#directory#mobiledevice.

etag

string

ETag del recurso.

resourceId

string

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

deviceId

string

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

name[]

string

Es 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 de usuario de dispositivos móviles, consulta 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 los usuarios, usa el método get. Para obtener información adicional, consulta el método recuperar un usuario.

model

string

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

lastSync

string

La 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 está en el formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y segundos en el formulario <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Por ejemplo, 2010-04-05T17:30:04+01:00.

userAgent

string

Proporciona 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

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 red móvil de dispositivos móviles (si está disponible) (solo lectura)

defaultLanguage

string

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

managedAccountIsOnOwnerProfile

boolean

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

deviceCompromisedStatus

string

El estado del dispositivo comprometido.

buildNumber

string

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

kernelVersion

string

La versión de kernel del dispositivo.

basebandVersion

string

Es la versión de banda base del dispositivo.

unknownSourcesStatus

boolean

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

developerOptionsStatus

boolean

Habilitar o inhabilitar las opciones para desarrolladores en el dispositivo (solo lectura)

otherAccountsInfo[]

string

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 del dispositivo móvil (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 de dispositivos móviles (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.

Cuando actualizas 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, la lista es la lista actualizada de 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

Es 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 la aplicación. Algunos ejemplos de los permisos de una aplicación de Calendario son READ_CALENDAR o MANAGE_ACCOUNTS.

Métodos

action

Realiza una acción que afecta al 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 pertenecen al usuario para una cuenta.