Method: customers.apps.fetchUsersRequestingExtension
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
لیستی از کاربرانی که درخواست نصب افزونه را داشته اند دریافت کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchUsersRequestingExtension
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
customer | string مورد نیاز. شناسه مشتری یا "my_customer" با پیشوند "customers/". |
پارامترهای پرس و جو
پارامترها |
---|
extensionId | string مورد نیاز. افزونه ای که می خواهیم کاربران درخواست کننده را برای آن پیدا کنیم. |
pageSize | integer اختیاری. حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 50 است. هر اندازه صفحه بزرگتر از 50 به 50 تبدیل می شود. |
pageToken | string اختیاری. رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود. توکن پس از 1 روز منقضی می شود. |
orgUnitId | string شناسه واحد سازمانی. فقط دستگاه هایی را در نظر بگیرید که مستقیماً به این واحد سازمانی تعلق دارند، یعنی ارگان های فرعی شمارش نمی شوند. در صورت حذف، تمام داده ها برگردانده می شوند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخی که حاوی لیستی از کاربرانی است که افزونه درخواست شده را درخواست کردهاند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
userDetails[] | object ( UserRequestingExtensionDetails ) جزئیات کاربرانی که پسوند درخواست شده را درخواست کرده اند. |
totalSize | integer تعداد کل کاربران در پاسخ. |
nextPageToken | string رمزی برای مشخص کردن صفحه بعدی در لیست. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
UserRequestingExtensionDetails
جزئیات کاربری که درخواست برنامه افزودنی می کند، از جمله ایمیل و توجیه.
نمایندگی JSON |
---|
{
"email": string,
"justification": string
} |
فیلدها |
---|
email | 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\u003eFetches a list of users who have requested to install a specific extension.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.appdetails.readonly\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes user details (email and justification), total user count, and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by organizational unit and provides options for pagination to handle large datasets.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and the response is a JSON object containing user details and pagination information.\u003c/p\u003e\n"]]],[],null,["# Method: customers.apps.fetchUsersRequestingExtension\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.FetchUsersRequestingExtensionResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UserRequestingExtensionDetails](#UserRequestingExtensionDetails)\n - [JSON representation](#UserRequestingExtensionDetails.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet a list of users that have requested to install an extension.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchUsersRequestingExtension`\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 the requesting users. |\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 users that have requested the queried extension.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"userDetails\": [ { object (/chrome/management/reference/rest/v1/customers.apps/fetchUsersRequestingExtension#UserRequestingExtensionDetails) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userDetails[]` | `object (`[UserRequestingExtensionDetails](/chrome/management/reference/rest/v1/customers.apps/fetchUsersRequestingExtension#UserRequestingExtensionDetails)`)` Details of users that have requested the queried extension. |\n| `totalSize` | `integer` Total number of users in response. |\n| `nextPageToken` | `string` Token to specify the next page in the list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.appdetails.readonly`\n\nUserRequestingExtensionDetails\n------------------------------\n\nDetails of a user requesting an extension, including the email and the justification.\n\n| JSON representation |\n|------------------------------------------------------|\n| ``` { \"email\": string, \"justification\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------|\n| `email` | `string` The e-mail address of a user that has requested the extension. |\n| `justification` | `string` Request justification as entered by the user. |"]]