Method: customers.apps.fetchDevicesRequestingExtension
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
لیستی از دستگاه هایی که درخواست نصب افزونه را داده اند دریافت کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
customer | string مورد نیاز. شناسه مشتری یا "my_customer" با پیشوند "customers/". |
پارامترهای پرس و جو
پارامترها |
---|
extensionId | string مورد نیاز. افزونه ای که می خواهیم دستگاه های درخواست کننده را برای آن پیدا کنیم. |
pageSize | integer اختیاری. حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 50 است. هر اندازه صفحه بزرگتر از 50 به 50 تبدیل می شود. |
pageToken | string اختیاری. رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود. توکن پس از 1 روز منقضی می شود. |
orgUnitId | string شناسه واحد سازمانی. فقط دستگاه هایی را در نظر بگیرید که مستقیماً به این واحد سازمانی تعلق دارند، یعنی ارگان های فرعی شمارش نمی شوند. در صورت حذف، تمام داده ها برگردانده می شوند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ حاوی فهرستی از دستگاههایی که برنامه افزودنی درخواست شده را درخواست کردهاند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
deviceDetails[] | object ( DeviceRequestingExtensionDetails ) جزئیات دستگاههایی که برنامه افزودنی درخواست شده را درخواست کردهاند. |
totalSize | integer اختیاری. تعداد کل دستگاه ها در پاسخ. |
nextPageToken | string اختیاری. رمزی برای مشخص کردن صفحه بعدی در لیست. توکن پس از 1 روز منقضی می شود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
DeviceRequestingExtensionDetails
جزئیات دستگاه درخواست کننده افزونه، از جمله نام دستگاه و توجیه درخواست.
نمایندگی JSON |
---|
{
"deviceName": string,
"justification": string
} |
فیلدها |
---|
deviceName | string نام دستگاهی که افزونه را درخواست کرده است. |
justification | string درخواست توجیه همانطور که توسط کاربر وارد شده است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]