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

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

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

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

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

string

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

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

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
الحقول
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

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

string

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

object (RiskAssessmentData)

النتائج فقط. بيانات تقييم المخاطر المتعلّقة بهذه الإضافة، في حال توفّرها

AppInstallType

طريقة تثبيت التطبيق إذا لم يكن نوع التثبيت نفسه متوفّرًا في جميع نُسخ هذا التطبيق المثبَّت، يكون نوع التثبيت هو MULTIPLE.

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

AppSource

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

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

RiskAssessmentData

بيانات تقييم المخاطر حول إضافة أو تطبيق

تمثيل JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
الحقول
entries[]

object (RiskAssessmentEntry)

تقييمات المخاطر الفردية
overallRiskLevel

enum (RiskLevel)

مستوى المخاطر المُقيَّم بشكل عام في جميع الإدخالات سيكون هذا هو أعلى مستوى للمخاطر من جميع الإدخالات.

RiskAssessmentEntry

إدخال واحد لتقييم المخاطر

تمثيل JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
الحقول
provider

enum (RiskAssessmentProvider)

مقدّم خدمة تقييم المخاطر الذي ينبع منه هذا الإدخال.
riskAssessment

object (RiskAssessment)

تفاصيل تقييم مقدّم الخدمة للمخاطر
riskLevel

enum (RiskLevel)

مستوى الخطورة المقسّم إلى مجموعات لتقييم المخاطر

RiskAssessmentProvider

مقدّمو تقييم المخاطر

عمليات التعداد
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED القيمة التلقائية عند عدم تحديد مقدّم خدمة
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai
RISK_ASSESSMENT_PROVIDER_LAYERX فريق أمان LayerX

RiskAssessment

تقييم المخاطر لإضافة Chrome

تمثيل JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
الحقول
assessment

string

تقييم المخاطر للإضافة في الوقت الحالي، هذه قيمة رقمية، وتفسيرها خاص بكل مقدّم خدمة تقييم المخاطر.
detailsUrl

string

عنوان URL يمكن للمستخدم الانتقال إليه للحصول على مزيد من المعلومات عن تقييم المخاطر
version

string

إصدار الإضافة الذي ينطبق عليه هذا التقييم.

RiskLevel

مستوى الخطورة المجمّع لملحق/تطبيق

عمليات التعداد
RISK_LEVEL_UNSPECIFIED لم يتم تحديد مستوى الخطورة.
RISK_LEVEL_LOW إضافة تمثّل خطرًا منخفضًا
RISK_LEVEL_MEDIUM إضافة تمثّل خطرًا متوسطًا
RISK_LEVEL_HIGH إضافة تمثّل خطورة عالية