Method: customers.reports.countInstalledApps

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

درخواست HTTP

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

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

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

پارامترها
customer

string

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

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

پارامترها
org Unit Id

string

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

page Size

integer

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

page Token

string

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

filter

string

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

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

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

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

string

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

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

  • نام_برنامه
  • نوع برنامه
  • install_type
  • تعداد_مجوزها
  • مجموع_نصب_تعداد
  • شناسه برنامه
  • manifest_versions
  • امتیاز_ریسک

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ حاوی جزئیات برنامه‌های نصب‌شده درخواست‌شده.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
فیلدها
installed Apps[]

object ( InstalledApp )

لیست برنامه های نصب شده مطابق با درخواست.

next Page Token

string

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

total Size

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)
  }
}
فیلدها
app Id

string

فقط خروجی شناسه منحصر به فرد برنامه برای برنامه‌ها و برنامه‌های افزودنی Chrome، شناسه 32 کاراکتری (مثلا ehoadneljpdggcbbknedodolkkjodefl). برای برنامه های اندروید، نام بسته (به عنوان مثال com.evernote).

app Type

enum ( AppType )

فقط خروجی نوع برنامه

browser Device Count

string ( int64 format)

فقط خروجی تعداد دستگاه های مرورگر با این برنامه نصب شده است.

os User Count

string ( int64 format)

فقط خروجی تعداد کاربران ChromeOS با نصب این برنامه.

app Install Type

enum ( AppInstallType )

فقط خروجی نحوه نصب برنامه

disabled

boolean

فقط خروجی اینکه آیا برنامه غیرفعال است.

app Source

enum ( AppSource )

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

display Name

string

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

description

string

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

homepage Uri

string

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

permissions[]

string

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

risk Assessment

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 )

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

overall Risk Level

enum ( RiskLevel )

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

Entry RiskAssessment

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

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

enum ( RiskAssessmentProvider )

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

risk Assessment

object ( RiskAssessment )

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

risk Level

enum ( RiskLevel )

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

RiskAssessment Provider

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

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

ارزیابی ریسک

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

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

string

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

details Url

string

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

version

string

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

سطح ریسک

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

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