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

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