Method: mobiledevices.list

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Recupera una lista paginada de todos los dispositivos móviles que pertenecen al usuario para una cuenta. Para recuperar una lista que incluya dispositivos que pertenezcan a la empresa, use la API de dispositivos de Cloud Identity. Este método agota el tiempo de espera después de 60 minutos. Para obtener más información, consulta Cómo solucionar problemas 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 puede usar el alias my_customer para representar la customerId de su cuenta. El customerId también se muestra como parte del recurso Users.

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 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 muestra a un conjunto de campos seleccionados.

query

string

String de búsqueda con el formato que se proporciona en https://developers.google.com/admin-sdk/directory/v1/search-operators

sortOrder

enum (SortOrder)

Indica si se muestran 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

Es un recurso.

etag

string

ETag del recurso.

mobiledevices[]

object (MobileDevice)

Una lista de objetos para dispositivos móviles.

nextPageToken

string

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

Alcances de la 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 Descripción general de OAuth 2.0.

OrderBy

Enumeradores
DEVICE_ID El número de serie de un dispositivo móvil de 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 última configuración de política sincroniza la fecha y hora del dispositivo.
MODEL Indica el modelo del dispositivo móvil.
NAME 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

Enumeradores
BASIC Incluye solo los campos de metadatos básicos (p. ej., deviceId, modelo, estado, tipo y estado).
FULL Incluye todos los campos de metadatos

SortOrder

Enumeradores
ASCENDING Orden ascendente
DESCENDING Orden descendente.