Method: customers.reports.countInstalledApps

wygenerować raport 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. customer_id lub „my_customer” – do użycia klienta powiązanego z kontem, które wysyła żą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 rozdzielane znakiem AND w składni EBNF.

Uwaga: w tym filtrze nie można stosować operacji LUB.

Obsługiwane pola filtra:

  • 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 służące 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óły zapytanych zainstalowanych aplikacji.

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

Opis zainstalowanej aplikacji.

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 identyfikator o długości 32 znaków (np. ehoadneljpdggcbbknedodolkkjodefl). W przypadku aplikacji na Androida – nazwa pakietu (np. com.evernote).
appType

enum (AppType)

Tylko dane wyjściowe. Typ aplikacji.
browserDeviceCount

string (int64 format)

Tylko dane wyjściowe. Liczba przeglądarek, 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 zainstalowania aplikacji.
disabled

boolean

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

enum (AppSource)

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

string

Tylko dane wyjściowe. Nazwa zainstalowanej aplikacji.
description

string

Tylko dane wyjściowe. Opis zainstalowanej aplikacji.
homepageUri

string

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

string

Tylko dane wyjściowe. uprawnienia zainstalowanej aplikacji.
riskAssessment

object (RiskAssessmentData)

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

AppInstallType

Sposób zainstalowania aplikacji. Jeśli nie wszystkie wystąpienia zainstalowanej aplikacji mają ten sam typ instalacji, typ instalacji jest MULTIPLE.

Wartości w polu enum
APP_INSTALL_TYPE_UNSPECIFIED Nieokreślony typ instalacji aplikacji.
MULTIPLE Wiele typów instalacji aplikacji.
NORMAL Normalny typ instalacji aplikacji.
ADMIN Typ instalacji aplikacji przez administratora.
DEVELOPMENT Typ instalacji aplikacji deweloperskiej.
SIDELOAD Typ instalacji aplikacji zainstalowanej z urządzenia zewnętrznego.
OTHER Inny typ instalacji aplikacji.

AppSource

Źródło zainstalowanej aplikacji.

Wartości w polu enum
APP_SOURCE_UNSPECIFIED Źródło aplikacji nie zostało określone.
CHROME_WEBSTORE Zazwyczaj dotyczy to rozszerzeń i aplikacji Chrome.
PLAY_STORE Aplikacja 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 spośród wszystkich wpisów.

RiskAssessmentEntry

jeden wpis oceny ryzyka;

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

enum (RiskAssessmentProvider)

Dostawca oceny ryzyka, z którego pochodzi ten wpis.
riskAssessment

object (RiskAssessment)

Szczegóły oceny ryzyka przez dostawcę.
riskLevel

enum (RiskLevel)

Uporządkowany według przedziału poziom ryzyka w ocenie ryzyka.

RiskAssessmentProvider

dostawców oceny ryzyka;

Wartości w polu enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Wartość domyślna, gdy nie jest określony dostawca.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.

RiskAssessment

Ocena ryzyka dla rozszerzenia do Chrome.

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

string

Ocena ryzyka związana z rozszerzeniem. Obecnie jest to wartość liczbowa, której 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ę ocena.

RiskLevel

Podział poziomu ryzyka rozszerzenia lub aplikacji.

Wartości w polu enum
RISK_LEVEL_UNSPECIFIED Poziom ryzyka nie został określony.
RISK_LEVEL_LOW Rozszerzenie, które wiąże się z małym ryzykiem.
RISK_LEVEL_MEDIUM Rozszerzenie o średnim stopniu niebezpieczne.
RISK_LEVEL_HIGH Rozszerzenie, które wiąże się z wysokim ryzykiem.