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)
appType

enum (AppType)

نوع التطبيق
pageSize

integer

تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. الحد الأقصى والتلقائي هو 100 نتيجة.
pageToken

string

رمز مميّز لتحديد صفحة الطلب التي سيتم عرضها
orderBy

string

الحقل المستخدَم لترتيب النتائج

الحقول المتوافقة مع الترتيب حسب:

  • الجهاز
  • deviceId
filter

string

سلسلة طلب البحث لفلترة النتائج، والحقول المفصولة بـ AND في بنية EBNF.

ملاحظة: لا يمكن استخدام عمليات OR في هذا الفلتر.

حقول الفلاتر المتوافقة:

  • last_active_date

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ يحتوي على قائمة بالأجهزة التي تم تثبيت التطبيق المطلوب البحث عنه عليها

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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

النتائج فقط. اسم الجهاز ضمن شبكته المحلية