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

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