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
  • manifest_versions
orderBy

string

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

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

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

גוף הבקשה

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

גוף התשובה

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

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

ייצוג 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 תווים (למשל, ehoadneljpdggcbbknedolkmjodefl). באפליקציות ל-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.

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

AppSource

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

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