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 |
El ID único de la cuenta de Google Workspace del cliente. Como administrador de cuentas, también puedes usar el alias |
Parámetros de consulta
Parámetros | |
---|---|
maxResults |
Cantidad máxima de resultados que se mostrarán El valor máximo permitido es 100. |
orderBy |
Propiedad del dispositivo que se usa para ordenar los resultados. |
pageToken |
Token para especificar la página siguiente de la lista |
projection |
Restringe la información que se muestra a un conjunto de campos seleccionados. |
query |
Cadena de búsqueda en el formato proporcionado en https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
Indica si se deben mostrar los resultados en orden ascendente o descendente. Debe usarse con el parámetro |
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 ( |
Campos | |
---|---|
kind |
Este es el tipo de recurso. |
etag |
ETag del recurso. |
mobiledevices[] |
Es una lista de objetos de dispositivos móviles. |
nextPageToken |
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. |