Method: customers.reports.countInstalledApps

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customer

string

חובה. Customer id או '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 סוג ההתקנה של האפליקציה שהותקנה מחוץ לחנות.
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.

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 תוסף שמייצג סיכון גבוה.