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 |
El ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, 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 |
Es la propiedad del dispositivo que se usa para ordenar los resultados. |
pageToken |
Token para especificar la página siguiente en la lista |
projection |
Restringe la información que se muestra a un conjunto de campos seleccionados. |
query |
Cadena de búsqueda en el formato que se proporciona en https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
Indica si se deben mostrar los resultados en orden ascendente o descendente. Se debe usar 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 un tipo de recurso. |
etag |
ETag del recurso. |
mobiledevices[] |
Una lista de objetos de dispositivos móviles. |
nextPageToken |
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. |