Method: customers.reports.findInstalledAppDevices
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת דוח על מכשירים עם דפדפן Chrome מנוהל שמותקנת בהם אפליקציה מסוימת.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
customer |
string
חובה. Customer id או 'my_customer' כדי להשתמש בלקוח שמשויך לחשבון שמבצע את הבקשה.
|
פרמטרים של שאילתה
| פרמטרים |
orgUnitId |
string
המזהה של היחידה הארגונית.
|
appId |
string
המזהה הייחודי של האפליקציה. באפליקציות ובתוספים של Chrome, המזהה מורכב מ-32 תווים (למשל, ehoadneljpdggcbbknedodolkkjodefl). באפליקציות ל-Android, שם החבילה (למשל, com.evernote).
|
pageSize |
integer
המספר המקסימלי של תוצאות להחזרה. הערך המקסימלי והערך שמוגדר כברירת מחדל הם 100.
|
pageToken |
string
אסימון לציון הדף של הבקשה שיוחזר.
|
orderBy |
string
השדה שבו נעשה שימוש כדי למיין את התוצאות. שדות נתמכים לסדר לפי:
|
filter |
string
מחרוזת שאילתה לסינון תוצאות, שדות מופרדים ב-AND בסינטקס EBNF. הערה: אי אפשר להשתמש בפעולות OR (או) במסנן הזה. שדות מסנן נתמכים:
|
appType |
enum (AppType)
סוג האפליקציה. אופציונלי. אם לא תספקו את סוג האפליקציה, המערכת תסיק את סוג האפליקציה מהפורמט של מזהה האפליקציה.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה שמכילה רשימה של מכשירים שבהם מותקנת האפליקציה שבה בוצעה השאילתה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| שדות |
devices[] |
object (Device)
רשימה של מכשירים שבהם מותקנת האפליקציה. ממוינים בסדר אלפביתי עולה בשדה Device.machine.
|
nextPageToken |
string
אסימון לציון הדף הבא בבקשה.
|
totalSize |
integer
המספר הכולל של מכשירים שתואמים לבקשה.
|
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/chrome.management.reports.readonly
מכשיר
תיאור של מכשיר שמדווח על מידע מדפדפן Chrome.
| ייצוג ב-JSON |
{
"deviceId": string,
"machine": string
} |
| שדות |
deviceId |
string
פלט בלבד. המזהה של המכשיר שדיווח על המידע הזה מדפדפן Chrome.
|
machine |
string
פלט בלבד. השם של המכונה ברשת המקומית שלה.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
