Method: enterprises.devices.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca i dispositivi di una determinata azienda. I dispositivi eliminati non vengono restituiti nella risposta.
Richiesta HTTP
GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Il nome dell'azienda nel formato enterprises/{enterpriseId}.
|
Parametri di query
| Parametri |
pageSize |
integer
Le dimensioni della pagina richieste. Le dimensioni effettive della pagina possono essere fissate a un valore minimo o massimo.
|
pageToken |
string
Un token che identifica una pagina di risultati restituita dal server.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta a una richiesta di elenco dei dispositivi per una determinata azienda.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string
} |
| Campi |
devices[] |
object (Device)
L'elenco dei dispositivi.
|
nextPageToken |
string
Se sono presenti altri risultati, un token per recuperare la pagina successiva dei risultati.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidmanagement
Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
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-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eLists all devices for a given enterprise, excluding deleted ones.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eGET\u003c/code\u003e request to the specified URL with \u003ccode\u003eenterpriseId\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving results.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of devices and a token for the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to list devices for an enterprise using a `GET` request to the specified URL. The request uses path parameter `parent` (enterprise name) and optional query parameters `pageSize` and `pageToken` for pagination. The request body should be empty. The successful response body contains a list of `devices` and a `nextPageToken` for retrieving subsequent pages. This process requires `https://www.googleapis.com/auth/androidmanagement` authorization scope.\n"],null,["# Method: enterprises.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists devices for a given enterprise. Deleted devices are not returned in the response.\n\n### HTTP request\n\n`GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------|\n| `parent` | `string` The name of the enterprise in the form `enterprises/{enterpriseId}`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time. |\n| `pageToken` | `string` A token identifying a page of results returned by the server. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a request to list devices for a given enterprise.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/android/management/reference/rest/v1/enterprises.devices#Device) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/android/management/reference/rest/v1/enterprises.devices#Device)`)` The list of devices. |\n| `nextPageToken` | `string` If there are more results, a token to retrieve next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
