Method: mobiledevices.list

Recupera una lista paginada de todos los dispositivos móviles que pertenecen al usuario de una cuenta. Para recuperar una lista que incluya dispositivos propiedad de la empresa, usa la API de Devices de Cloud Identity. Este método se agota después de 60 minutos. Para obtener más información, consulta Soluciona problemas relacionados con códigos de error.

Solicitud HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

El ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, también puedes usar el alias my_customer para representar el customerId de tu cuenta. El customerId también se muestra como parte del recurso Usuarios.

Parámetros de consulta

Parámetros
maxResults

integer

Cantidad máxima de resultados que se mostrarán. El valor máximo permitido es 100.
orderBy

enum (OrderBy)

Es la propiedad del dispositivo que se usará para ordenar los resultados.
pageToken

string

Token para especificar la página siguiente en la lista
projection

enum (Projection)

Restringe la información que se devuelve a un conjunto de campos seleccionados.
query

string

Cadena de búsqueda con el formato que se indica en https://developers.google.com/workspace/admin/directory/v1/search-operators
sortOrder

enum (SortOrder)

Si se devuelven resultados en orden ascendente o descendente. Se debe usar con el parámetro orderBy.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Indica el tipo de recurso.
etag

string

ETag del recurso.
mobiledevices[]

object (MobileDevice)

Es una lista de objetos de dispositivos móviles.
nextPageToken

string

Es el token que se usa para acceder a la siguiente página de este resultado.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

Para obtener más información, consulta la Guía de autorización.

OrderBy

Enumeraciones
DEVICE_ID Es el número de serie de un dispositivo móvil con Google Sync. En el caso de los dispositivos Android, este es un identificador único generado por software.
EMAIL La dirección de correo electrónico del propietario del dispositivo
LAST_SYNC Es la fecha y hora de la última sincronización de la configuración de la política del dispositivo.
MODEL Es el modelo del dispositivo móvil.
NAME Es el nombre de usuario del propietario del dispositivo.
OS El sistema operativo del dispositivo
STATUS El estado del dispositivo.
TYPE Tipo del dispositivo.

Proyección

Enumeraciones
BASIC Solo incluye los campos de metadatos básicos (p. ej., deviceId, model, status, type y status).
FULL Incluye todos los campos de metadatos

SortOrder

Enumeraciones
ASCENDING Orden ascendente.
DESCENDING Orden descendente.