Method: chromeosdevices.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera un elenco paginato dei dispositivi ChromeOS all'interno di un account.
Richiesta HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
customerId |
string
L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare il customerId del tuo account. customerId viene restituito anche all'interno della risorsa Utenti.
|
Parametri di query
| Parametri |
maxResults |
integer
Il numero massimo di risultati da restituire. Il valore non deve superare 300.
|
orderBy |
enum (OrderBy)
Proprietà del dispositivo da utilizzare per ordinare i risultati.
|
orgUnitPath |
string
Il percorso completo dell'unità organizzativa (meno il carattere iniziale /) o il suo ID univoco.
|
pageToken |
string
Il parametro di query pageToken viene utilizzato per richiedere la pagina successiva dei risultati della query. Il parametro di query pageToken della richiesta successiva è nextPageToken della tua risposta precedente.
|
projection |
enum (Projection)
Determina se la risposta deve includere l'elenco completo delle proprietà o solo un sottoinsieme.
|
query |
string
Stringa di ricerca nel formato indicato all'indirizzo https://developers.google.com/workspace/admin/directory/v1/list-query-operators
|
sortOrder |
enum (SortOrder)
Indica se i risultati devono essere restituiti in ordine crescente o decrescente. Deve essere utilizzato con il parametro orderBy.
|
includeChildOrgunits |
boolean
Restituisce i dispositivi di tutte le unità organizzative secondarie, nonché dell'unità organizzativa specificata. Se questo valore è impostato su true, è necessario fornire "orgUnitPath".
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"kind": string,
"etag": string,
"chromeosdevices": [
{
object (ChromeOsDevice)
}
],
"nextPageToken": string
} |
| Campi |
kind |
string
Il tipo di risorsa.
|
etag |
string
ETag della risorsa.
|
chromeosdevices[] |
object (ChromeOsDevice)
Un elenco di oggetti Dispositivo ChromeOS.
|
nextPageToken |
string
Token utilizzato per accedere alla pagina successiva di questo risultato. Per accedere alla pagina successiva, utilizza il valore di questo token nella stringa di query pageToken di questa richiesta.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/admin.directory.device.chromeos
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
OrderBy
| Enum |
ANNOTATED_LOCATION |
La posizione del dispositivo Chrome in base a quanto annotato dall'amministratore. |
ANNOTATED_USER |
Utente del Chromebook in base a quanto annotato dall'amministratore. |
LAST_SYNC |
La data e l'ora in cui il dispositivo Chrome è stato sincronizzato l'ultima volta con le impostazioni dei criteri nella Console di amministrazione. |
NOTES |
Note del dispositivo Chrome in base a quanto annotato dall'amministratore. |
SERIAL_NUMBER |
Il numero di serie del dispositivo Chrome inserito al momento dell'attivazione del dispositivo. |
STATUS |
Stato del dispositivo Chrome. Per ulteriori informazioni, consulta <a chromeosdevices. |
Projection
Il tipo di proiezione da mostrare per i dispositivi.
| Enum |
BASIC |
Sono inclusi solo i campi dei metadati di base (ad es. deviceId, serialNumber, status e user) |
FULL |
Include tutti i campi dei metadati |
SortOrder
L'ordine di ordinamento da applicare all'elenco di dispositivi.
| Enum |
ASCENDING |
Ordine crescente. |
DESCENDING |
Ordine decrescente. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: chromeosdevices.list\n\nRetrieves a paginated list of Chrome OS devices within an account.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). |\n\n### Query parameters\n\n| Parameters ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of results to return. Value should not exceed 300. |\n| `orderBy` | `enum (`[OrderBy](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#OrderBy)`)` Device property to use for sorting results. |\n| `orgUnitPath` | `string` The full path of the organizational unit (minus the leading `/`) or its unique ID. |\n| `pageToken` | `string` The `pageToken` query parameter is used to request the next page of query results. The follow-on request's `pageToken` query parameter is the `nextPageToken` from your previous response. |\n| `projection` | `enum (`[Projection](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#Projection)`)` Determines whether the response contains the full list of properties or only a subset. |\n| `query` | `string` Search string in the format given at \u003chttps://developers.google.com/workspace/admin/directory/v1/list-query-operators\u003e |\n| `sortOrder` | `enum (`[SortOrder](/workspace/admin/directory/reference/rest/v1/chromeosdevices/list#SortOrder)`)` Whether to return results in ascending or descending order. Must be used with the `orderBy` parameter. |\n| `includeChildOrgunits` | `boolean` Return devices from all child orgunits, as well as the specified org unit. If this is set to true, 'orgUnitPath' must be provided. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"chromeosdevices\": [ { object (/workspace/admin/directory/reference/rest/v1/chromeosdevices#ChromeOsDevice) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Kind of resource this is. |\n| `etag` | `string` ETag of the resource. |\n| `chromeosdevices[]` | `object (`[ChromeOsDevice](/workspace/admin/directory/reference/rest/v1/chromeosdevices#ChromeOsDevice)`)` A list of Chrome OS Device objects. |\n| `nextPageToken` | `string` Token used to access the next page of this result. To access the next page, use this token's value in the `pageToken` query string of this request. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.directory.device.chromeos`\n- `\n https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nOrderBy\n-------\n\n| Enums ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ANNOTATED_LOCATION` | Chrome device location as annotated by the administrator. |\n| `ANNOTATED_USER` | Chromebook user as annotated by administrator. |\n| `LAST_SYNC` | The date and time the Chrome device was last synchronized with the policy settings in the Admin console. |\n| `NOTES` | Chrome device notes as annotated by the administrator. |\n| `SERIAL_NUMBER` | The Chrome device serial number entered when the device was enabled. |\n| `STATUS` | Chrome device status. For more information, see the \\\u003ca [chromeosdevices](https://developers.google.com/workspace/admin/directory/v1/reference/chromeosdevices.html). |\n\nProjection\n----------\n\nThe type of projection to show for the devices.\n\n| Enums ||\n|---------|------------------------------------------------------------------------------------------|\n| `BASIC` | Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) |\n| `FULL` | Includes all metadata fields |\n\nSortOrder\n---------\n\nThe sorting order that should be applied to the device list.\n\n| Enums ||\n|--------------|-------------------|\n| `ASCENDING` | Ascending order. |\n| `DESCENDING` | Descending order. |"]]
