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ługiwana kolejność według pól:

  • 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 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 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 instalacji 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 administratora.
DEVELOPMENT Programistyczny typ instalacji aplikacji.
SIDELOAD Typ instalacji aplikacji zainstalowanej z poza sklepu.
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 W aplikacji Sklep Play.

RiskAssessmentData

dane o ocenie ryzyka dotyczące rozszerzenia lub aplikacji;

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

object (RiskAssessmentEntry)

Oceny indywidualnego ryzyka.
overallRiskLevel

enum (RiskLevel)

Ogólny oceniany poziom ryzyka we wszystkich wpisach. Będzie to najwyższy poziom ryzyka spośród wszystkich wpisów.

RiskAssessmentEntry

1 wpis oceny ryzyka.

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

enum (RiskAssessmentProvider)

Dostawca oceny ryzyka, od 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

dostawcy usług oceny 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.

RiskAssessment

Ocena ryzyka dla rozszerzenia do Chrome.

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

string

Ocena ryzyka dla rozszerzenia. Obecnie jest to wartość liczbowa, której interpretacja zależy od dostawcy oceny ryzyka.
detailsUrl

string

Adres URL, pod który użytkownik może przejść, aby 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 Nie podano poziomu ryzyka.
RISK_LEVEL_LOW Rozszerzenie o niskim ryzyku.
RISK_LEVEL_MEDIUM Rozszerzenie o średnim stopniu ryzyka.
RISK_LEVEL_HIGH rozszerzenie, które stwarza wysokie ryzyko;