REST Resource: mobiledevices

Recurso: MobileDevice

La Administración de dispositivos móviles de Google Workspace incluye dispositivos Android, Google Sync y iOS. Para obtener más información sobre las tareas comunes de la API de dispositivos móviles del grupo, 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

Es el ID único que usa el servicio de la API para identificar el dispositivo móvil.

deviceId

string

Es el número de serie de un dispositivo móvil con Google Sync. En el caso de los dispositivos iOS y Android, este es 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 del dispositivo, usa el método get. Para obtener más información sobre cómo recuperar la información del usuario de dispositivos móviles, consulta la Guía para desarrolladores.

email[]

string

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

model

string

Indica el nombre del modelo del dispositivo móvil, por ejemplo, Nexus S. Esta propiedad se puede actualizar. Para 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. Para obtener más información, consulta la Guía para desarrolladores.

type

string

Es el tipo de dispositivo móvil.

status

string

El 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 agregas 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 está en formato de fecha y hora ISO 8601. La hora es la fecha completa más horas, minutos y 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

Indica la fecha y hora en que se sincronizó el dispositivo por última vez con la configuración de la política en la Consola del administrador. El valor está en 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. Para 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

La dirección MAC del dispositivo en redes Wi-Fi

networkOperator

string

Operador de red o red móvil del dispositivo móvil (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 esta cuenta está en el perfil del propietario o principal.

deviceCompromisedStatus

string

El estado del dispositivo comprometido.

buildNumber

string

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

kernelVersion

string

Es la versión del 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

El perfil de trabajo es 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 la encriptación de dispositivos móviles (de 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 los datos de Google Workspace.

Cuando se actualiza 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

Es 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

Es 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 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 de una cuenta.