Method: mobiledevices.list

Recupera una lista paginada de todos los dispositivos móviles que son propiedad del usuario de una cuenta. Para recuperar una lista que incluya dispositivos que pertenecen a la empresa, usa la API de dispositivos de Cloud Identity. Con este método, se agota el tiempo de espera después de 60 minutos. Para obtener más información, consulta Cómo solucionar 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 cuentas, también puedes usar el alias my_customer para representar el customerId de tu cuenta. También se muestra customerId 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)

Propiedad del dispositivo que se usa para ordenar los resultados.

pageToken

string

Token para especificar la página siguiente de la lista

projection

enum (Projection)

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

query

string

Cadena de búsqueda en el formato proporcionado en https://developers.google.com/admin-sdk/directory/v1/search-operators

sortOrder

enum (SortOrder)

Indica si se deben mostrar los resultados en orden ascendente o descendente. Debe usarse 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

Este es el tipo de recurso.

etag

string

ETag del recurso.

mobiledevices[]

object (MobileDevice)

Es una lista de objetos de dispositivos móviles.

nextPageToken

string

El token se usa para acceder a la página siguiente de este resultado.

Permisos de autorización

Se necesita uno de los siguientes alcances 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

Enumeradores
DEVICE_ID El número de serie de un dispositivo móvil de Google Sync. Para dispositivos Android, se trata de un identificador único generado por software.
EMAIL La dirección de correo electrónico del propietario del dispositivo.
LAST_SYNC Fecha y hora de la última sincronización de la política del dispositivo.
MODEL Es el modelo del dispositivo móvil.
NAME El nombre de usuario del propietario del dispositivo.
OS El sistema operativo del dispositivo.
STATUS Es el estado del dispositivo.
TYPE Tipo del dispositivo.

Proyección

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

SortOrder

Enumeradores
ASCENDING Orden ascendente.
DESCENDING Orden descendente.