Method: customers.reports.countInstalledApps

إنشاء تقرير لعمليات تثبيت التطبيقات.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countInstalledApps

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
customer

string

مطلوب. رقم تعريف العميل أو "my_customer" استخدام العميل المرتبط بالحساب الذي يقدّم الطلب.

معامِلات طلب البحث

المعلمات
orgUnitId

string

رقم تعريف الوحدة التنظيمية.
pageSize

integer

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

string

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

string

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

ملاحظة: عمليات OR غير متاحة في هذا الفلتر.

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

  • اسم_التطبيق
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • رقم تعريف التطبيق
  • manifest_versions
orderBy

string

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

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

  • اسم_التطبيق
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • رقم تعريف التطبيق
  • manifest_versions

نص الطلب

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

نص الاستجابة

ردّ يحتوي على تفاصيل التطبيقات المثبَّتة التي تم البحث عنها

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

تمثيل JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
الحقول
installedApps[]

object (InstalledApp)

قائمة التطبيقات المثبّتة المطابقة للطلب
nextPageToken

string

رمز مميز لتحديد الصفحة التالية من الطلب.
totalSize

integer

إجمالي عدد التطبيقات المثبّتة التي تتطابق مع الطلب

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

InstalledApp

لوصف تطبيق مثبَّت.

تمثيل JSON 
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ]
}
الحقول
appId

string

النتائج فقط. المعرّف الفريد للتطبيق بالنسبة إلى تطبيقات Chrome وإضافاته، رقم التعريف المكوّن من 32 حرفًا (مثل ehoadneljpdggcbbknedodolkkjodefl). بالنسبة إلى تطبيقات Android، اسم الحزمة (مثل com.evernote).
appType

enum (AppType)

النتائج فقط. نوع التطبيق
browserDeviceCount

string (int64 format)

النتائج فقط. عدد أجهزة المتصفّح التي تم تثبيت هذا التطبيق عليها
osUserCount

string (int64 format)

النتائج فقط. عدد مستخدمي نظام التشغيل ChromeOS الذين ثبَّتوا هذا التطبيق لديهم.
appInstallType

enum (AppInstallType)

النتائج فقط. طريقة تثبيت التطبيق
disabled

boolean

النتائج فقط. ما إذا كان التطبيق غير مفعَّل
appSource

enum (AppSource)

النتائج فقط. مصدر التطبيق المثبَّت
displayName

string

النتائج فقط. اسم التطبيق المثبَّت
description

string

النتائج فقط. وصف التطبيق المثبَّت
homepageUri

string

النتائج فقط. معرّف الموارد المنتظم (URI) للصفحة الرئيسية للتطبيق المثبّت.
permissions[]

string

النتائج فقط. أذونات التطبيق المثبَّت

AppInstallType

طريقة تثبيت التطبيق إذا لم تكن جميع مثيلات هذا التطبيق المثبّت لها نوع التثبيت نفسه، سيكون نوع التثبيت "متعددة".

عمليات التعداد
APP_INSTALL_TYPE_UNSPECIFIED لم يتم تحديد نوع تثبيت التطبيق.
MULTIPLE أنواع متعددة لتثبيت التطبيقات.
NORMAL نوع تثبيت التطبيق العادي.
ADMIN نوع تثبيت التطبيق من جانب المشرف.
DEVELOPMENT نوع تثبيت التطبيق قيد التطوير.
SIDELOAD نوع تثبيت التطبيق الذي تم تحميله من مصدر غير معروف
OTHER نوع آخر لتثبيت التطبيق

AppSource

مصدر التطبيق المثبَّت

عمليات التعداد
APP_SOURCE_UNSPECIFIED لم يتم تحديد مصدر التطبيق.
CHROME_WEBSTORE بشكلٍ عام للإضافات وتطبيقات Chrome.
PLAY_STORE تطبيق "متجر Play".