Method: customers.reports.findInstalledAppDevices
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo báo cáo về các thiết bị dùng trình duyệt Chrome được quản lý và đã cài đặt một ứng dụng cụ thể.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
customer |
string
Bắt buộc. Mã khách hàng hoặc "my_customer" để sử dụng khách hàng được liên kết với tài khoản đưa ra yêu cầu.
|
Tham số truy vấn
Thông số |
orgUnitId |
string
Mã nhận dạng của đơn vị tổ chức.
|
appId |
string
Giá trị nhận dạng duy nhất của ứng dụng. Đối với ứng dụng và tiện ích Chrome, mã nhận dạng gồm 32 ký tự (ví dụ: ehoadneljpdggcbbknedodolkkjodefl). Đối với ứng dụng Android, tên gói (ví dụ: com.evernote).
|
pageSize |
integer
Số lượng kết quả tối đa cần trả về. Giá trị tối đa và mặc định là 100.
|
pageToken |
string
Mã thông báo để chỉ định trang của yêu cầu cần trả về.
|
orderBy |
string
Trường dùng để sắp xếp kết quả. Các trường được hỗ trợ theo thứ tự:
|
filter |
string
Chuỗi truy vấn để lọc kết quả, các trường được phân tách bằng AND theo cú pháp EBNF. Lưu ý: Bộ lọc này không hỗ trợ toán tử HOẶC. Các trường bộ lọc được hỗ trợ:
|
appType |
enum (AppType )
Loại ứng dụng. Không bắt buộc. Nếu bạn không cung cấp, loại ứng dụng sẽ được suy luận từ định dạng của mã ứng dụng.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nội dung phản hồi chứa danh sách thiết bị đã cài đặt ứng dụng được truy vấn.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"devices": [
{
object (Device )
}
],
"nextPageToken": string,
"totalSize": integer
} |
Trường |
devices[] |
object (Device )
Danh sách các thiết bị đã cài đặt ứng dụng. Sắp xếp theo thứ tự bảng chữ cái tăng dần trên trường Device.machine.
|
nextPageToken |
string
Mã thông báo để chỉ định trang tiếp theo của yêu cầu.
|
totalSize |
integer
Tổng số thiết bị khớp với yêu cầu.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Thiết bị
Mô tả một thiết bị báo cáo thông tin về trình duyệt Chrome.
Biểu diễn dưới dạng JSON |
{
"deviceId": string,
"machine": string
} |
Trường |
deviceId |
string
Chỉ có đầu ra. Mã thiết bị đã báo cáo thông tin này về trình duyệt Chrome.
|
machine |
string
Chỉ có đầu ra. Tên của máy trong mạng cục bộ.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]