Method: chromeosdevices.list

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

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

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 tu customerId. 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

orderBy

enum (OrderBy)

Propiedad del dispositivo que se usará para ordenar los resultados.

orgUnitPath

string

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

pageToken

string

El parámetro de búsqueda pageToken se usa para solicitar la página siguiente 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)

Restringe la información que se muestra a un conjunto de campos seleccionados.

query

string

La string de búsqueda en el formato proporcionado en https://developers.google.com/admin-sdk/directory/v1/list-query-operators

sortOrder

enum (SortOrder)

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

includeChildOrgunits

boolean

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&#39.

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

Es un recurso.

etag

string

ETag del recurso.

chromeosdevices[]

object (ChromeOsDevice)

Una lista de objetos de dispositivos con Sistema operativo Chrome.

nextPageToken

string

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 pageToken de esta solicitud.

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.