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 wysyłającym żą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óre ma zostać zwrócone.

filter

string

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

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

Obsługiwane pola filtrów:

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

string

Pole używane do sortowania wyników.

Obsługiwana kolejność według pól:

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca szczegóły dotyczące zainstalowanych aplikacji, których dotyczy zapytanie.

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 zainstalowaną aplikację.

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
  ]
}
Pola
appId

string

Tylko dane wyjściowe. Unikalny identyfikator aplikacji. W przypadku aplikacji Chrome 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 zainstalowaną aplikacją w przeglądarce.

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. Określa, 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.

AppInstallType

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

Wartości w polu enum
APP_INSTALL_TYPE_UNSPECIFIED Nie określono typu 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 pobranej z innego urządzenia.
OTHER Inny typ instalacji aplikacji.

AppSource

Źródło zainstalowanej aplikacji.

Wartości w polu enum
APP_SOURCE_UNSPECIFIED Nie podano źródła aplikacji.
CHROME_WEBSTORE Zasadniczo dotyczy to rozszerzeń i aplikacji Chrome.
PLAY_STORE W aplikacji Sklep Play.