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

מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי והערך שמוגדר כברירת מחדל הם 100.
pageToken

string

אסימון לציון הדף של הבקשה שיוחזר.
filter

string

מחרוזת שאילתה לסינון התוצאות, ושדות שמופרדים באמצעות AND בתחביר EBNF.

הערה: אי אפשר להשתמש בפעולות מסוג 'או' במסנן הזה.

שדות מסנן נתמכים:

  • 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

פלט בלבד. ה-URI של דף הבית של האפליקציה המותקנת.
permissions[]

string

פלט בלבד. הרשאות של האפליקציה שמותקנת.
riskAssessment

object (RiskAssessmentData)

פלט בלבד. אם יש נתונים זמינים של הערכת הסיכונים לגבי התוסף הזה,

AppInstallType

האופן שבו האפליקציה הותקנה. אם לא לכל המופעים של האפליקציה המותקנת יש את אותו סוג התקנה, סוג ההתקנה הוא MULTIPLE.

טיפוסים בני מנייה (enum)
APP_INSTALL_TYPE_UNSPECIFIED לא צוין סוג ההתקנה של האפליקציה.
MULTIPLE סוגים מרובים של התקנות אפליקציה.
NORMAL סוג התקנה רגיל של אפליקציה.
ADMIN סוג ההתקנה של אפליקציית האדמין.
DEVELOPMENT סוג ההתקנה של אפליקציית הפיתוח.
SIDELOAD סוג ההתקנה של האפליקציה מחוץ לחנות.
OTHER סוג אחר של התקנת אפליקציה.

AppSource

המקור של האפליקציה שמותקנת.

טיפוסים בני מנייה (enum)
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

ספקי הערכת סיכונים.

טיפוסים בני מנייה (enum)
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED ערך ברירת המחדל כשלא צוין ספק.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.

RiskAssessment

הערכת סיכונים לתוסף ל-Chrome.

ייצוג ב-JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
שדות
assessment

string

הערכת הסיכון לתוסף. נכון לעכשיו, זהו ערך מספרי, והפרשנות שלו היא ספציפית לכל ספק של הערכת סיכונים.
detailsUrl

string

כתובת URL שהמשתמש יכול לעבור אליה כדי לקבל מידע נוסף על הערכת הסיכונים.
version

string

הגרסה של התוסף שההערכה הזו חלה עליה.

RiskLevel

רמת הסיכון של תוסף או אפליקציה, לפי קטגוריה.

טיפוסים בני מנייה (enum)
RISK_LEVEL_UNSPECIFIED לא צוינה רמת הסיכון.
RISK_LEVEL_LOW תוסף שמייצג סיכון נמוך.
RISK_LEVEL_MEDIUM תוסף שמייצג סיכון בינוני.
RISK_LEVEL_HIGH תוסף שמייצג סיכון גבוה.