Method: customers.reports.countInstalledApps

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
customer

string

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

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

پارامترها
orgUnitId

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

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

string

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

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

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش 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

فقط خروجی. شناسه منحصر به فرد برنامه. برای برنامه‌ها و افزونه‌های کروم، شناسه ۳۲ کاراکتری (مثلاً 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 )

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

نوع نصب برنامه

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

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

اپ‌سورس

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

انوم‌ها
APP_SOURCE_UNSPECIFIED منبع برنامه مشخص نشده است.
CHROME_WEBSTORE عموماً برای افزونه‌ها و برنامه‌های کروم.
PLAY_STORE برنامه فروشگاه پلی.

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

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

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

object ( RiskAssessmentEntry )

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

overallRiskLevel

enum ( RiskLevel )

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

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

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

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

enum ( RiskAssessmentProvider )

فقط خروجی. ارائه دهنده ارزیابی ریسک که این ورودی از آن آمده است.

riskAssessment

object ( RiskAssessment )

فقط خروجی. جزئیات ارزیابی ریسک ارائه دهنده.

riskLevel

enum ( RiskLevel )

فقط خروجی. سطح ریسک دسته‌بندی‌شده برای ارزیابی ریسک.

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

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

انوم‌ها
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED مقدار پیش‌فرض زمانی که هیچ ارائه‌دهنده‌ای مشخص نشده باشد.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR بیل مکانیکی CRX.
RISK_ASSESSMENT_PROVIDER_SPIN_AI اسپین.ای.آی.
RISK_ASSESSMENT_PROVIDER_LAYERX امنیت لایه ایکس
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 اسپین.AI نسخه ۲.

ارزیابی ریسک

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

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

string

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

detailsUrl

string

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

version

string

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

سطح ریسک

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

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

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
customer

string

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

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

پارامترها
orgUnitId

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

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

string

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

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

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش 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

فقط خروجی. شناسه منحصر به فرد برنامه. برای برنامه‌ها و افزونه‌های کروم، شناسه ۳۲ کاراکتری (مثلاً 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 )

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

نوع نصب برنامه

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

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

اپ‌سورس

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

انوم‌ها
APP_SOURCE_UNSPECIFIED منبع برنامه مشخص نشده است.
CHROME_WEBSTORE عموماً برای افزونه‌ها و برنامه‌های کروم.
PLAY_STORE برنامه فروشگاه پلی.

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

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

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

object ( RiskAssessmentEntry )

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

overallRiskLevel

enum ( RiskLevel )

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

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

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

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

enum ( RiskAssessmentProvider )

فقط خروجی. ارائه دهنده ارزیابی ریسک که این ورودی از آن آمده است.

riskAssessment

object ( RiskAssessment )

فقط خروجی. جزئیات ارزیابی ریسک ارائه دهنده.

riskLevel

enum ( RiskLevel )

فقط خروجی. سطح ریسک دسته‌بندی‌شده برای ارزیابی ریسک.

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

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

انوم‌ها
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED مقدار پیش‌فرض زمانی که هیچ ارائه‌دهنده‌ای مشخص نشده باشد.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR بیل مکانیکی CRX.
RISK_ASSESSMENT_PROVIDER_SPIN_AI اسپین.ای.آی.
RISK_ASSESSMENT_PROVIDER_LAYERX امنیت لایه ایکس
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 اسپین.AI نسخه ۲.

ارزیابی ریسک

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

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

string

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

detailsUrl

string

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

version

string

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

سطح ریسک

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

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