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 |
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 no debe ser superior a 300. |
orderBy |
Es la propiedad del dispositivo que se usa para ordenar los resultados. |
orgUnitPath |
La ruta completa de la unidad organizativa (menos el |
pageToken |
El parámetro de consulta |
projection |
Determina si la respuesta contiene la lista completa de propiedades o solo un subconjunto. |
query |
Cadena de búsqueda en el formato que se proporciona en https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Indica si se deben mostrar los resultados en orden ascendente o descendente. Se debe usar con el parámetro |
includeChildOrgunits |
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 ( |
Campos | |
---|---|
kind |
Este es un tipo de recurso. |
etag |
ETag del recurso. |
chromeosdevices[] |
Una lista de objetos de los dispositivos con ChromeOS. |
nextPageToken |
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 |
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. |