Recupera una lista paginada de dispositivos con Chrome OS en 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 |
orderBy |
Propiedad del dispositivo que se usará para ordenar los resultados. |
orgUnitPath |
Es la ruta de acceso completa de la unidad organizativa (menos la |
pageToken |
El parámetro de búsqueda |
projection |
Restringe la información que se muestra a un conjunto de campos seleccionados. |
query |
La string de búsqueda en el formato proporcionado en https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
Indica si se muestran resultados en orden ascendente o descendente. Se debe usar con el parámetro |
includeChildOrgunits |
Muestra dispositivos de todas las unidades organizativas secundarias, así como de la unidad organizativa especificada. Si se establece como verdadera, se debe proporcionar &33;orgUnitPath'. |
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 |
Es un recurso. |
etag |
ETag del recurso. |
chromeosdevices[] |
Una lista de objetos de dispositivos con Sistema operativo Chrome. |
nextPageToken |
El token que se usa 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 la autorización
Se necesita uno de los siguientes alcances 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 Descripción general de OAuth 2.0.
OrderBy
Enumeradores | |
---|---|
ANNOTATED_LOCATION |
Ubicación del dispositivo Chrome anotada por el administrador. |
ANNOTATED_USER |
Usuario de Chromebook anotado por el administrador. |
LAST_SYNC |
La fecha y hora en que se sincronizó por última vez el dispositivo Chrome con la configuración de políticas de la Consola del administrador. |
NOTES |
El dispositivo Chrome anota las notas tal como las anotó el administrador. |
SERIAL_NUMBER |
Es 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 la sección <a chromeosdevices. |
Proyección
Es el tipo de proyección que se mostrará para los dispositivos.
Enumeradores | |
---|---|
BASIC |
Incluye solo los campos de metadatos básicos (p. ej., deviceId, número de serie, estado y usuario). |
FULL |
Incluye todos los campos de metadatos |
SortOrder
El orden de clasificación que debe aplicarse a la lista de dispositivos.
Enumeradores | |
---|---|
ASCENDING |
Orden ascendente |
DESCENDING |
Orden descendente. |