Method: customers.reports.countInstalledApps

ایجاد گزارش از نصب برنامه

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customer

string

مورد نیاز. شناسه مشتری یا "my_customer" برای استفاده از مشتری مرتبط با حساب درخواست کننده.

پارامترهای پرس و جو

پارامترها
orgUnitId

string

شناسه واحد سازمانی.

pageSize

integer

حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 100 است.

pageToken

string

رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود.

filter

string

رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF.

توجه: عملیات OR در این فیلتر پشتیبانی نمی شود.

فیلدهای فیلتر پشتیبانی شده:

  • نام_برنامه
  • نوع برنامه
  • install_type
  • تعداد_مجوزها
  • total_install_count
  • آخرین_پروفایل_تاریخ_فعال
  • permission_name
  • شناسه برنامه
  • manifest_versions
  • امتیاز_ریسک
orderBy

string

فیلد مورد استفاده برای سفارش نتایج.

سفارش پشتیبانی شده بر اساس فیلدها:

  • نام_برنامه
  • نوع برنامه
  • install_type
  • تعداد_مجوزها
  • 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

برنامه نصب شده

یک برنامه نصب شده را توصیف می کند.

نمایندگی 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). برای برنامه های اندروید، نام بسته (به عنوان مثال 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

فقط خروجی آدرس صفحه اصلی برنامه نصب شده.

permissions[]

string

فقط خروجی مجوزهای برنامه نصب شده

riskAssessment

object ( RiskAssessmentData )

فقط خروجی در صورت وجود، داده‌های ارزیابی خطر در مورد این برنامه افزودنی.

AppInstallType

نحوه نصب برنامه اگر همه نمونه‌های این برنامه نصب‌شده دارای یک نوع نصب نیستند، نوع نصب MULTIPLE است.

Enums
APP_INSTALL_TYPE_UNSPECIFIED نوع نصب برنامه مشخص نشده است.
MULTIPLE انواع نصب برنامه
NORMAL نوع نصب نرمال برنامه
ADMIN نوع نصب برنامه مدیر.
DEVELOPMENT نوع نصب برنامه توسعه.
SIDELOAD نوع نصب برنامه Sideloaded.
OTHER نوع نصب برنامه دیگر

AppSource

منبع برنامه نصب شده

Enums
APP_SOURCE_UNSPECIFIED منبع برنامه مشخص نشده است.
CHROME_WEBSTORE به طور کلی برای برنامه های افزودنی و کروم.
PLAY_STORE برنامه Play Store.

داده‌های ارزیابی ریسک

داده های ارزیابی ریسک در مورد یک برنامه افزودنی/برنامه.

نمایندگی JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
فیلدها
entries[]

object ( RiskAssessmentEntry )

ارزیابی ریسک فردی

overallRiskLevel

enum ( RiskLevel )

سطح ریسک ارزیابی کلی در همه ورودی ها. این بالاترین سطح ریسک از همه ورودی ها خواهد بود.

Entry RiskAssessment

یک ورودی ارزیابی ریسک

نمایندگی JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
فیلدها
provider

enum ( RiskAssessmentProvider )

ارائه دهنده ارزیابی ریسک که این ورودی از آن می آید.

riskAssessment

object ( RiskAssessment )

جزئیات ارزیابی ریسک ارائه دهنده.

riskLevel

enum ( RiskLevel )

سطح ریسک سطلی برای ارزیابی ریسک.

RiskAssessment Provider

ارائه دهندگان ارزیابی ریسک

Enums
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED مقدار پیش فرض زمانی که هیچ ارائه دهنده ای مشخص نشده است.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX امنیت لایه ایکس

ارزیابی ریسک

ارزیابی ریسک برای یک برنامه افزودنی Chrome.

نمایندگی JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
فیلدها
assessment

string

ارزیابی ریسک برای تمدید در حال حاضر، این یک مقدار عددی است و تفسیر آن برای هر ارائه‌دهنده ارزیابی ریسک خاص است.

detailsUrl

string

آدرس اینترنتی که کاربر می تواند برای اطلاعات بیشتر در مورد ارزیابی ریسک به آن مراجعه کند.

version

string

نسخه افزونه ای که این ارزیابی برای آن اعمال می شود.

سطح ریسک

سطح خطر سطلی برای یک برنامه افزودنی/برنامه.

Enums
RISK_LEVEL_UNSPECIFIED سطح ریسک مشخص نشده است.
RISK_LEVEL_LOW پسوندی که نشان دهنده ریسک کم است.
RISK_LEVEL_MEDIUM توسعه ای که نشان دهنده یک ریسک متوسط ​​است.
RISK_LEVEL_HIGH پسوندی که نشان دهنده ریسک بالایی است.