Method: customers.reports.countInstalledApps

Создать отчет об установках приложений.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customer

string

Необходимый. Идентификатор клиента или «my_customer», чтобы использовать клиента, связанного с учетной записью, делающей запрос.

Параметры запроса

Параметры
org Unit Id

string

Идентификатор организационного подразделения.

page Size

integer

Максимальное количество возвращаемых результатов. Максимум и значение по умолчанию — 100.

page Token

string

Токен для указания страницы возвращаемого запроса.

filter

string

Строка запроса для фильтрации результатов, поля, разделенные И, в синтаксисе EBNF.

Примечание. Операции ИЛИ не поддерживаются в этом фильтре.

Поддерживаемые поля фильтра:

  • имя_приложения
  • Тип приложения
  • тип_установки
  • число_разрешений
  • total_install_count
  • последняя_профиль_активная_дата
  • имя_разрешения
  • идентификатор приложения
  • манифест_версии
  • Risk_score
order By

string

Поле, используемое для упорядочивания результатов.

Поддерживается порядок по полям:

  • имя_приложения
  • Тип приложения
  • тип_установки
  • число_разрешений
  • total_install_count
  • идентификатор приложения
  • манифест_версии
  • Risk_score

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ, содержащий сведения о запрошенных установленных приложениях.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "installedApps": [
    {
      object (InstalledApp)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Поля
installed Apps[]

object ( InstalledApp )

Список установленных приложений, соответствующих запросу.

next Page Token

string

Токен для указания следующей страницы запроса.

total Size

integer

Общее количество установленных приложений, соответствующих запросу.

Области авторизации

Требуется следующая область действия OAuth:

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

Установленное приложение

Описывает установленное приложение.

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)
  }
}
Поля
app Id

string

Только вывод. Уникальный идентификатор приложения. Для приложений и расширений Chrome — 32-значный идентификатор (например, ehoadneljpdggcbbknedodolkkjodefl). Для приложений Android — имя пакета (например, com.evernote).

app Type

enum ( AppType )

Только вывод. Тип приложения.

browser Device Count

string ( int64 format)

Только вывод. Количество браузерных устройств, на которых установлено это приложение.

os User Count

string ( int64 format)

Только вывод. Количество пользователей ChromeOS, у которых установлено это приложение.

app Install Type

enum ( AppInstallType )

Только вывод. Как было установлено приложение.

disabled

boolean

Только вывод. Отключено ли приложение.

app Source

enum ( AppSource )

Только вывод. Источник установленного приложения.

display Name

string

Только вывод. Название установленного приложения.

description

string

Только вывод. Описание установленного приложения.

homepage Uri

string

Только вывод. URI домашней страницы установленного приложения.

permissions[]

string

Только вывод. Разрешения установленного приложения.

risk Assessment

object ( RiskAssessmentData )

Только вывод. При наличии данные оценки риска для этого расширения.

AppInstallType

Как было установлено приложение. Если не все экземпляры этого установленного приложения имеют один и тот же тип установки, то тип установки — НЕСКОЛЬКО.

Перечисления
APP_INSTALL_TYPE_UNSPECIFIED Не указан тип установки приложения.
MULTIPLE Несколько типов установки приложений.
NORMAL Обычный тип установки приложения.
ADMIN Тип установки приложения администратора.
DEVELOPMENT Тип установки приложения для разработки.
SIDELOAD Тип установки неопубликованного приложения.
OTHER Другой тип установки приложения.

Источник приложения

Источник установленного приложения.

Перечисления
APP_SOURCE_UNSPECIFIED Источник приложения не указан.
CHROME_WEBSTORE Обычно для расширений и приложений Chrome.
PLAY_STORE Приложение Play Маркет.

Данные об оценке риска

Данные оценки риска для расширения/приложения.

JSON-представление 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Поля
entries[]

object ( RiskAssessmentEntry )

Индивидуальная оценка рисков.

overall Risk Level

enum ( RiskLevel )

Общий оцененный уровень риска по всем записям. Это будет самый высокий уровень риска из всех входов.

Оценка рискаВвод

Одна запись об оценке риска.

JSON-представление 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Поля
provider

enum ( RiskAssessmentProvider )

Поставщик оценки рисков, от которого поступила эта запись.

risk Assessment

object ( RiskAssessment )

Подробности оценки риска поставщика.

risk Level

enum ( RiskLevel )

Классифицированный уровень риска для оценки риска.

Поставщик оценки риска

Поставщики услуг по оценке рисков.

Перечисления
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Значение по умолчанию, если поставщик не указан.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXкаватор.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Спин.Ай.

Оценка риска

Оценка рисков для расширения Chrome.

JSON-представление 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Поля
assessment

string

Оценка рисков для расширения. В настоящее время это числовое значение, и его интерпретация индивидуальна для каждого поставщика услуг по оценке рисков.

details Url

string

URL-адрес, по которому пользователь может перейти для получения дополнительной информации об оценке риска.

version

string

Версия расширения, к которой применяется эта оценка.

Уровень риска

Сгруппированный уровень риска для расширения/приложения.

Перечисления
RISK_LEVEL_UNSPECIFIED Уровень риска не указан.
RISK_LEVEL_LOW Расширение, представляющее низкий риск.
RISK_LEVEL_MEDIUM Расширение, представляющее средний риск.
RISK_LEVEL_HIGH Расширение, представляющее высокий риск.