Method: customers.apps.fetchDevicesRequestingExtension
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera un elenco dei dispositivi che hanno richiesto di installare un'estensione.
Richiesta HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
customer |
string
Obbligatorio. L'ID cliente o "mio_cliente" preceduto dal prefisso "customers/".
|
Parametri di query
Parametri |
extensionId |
string
Obbligatorio. L'estensione per la quale vogliamo trovare i dispositivi che effettuano la richiesta.
|
pageSize |
integer
(Facoltativo) Numero massimo di risultati da restituire. Il valore massimo e quello predefinito sono 50. Qualsiasi dimensione della pagina superiore a 50 verrà forzata a 50.
|
pageToken |
string
(Facoltativo) Token per specificare la pagina della richiesta da restituire. Il token scade dopo 1 giorno.
|
orgUnitId |
string
L'ID dell'unità organizzativa. Considera solo i dispositivi che appartengono direttamente a questa unità organizzativa, ad esempio le unità organizzative secondarie non vengono conteggiate. Se omesso, verranno restituiti tutti i dati.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta contenente un elenco di dispositivi che hanno richiesto l'estensione per cui è stata eseguita la query.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Campi |
deviceDetails[] |
object (DeviceRequestingExtensionDetails )
Dettagli dei dispositivi che hanno richiesto l'estensione per cui è stata eseguita la query.
|
totalSize |
integer
(Facoltativo) Numero totale di dispositivi in risposta.
|
nextPageToken |
string
(Facoltativo) Token per specificare la pagina successiva dell'elenco. Il token scade dopo 1 giorno.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
DeviceRequestingExtensionDetails
Dettagli di un dispositivo che richiede un'estensione, inclusi il nome del dispositivo e la giustificazione della richiesta.
Rappresentazione JSON |
{
"deviceName": string,
"justification": string
} |
Campi |
deviceName |
string
Il nome di un dispositivo che ha richiesto l'estensione.
|
justification |
string
Motivazione della richiesta inserita dall'utente.
|
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."],[[["\u003cp\u003eThis API retrieves a list of devices that have requested to install a specific extension.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the customer ID and extension ID as parameters.\u003c/p\u003e\n"],["\u003cp\u003eResults can be paginated using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes device details such as device name and request justification.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003echrome.management.appdetails.readonly\u003c/code\u003e OAuth scope is necessary for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: customers.apps.fetchDevicesRequestingExtension\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.FetchDevicesRequestingExtensionResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [DeviceRequestingExtensionDetails](#DeviceRequestingExtensionDetails)\n - [JSON representation](#DeviceRequestingExtensionDetails.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet a list of devices that have requested to install an extension.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------|\n| `customer` | `string` Required. The customer ID or \"my_customer\" prefixed with \"customers/\". |\n\n### Query parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `extensionId` | `string` Required. The extension for which we want to find requesting devices. |\n| `pageSize` | `integer` Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50. |\n| `pageToken` | `string` Optional. Token to specify the page of the request to be returned. Token expires after 1 day. |\n| `orgUnitId` | `string` The ID of the organizational unit. Only consider devices that directly belong to this org unit, i.e. sub-orgunits are not counted. If omitted, all data will be returned. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a list of devices that have requested the queried extension.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceDetails\": [ { object (/chrome/management/reference/rest/v1/customers.apps/fetchDevicesRequestingExtension#DeviceRequestingExtensionDetails) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceDetails[]` | `object (`[DeviceRequestingExtensionDetails](/chrome/management/reference/rest/v1/customers.apps/fetchDevicesRequestingExtension#DeviceRequestingExtensionDetails)`)` Details of devices that have requested the queried extension. |\n| `totalSize` | `integer` Optional. Total number of devices in response. |\n| `nextPageToken` | `string` Optional. Token to specify the next page in the list. Token expires after 1 day. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.appdetails.readonly`\n\nDeviceRequestingExtensionDetails\n--------------------------------\n\nDetails of a device requesting an extension, including the name of the device and the justification of the request.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ``` { \"deviceName\": string, \"justification\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------|\n| `deviceName` | `string` The name of a device that has requested the extension. |\n| `justification` | `string` Request justification as entered by the user. |"]]