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 في هذا الفلتر.

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

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
orderBy

string

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

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

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

نص الطلب

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

نص الاستجابة

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

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

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