Method: customers.apps.fetchDevicesRequestingExtension
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtén una lista de los dispositivos que solicitaron instalar una extensión.
Solicitud HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
customer |
string
Obligatorio. El ID de cliente o "my_customer" con el prefijo “customers/”.
|
Parámetros de consulta
Parámetros |
extensionId |
string
Obligatorio. La extensión para la que queremos encontrar los dispositivos que solicitan permiso.
|
pageSize |
integer
Opcional. Cantidad máxima de resultados que se mostrarán. El máximo y el valor predeterminado son 50. Todas las páginas que superen 50 se convertirán a 50.
|
pageToken |
string
Opcional. Token para especificar la página de la solicitud que se mostrará. El token vence después de 1 día.
|
orgUnitId |
string
Es el ID de la unidad organizativa. Solo considera los dispositivos que pertenecen directamente a esta unidad organizativa (es decir, no se registran las suborganizaciones. Si se omite, se mostrarán todos los datos.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta que contiene una lista de dispositivos que solicitaron la extensión consultada.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Campos |
deviceDetails[] |
object (DeviceRequestingExtensionDetails )
Detalles de los dispositivos que solicitaron la extensión consultada.
|
totalSize |
integer
Opcional. Cantidad total de dispositivos en respuesta.
|
nextPageToken |
string
Opcional. Token para especificar la página siguiente en la lista. El token vence después de 1 día.
|
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
DeviceRequestingExtensionDetails
Detalles de un dispositivo que solicita una extensión, incluidos el nombre del dispositivo y la justificación de la solicitud
Representación JSON |
{
"deviceName": string,
"justification": string
} |
Campos |
deviceName |
string
Es el nombre de un dispositivo que solicitó la extensión.
|
justification |
string
Solicita una justificación tal como la ingresó el usuario.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]