Method: mobiledevices.list

Recupera una lista paginada de todos los dispositivos móviles que pertenecen al usuario para una cuenta. Para recuperar una lista que incluye los dispositivos de la empresa, usa la API de Devices de Cloud Identity. Se agota el tiempo de espera de este método 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 la cuenta, también puedes usar el alias my_customer para representar el customerId de tu cuenta. customerId también se muestra como parte del Recurso de 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 usa 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 muestra a un conjunto de campos seleccionados.

query

string

Cadena de búsqueda en el formato que se proporciona 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. 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

Este es un tipo de recurso.

etag

string

ETag del recurso.

mobiledevices[]

object (MobileDevice)

Una lista de objetos de dispositivos móviles.

nextPageToken

string

Token utilizado para acceder a la página siguiente de este resultado.

Alcances 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 El número de serie de un dispositivo móvil con Google Sync. Para dispositivos Android, es un identificador único generado por software.
EMAIL La dirección de correo electrónico del propietario del dispositivo
LAST_SYNC La fecha y hora de sincronización del dispositivo de la última configuración de política.
MODEL Indica el modelo del dispositivo móvil.
NAME Indica 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 Incluye solo 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.