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

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

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

  • آلة
  • deviceId
filter

string

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

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

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

  • last_active_date
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

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