REST Resource: mobiledevices

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 dispositivos móviles para grupos, consulta la Guía para programadores.

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 el servicio de API usa 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, este es un identificador único generado por software.

name[]

string

La lista de 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 información de usuarios de dispositivos móviles, consulta la Guía para programadores.

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 más información, 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. 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

Indica el tipo de dispositivo móvil.

status

string

El estado del dispositivo.

hardwareId

string

El identificador único IMEI/MEID para el 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

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

lastSync

string

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

userAgent

string

Proporciona información sobre el dispositivo, como la versión 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

El número MEID del dispositivo.

wifiMacAddress

string

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

networkOperator

string

Operador de red o dispositivo móvil (si está disponible) (solo lectura)

defaultLanguage

string

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

managedAccountIsOnOwnerProfile

boolean

Booleano que indica si esta cuenta está en el perfil de propietario o principal.

deviceCompromisedStatus

string

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 en el dispositivo (solo lectura)

adbStatus

boolean

Se habilitó o inhabilitó la conexión de ADB (depuración por USB) en el dispositivo (solo lectura)

supportsWorkProfile

boolean

Perfil de trabajo compatible con el dispositivo (solo lectura)

manufacturer

string

Fabricante de dispositivos móviles (solo lectura)

releaseVersion

string

Versión de la versión de actualización del dispositivo móvil (solo lectura)

securityPatchLevel

string (int64 format)

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

brand

string

Marca de 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 de dispositivos móviles (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 ya tiene dos aplicaciones y la API actualiza la lista con cinco aplicaciones, ahora 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

La lista de permisos de esta aplicación. Puede tratarse de un permiso estándar de Android o uno definido por la aplicación, que 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 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 pertenecen al usuario para una cuenta.