Method: customers.apps.fetchUsersRequestingExtension
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קבלת רשימה של משתמשים שביקשו להתקין תוסף.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchUsersRequestingExtension
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים |
customer |
string
חובה. מספר הלקוח או 'my_customer' עם הקידומת "customers/ ".
|
פרמטרים של שאילתה
| פרמטרים |
extensionId |
string
חובה. התוסף שעבורו אנחנו רוצים למצוא את המשתמשים ששלחו את הבקשה.
|
pageSize |
integer
זה שינוי אופציונלי. מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי וברירת המחדל הוא 50. כל גודל דף שגדול מ-50 יסווג ל-50.
|
pageToken |
string
זה שינוי אופציונלי. אסימון שמציין את הדף של הבקשה להחזרה. האסימון יפוג אחרי יום אחד.
|
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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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. |"]]
