Method: customers.reports.findInstalledAppDevices
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Bericht zu verwalteten Chrome-Browsern erstellen, auf denen eine bestimmte App installiert ist
HTTP-Anfrage
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
customer |
string
Erforderlich. Kundennummer oder „my_customer“, um den Kunden zu verwenden, der mit dem Konto verknüpft ist, über das die Anfrage erfolgt.
|
Abfrageparameter
Parameter |
orgUnitId |
string
Die ID der Organisationseinheit.
|
appId |
string
Die eindeutige Kennung der App. Bei Chrome-Apps und ‑Erweiterungen ist das die 32-stellige ID (z.B. ehoadneljpdggcbbknedodolkkjodefl). Bei Android-Apps ist das der Paketname (z.B. com.evernote).
|
pageSize |
integer
Maximale Anzahl der zurückzugebenden Ergebnisse. Höchst- und Standardwert ist 100.
|
pageToken |
string
Token, mit dem die Seite der Anfrage angegeben wird, die zurückgegeben werden soll.
|
orderBy |
string
Feld, anhand dessen die Ergebnisse sortiert werden. Unterstützte Felder für die Sortierung nach:
|
filter |
string
Abfragestring zum Filtern von Ergebnissen, AND-getrennte Felder in EBNF-Syntax. Hinweis: ODER-Vorgänge werden in diesem Filter nicht unterstützt. Unterstützte Filterfelder:
|
appType |
enum (AppType )
Der Typ der App. Optional. Wenn Sie keinen App-Typ angeben, wird dieser aus dem Format der App-ID abgeleitet.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort mit einer Liste der Geräte, auf denen die abgefragte App installiert ist.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"devices": [
{
object (Device )
}
],
"nextPageToken": string,
"totalSize": integer
} |
Felder |
devices[] |
object (Device )
Eine Liste der Geräte, auf denen die App installiert ist. Sortiert in aufsteigender alphabetischer Reihenfolge nach dem Feld „Device.machine“.
|
nextPageToken |
string
Token, mit dem die nächste Seite der Anfrage angegeben wird.
|
totalSize |
integer
Gesamtzahl der Geräte, die der Anfrage entsprechen.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Gerät
Hier wird ein Gerät beschrieben, das Chrome-Browserinformationen meldet.
JSON-Darstellung |
{
"deviceId": string,
"machine": string
} |
Felder |
deviceId |
string
Nur Ausgabe. Die ID des Geräts, von dem diese Chrome-Browserinformationen stammen.
|
machine |
string
Nur Ausgabe. Der Name des Computers in seinem lokalen Netzwerk.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (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,["# Method: customers.reports.findInstalledAppDevices\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.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\n### HTTP 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\n### Path 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\n### Query 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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse 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\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nDevice\n------\n\nDescribes 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. |"]]