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