Method: chromeosdevices.list

Recupera una lista paginada de los dispositivos con Chrome OS de una cuenta.

Solicitud HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

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 no debe ser superior a 300.

orderBy

enum (OrderBy)

Es la propiedad del dispositivo que se usa para ordenar los resultados.

orgUnitPath

string

La ruta completa de la unidad organizativa (menos el / inicial) o su ID único.

pageToken

string

El parámetro de consulta pageToken se usa para solicitar la siguiente página de resultados de la consulta. El parámetro de consulta pageToken de la solicitud de seguimiento es el nextPageToken de tu respuesta anterior.

projection

enum (Projection)

Determina si la respuesta contiene la lista completa de propiedades o solo un subconjunto.

query

string

Cadena de búsqueda en el formato que se proporciona en https://developers.google.com/admin-sdk/directory/v1/list-query-operators

sortOrder

enum (SortOrder)

Indica si se deben mostrar los resultados en orden ascendente o descendente. Se debe usar con el parámetro orderBy.

includeChildOrgunits

boolean

Devuelve dispositivos de todas las unidades organizativas secundarias, así como de la unidad organizativa especificada. Si se establece como true, 'orgUnitPath' debe proporcionarse.

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,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Este es un tipo de recurso.

etag

string

ETag del recurso.

chromeosdevices[]

object (ChromeOsDevice)

Una lista de objetos de los dispositivos con ChromeOS.

nextPageToken

string

Token utilizado para acceder a la siguiente página de este resultado. Para acceder a la página siguiente, usa el valor de este token en la cadena de consulta pageToken de esta solicitud.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

Para obtener más información, consulta la Guía de autorización.

OrderBy

Enumeraciones
ANNOTATED_LOCATION Ubicación del dispositivo Chrome según las anotaciones del administrador.
ANNOTATED_USER Usuario de Chromebook tal como lo anotó el administrador.
LAST_SYNC La fecha y hora en que el dispositivo Chrome se sincronizó por última vez con la configuración de la política en la Consola del administrador.
NOTES Notas del dispositivo Chrome según las anotaciones del administrador.
SERIAL_NUMBER El número de serie del dispositivo Chrome que se ingresó cuando se habilitó el dispositivo.
STATUS Estado del dispositivo Chrome. Para obtener más información, consulta los <a chromeosdevices.

Proyección

Es el tipo de proyección que se mostrará para los dispositivos.

Enumeraciones
BASIC Incluye solo los campos de metadatos básicos (p.ej., deviceId, serialNumber, status y user)
FULL Incluye todos los campos de metadatos

SortOrder

El orden de clasificación que se debe aplicar a la lista de dispositivos.

Enumeraciones
ASCENDING Orden ascendente.
DESCENDING Orden descendente.