Method: customers.reports.findInstalledAppDevices
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنشاء تقرير عن أجهزة متصفّح Chrome المُدارة التي تم تثبيت تطبيق محدّد عليها
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
customer |
string
مطلوب. رقم تعريف العميل أو "my_customer" لاستخدام العميل المرتبط بالحساب الذي يُقدّم الطلب
|
مَعلمات طلب البحث
| المعلمات |
orgUnitId |
string
رقم تعريف الوحدة التنظيمية
|
appId |
string
المعرّف الفريد للتطبيق. بالنسبة إلى تطبيقات Chrome والإضافات، يكون المعرّف مكوّنًا من 32 حرفًا (مثل ehoadneljpdggcbbknedodolkkjodefl). بالنسبة إلى تطبيقات Android، اسم الحزمة (مثل com.evernote)
|
pageSize |
integer
تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. الحد الأقصى والتلقائي هو 100 نتيجة.
|
pageToken |
string
رمز مميّز لتحديد صفحة الطلب التي سيتم عرضها.
|
orderBy |
string
الحقل المستخدَم لترتيب النتائج الحقول المتوافقة مع الترتيب حسب:
|
filter |
string
سلسلة طلب بحث لفلترة النتائج، الحقول مفصولة بـ "و" في بنية EBNF ملاحظة: لا يمكن استخدام عمليات OR في هذا الفلتر. حقول الفلاتر المتوافقة:
|
appType |
enum (AppType)
نوع التطبيق. اختياري في حال عدم تقديم نوع التطبيق، سيتم استنتاجه من تنسيق رقم تعريف التطبيق.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ يحتوي على قائمة بالأجهزة التي تم تثبيت التطبيق المطلوب البحث عنه عليها
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| الحقول |
devices[] |
object (Device)
قائمة بالأجهزة التي تم تثبيت التطبيق عليها يتم ترتيبها أبجديًا تصاعديًا في الحقل Device.machine.
|
nextPageToken |
string
رمز مميّز لتحديد الصفحة التالية من الطلب
|
totalSize |
integer
إجمالي عدد الأجهزة التي تتطابق مع الطلب
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
الجهاز
يصف هذا العمود جهازًا يُبلغ عن معلومات متصفّح Chrome.
| تمثيل JSON |
{
"deviceId": string,
"machine": string
} |
| الحقول |
deviceId |
string
النتائج فقط. رقم تعريف الجهاز الذي أبلغ عن معلومات متصفّح Chrome هذه.
|
machine |
string
النتائج فقط. اسم الجهاز ضمن شبكته المحلية.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGenerate a report of managed Chrome browser devices with a specific app installed using the provided HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eFilter the report by organizational unit, app ID and type, page size, page token, order, and filter criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of devices with the app installed, a token for the next page, and the total number of devices.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eEach device in the report is identified by its deviceId and machine name within its local network.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.findInstalledAppDevices\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.FindInstalledAppDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Device](#Device)\n - [JSON representation](#Device.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGenerate report of managed Chrome browser devices that have a specified app installed.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Customer id or \"my_customer\" to use the customer associated to the account making the request. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orgUnitId` | `string` The ID of the organizational unit. |\n| `appId` | `string` Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote). |\n| `pageSize` | `integer` Maximum number of results to return. Maximum and default are 100. |\n| `pageToken` | `string` Token to specify the page of the request to be returned. |\n| `orderBy` | `string` Field used to order results. Supported order by fields: - machine - deviceId |\n| `filter` | `string` Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: - last_active_date |\n| `appType` | `enum (`[AppType](/chrome/management/reference/rest/v1/AppType)`)` Type of the app. Optional. If not provided, an app type will be inferred from the format of the app ID. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a list of devices with queried app installed.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices#Device) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/chrome/management/reference/rest/v1/customers.reports/findInstalledAppDevices#Device)`)` A list of devices which have the app installed. Sorted in ascending alphabetical order on the Device.machine field. |\n| `nextPageToken` | `string` Token to specify the next page of the request. |\n| `totalSize` | `integer` Total number of devices matching request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nDevice\n------\n\nDescribes a device reporting Chrome browser information.\n\n| JSON representation |\n|---------------------------------------------------|\n| ``` { \"deviceId\": string, \"machine\": string } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------|\n| `deviceId` | `string` Output only. The ID of the device that reported this Chrome browser information. |\n| `machine` | `string` Output only. The name of the machine within its local network. |"]]
