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 במסנן הזה.

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

  • שם_האפליקציה
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • risk_score
orderBy

string

השדה שמשמש לסידור התוצאות.

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

  • שם_האפליקציה
  • 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 סוג ההתקנה של אפליקציה שהועברה למכשיר בשיטת Sideloading.
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.
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

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

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