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
  • 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

النتائج فقط. المعرّف الفريد للتطبيق، وهو يتألف من 32 حرفًا (مثل ehoadneljpdggcbbknedodolkkjodefl) بالنسبة إلى تطبيقات Chrome وإضافاته. بالنسبة إلى تطبيقات 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

النتائج فقط. أذونات التطبيق المثبَّت
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 Security
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 ‫Spin.AI V2

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 إضافة تمثّل خطرًا كبيرًا