Method: customers.reports.countInstalledApps

Generowanie raportu o instalacjach aplikacji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Wymagane. Identyfikator klienta lub „my_customer”, aby użyć klienta powiązanego z kontem, z którego wysłano żądanie.

Parametry zapytania

Parametry
orgUnitId

string

Identyfikator jednostki organizacyjnej.
pageSize

integer

Maksymalna liczba wyników do zwrócenia. Wartość maksymalna i domyślna to 100.
pageToken

string

Token określający stronę żądania, która ma zostać zwrócona.
filter

string

Ciąg zapytania do filtrowania wyników, pola rozdzielone operatorem AND w składni EBNF.

Uwaga: operacje OR nie są obsługiwane w tym filtrze.

Obsługiwane pola filtrów:

  • nazwa_aplikacji
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • risk_score
orderBy

string

Pole używane do sortowania wyników.

Obsługiwane pola sortowania:

  • nazwa_aplikacji
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca szczegółowe informacje o zainstalowanych aplikacjach, o które pytasz.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Pola
installedApps[]

object (InstalledApp)

Lista zainstalowanych aplikacji pasujących do żądania.
nextPageToken

string

Token określający następną stronę żądania.
totalSize

integer

Łączna liczba zainstalowanych aplikacji pasujących do żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

InstalledApp

Opisuje aplikację instalowaną.

Zapis 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)
  }
}
Pola
appId

string

Tylko dane wyjściowe. Unikalny identyfikator aplikacji. W przypadku aplikacji i rozszerzeń do Chrome jest to 32-znakowy identyfikator (np. ehoadneljpdggcbbknedodolkkjodefl). W przypadku aplikacji na Androida jest to nazwa pakietu (np. com.evernote).
appType

enum (AppType)

Tylko dane wyjściowe. Typ aplikacji.
browserDeviceCount

string (int64 format)

Tylko dane wyjściowe. Liczba urządzeń z przeglądarką, na których zainstalowano tę aplikację.
osUserCount

string (int64 format)

Tylko dane wyjściowe. Liczba użytkowników ChromeOS, którzy mają zainstalowaną tę aplikację.
appInstallType

enum (AppInstallType)

Tylko dane wyjściowe. Sposób instalacji aplikacji.
disabled

boolean

Tylko dane wyjściowe. Czy aplikacja jest wyłączona.
appSource

enum (AppSource)

Tylko dane wyjściowe. Źródło aplikacji instalowanej.
displayName

string

Tylko dane wyjściowe. Nazwa zainstalowanej aplikacji.
description

string

Tylko dane wyjściowe. Opis aplikacji instalowanej.
homepageUri

string

Tylko dane wyjściowe. Identyfikator URI strony głównej aplikacji instalowanej.
permissions[]

string

Tylko dane wyjściowe. uprawnienia aplikacji instalowanej;
riskAssessment

object (RiskAssessmentData)

Tylko dane wyjściowe. Jeśli są dostępne, dane oceny ryzyka dotyczące tego rozszerzenia.

AppInstallType

Sposób instalacji aplikacji. Jeśli nie wszystkie instancje tej aplikacji instalowanej mają ten sam typ instalacji, typ instalacji to MULTIPLE.

Wartości w polu enum
APP_INSTALL_TYPE_UNSPECIFIED Nie określono typu instalacji aplikacji.
MULTIPLE Wiele typów instalacji aplikacji.
NORMAL Typ instalacji aplikacji.
ADMIN Typ instalacji aplikacji przez administratora.
DEVELOPMENT Typ instalacji aplikacji w wersji deweloperskiej.
SIDELOAD Typ instalacji aplikacji wgranej z zewnątrz.
OTHER Inny typ instalacji aplikacji.

AppSource

Źródło aplikacji instalowanej.

Wartości w polu enum
APP_SOURCE_UNSPECIFIED Nie określono źródła aplikacji.
CHROME_WEBSTORE Zwykle w przypadku rozszerzeń i aplikacji Chrome.
PLAY_STORE aplikacji Sklep Play.

RiskAssessmentData

Dane oceny ryzyka dotyczące rozszerzenia lub aplikacji.

Zapis JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Pola
entries[]

object (RiskAssessmentEntry)

indywidualne oceny ryzyka;
overallRiskLevel

enum (RiskLevel)

Ogólny oceniony poziom ryzyka we wszystkich wpisach. Będzie to najwyższy poziom ryzyka ze wszystkich wpisów.

RiskAssessmentEntry

Jeden wpis oceny ryzyka.

Zapis JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Pola
provider

enum (RiskAssessmentProvider)

Tylko dane wyjściowe. Dostawca oceny ryzyka, od którego pochodzi ten wpis.
riskAssessment

object (RiskAssessment)

Tylko dane wyjściowe. Szczegóły oceny ryzyka dostawcy.
riskLevel

enum (RiskLevel)

Tylko dane wyjściowe. Poziom ryzyka w ocenie ryzyka.

RiskAssessmentProvider

dostawców ocen ryzyka;

Wartości w polu enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Wartość domyślna, gdy nie określono dostawcy.
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

Ocena ryzyka rozszerzenia do Chrome.

Zapis JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Pola
assessment

string

Ocena ryzyka związanego z rozszerzeniem. Obecnie jest to wartość liczbowa, a jej interpretacja zależy od dostawcy oceny ryzyka.
detailsUrl

string

Adres URL, pod którym użytkownik może uzyskać więcej informacji o ocenie ryzyka.
version

string

Wersja rozszerzenia, do której odnosi się ta ocena.

RiskLevel

Poziom ryzyka rozszerzenia lub aplikacji podzielony na kategorie.

Wartości w polu enum
RISK_LEVEL_UNSPECIFIED Nie określono poziomu ryzyka.
RISK_LEVEL_LOW Rozszerzenie, które wiąże się z niskim ryzykiem.
RISK_LEVEL_MEDIUM Rozszerzenie, które reprezentuje średnie ryzyko.
RISK_LEVEL_HIGH Rozszerzenie, które wiąże się z wysokim ryzykiem.