Method: customers.reports.countInstalledApps

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customer

string

חובה. מספר לקוח או "my_customer" כדי להשתמש בלקוח המשויך לחשבון שממנו נשלחה הבקשה.

פרמטרים של שאילתה

פרמטרים
orgUnitId

string

המזהה של היחידה הארגונית.
pageSize

integer

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

string

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

string

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

הערה: פעולות OR אינן נתמכות במסנן הזה.

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

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
orderBy

string

שדה המשמש להזמנת התוצאות.

סדר נתמך לפי שדות:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תשובה שמכילה פרטים על האפליקציות המותקנות שהשאילתות עליהן בוצעו.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג 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
  ]
}
שדות
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

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

AppInstallType

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

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

AppSource

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

טיפוסים בני מנייה (enums)
APP_SOURCE_UNSPECIFIED לא צוין מקור האפליקציה.
CHROME_WEBSTORE בדרך כלל לתוספים וליישומי Chrome.
PLAY_STORE באפליקציית חנות Play.