Method: customers.reports.findInstalledAppDevices
Stay organized with collections
Save and categorize content based on your preferences.
Generate report of managed Chrome browser devices that have a specified app installed.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
customer |
string
Required. Customer id or "my_customer" to use the customer associated to the account making the request.
|
Query parameters
Parameters |
orgUnitId |
string
The ID of the organizational unit.
|
appId |
string
Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote).
|
pageSize |
integer
Maximum number of results to return. Maximum and default are 100.
|
pageToken |
string
Token to specify the page of the request to be returned.
|
orderBy |
string
Field used to order results. Supported order by fields:
|
filter |
string
Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields:
|
appType |
enum (AppType )
Type of the app. Optional. If not provided, an app type will be inferred from the format of the app ID.
|
Request body
The request body must be empty.
Response body
Response containing a list of devices with queried app installed.
If successful, the response body contains data with the following structure:
JSON representation |
{
"devices": [
{
object (Device )
}
],
"nextPageToken": string,
"totalSize": integer
} |
Fields |
devices[] |
object (Device )
A list of devices which have the app installed. Sorted in ascending alphabetical order on the Device.machine field.
|
nextPageToken |
string
Token to specify the next page of the request.
|
totalSize |
integer
Total number of devices matching request.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Device
Describes a device reporting Chrome browser information.
JSON representation |
{
"deviceId": string,
"machine": string
} |
Fields |
deviceId |
string
Output only. The ID of the device that reported this Chrome browser information.
|
machine |
string
Output only. The name of the machine within its local network.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-23 UTC."],[[["\u003cp\u003eGenerate a report of managed Chrome browser devices with a specific app installed using the provided HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eFilter the report by organizational unit, app ID and type, page size, page token, order, and filter criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of devices with the app installed, a token for the next page, and the total number of devices.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eEach device in the report is identified by its deviceId and machine name within its local network.\u003c/p\u003e\n"]]],[],null,["- [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.FindInstalledAppDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Device](#Device)\n - [JSON representation](#Device.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGenerate report of managed Chrome browser devices that have a specified app installed.\n\nHTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|------------|-------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Customer id or \"my_customer\" to use the customer associated to the account making the request. |\n\nQuery parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orgUnitId` | `string` The ID of the organizational unit. |\n| `appId` | `string` Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote). |\n| `pageSize` | `integer` Maximum number of results to return. Maximum and default are 100. |\n| `pageToken` | `string` Token to specify the page of the request to be returned. |\n| `orderBy` | `string` Field used to order results. Supported order by fields: - machine - deviceId |\n| `filter` | `string` Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: - last_active_date |\n| `appType` | `enum (`[AppType](/chrome/management/reference/rest/v1/AppType)`)` Type of the app. Optional. If not provided, an app type will be inferred from the format of the app ID. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Response containing a list of devices with queried app installed.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices#Device) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices#Device)`)` A list of devices which have the app installed. Sorted in ascending alphabetical order on the Device.machine field. |\n| `nextPageToken` | `string` Token to specify the next page of the request. |\n| `totalSize` | `integer` Total number of devices matching request. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nDevice Describes a device reporting Chrome browser information.\n\n| JSON representation |\n|---------------------------------------------------|\n| ``` { \"deviceId\": string, \"machine\": string } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------|\n| `deviceId` | `string` Output only. The ID of the device that reported this Chrome browser information. |\n| `machine` | `string` Output only. The name of the machine within its local network. |"]]