Method: customers.apps.fetchDevicesRequestingExtension
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.
Lấy danh sách thiết bị đã yêu cầu cài đặt một tiện ích.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số |
customer |
string
Bắt buộc. Mã khách hàng hoặc "my_customer" có tiền tố là "customer/".
|
Tham số truy vấn
Tham số |
extensionId |
string
Bắt buộc. Tiện ích mà chúng ta muốn tìm các thiết bị yêu cầu.
|
pageSize |
integer
Không bắt buộc. Số kết quả tối đa cần trả về. Tối đa và mặc định là 50. Mọi kích thước trang lớn hơn 50 sẽ bị ép buộc xuống còn 50.
|
pageToken |
string
Không bắt buộc. Mã thông báo để chỉ định trang của yêu cầu cần được trả về. Mã thông báo sẽ hết hạn sau 1 ngày.
|
orgUnitId |
string
Mã của đơn vị tổ chức. Chỉ xem xét những thiết bị trực tiếp thuộc đơn vị tổ chức này, tức là các đơn vị tổ chức con không được tính. Nếu bỏ qua, hàm sẽ trả về tất cả dữ liệu.
|
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
Phản hồi chứa danh sách thiết bị đã yêu cầu tiện ích đượ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:
Trường |
deviceDetails[] |
object (DeviceRequestingExtensionDetails )
Thông tin chi tiết về các thiết bị đã yêu cầu tiện ích được truy vấn.
|
totalSize |
integer
Không bắt buộc. Tổng số thiết bị đang phản hồi.
|
nextPageToken |
string
Không bắt buộc. Mã thông báo để chỉ định trang tiếp theo trong danh sách. Mã thông báo sẽ hết hạn sau 1 ngày.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
DeviceRequestingExtensionDetails
Thông tin chi tiết về thiết bị yêu cầu gia hạn, bao gồm cả tên thiết bị và lý do yêu cầu gia hạn.
Biểu diễn dưới dạng JSON |
{
"deviceName": string,
"justification": string
} |
Trường |
deviceName |
string
Tên của thiết bị đã yêu cầu tiện ích.
|
justification |
string
Yêu cầu lý do mà người dùng đã nhập.
|
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\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. |"]]