Method: customers.reports.countInstalledApps

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

HTTP-запрос

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

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

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

Параметры
customer

string

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

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

Параметры
orgUnitId

string

Идентификатор организационной единицы.

pageSize

integer

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

pageToken

string

Токен для указания страницы запроса, которая должна быть возвращена.

filter

string

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

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

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

  • имя_приложения
  • appType
  • тип_установки
  • количество_разрешений
  • общее_количество_установок
  • последняя_дата_активности_профиля
  • имя_разрешения
  • appId
  • manifest_versions
  • риск_оценка
orderBy

string

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

Поддерживаемый порядок по полям:

  • имя_приложения
  • appType
  • тип_установки
  • количество_разрешений
  • общее_количество_установок
  • appId
  • manifest_versions
  • риск_оценка

Текст запроса

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

Тело ответа

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

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

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

object ( InstalledApp )

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

nextPageToken

string

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

totalSize

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

string

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

appType

enum ( AppType )

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

browserDeviceCount

string ( int64 format)

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

osUserCount

string ( int64 format)

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

appInstallType

enum ( AppInstallType )

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

disabled

boolean

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

appSource

enum ( AppSource )

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

displayName

string

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

description

string

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

homepageUri

string

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

permissions[]

string

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

riskAssessment

object ( RiskAssessmentData )

Только вывод. Если доступно, данные оценки риска для этого расширения.

AppInstallType

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

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

AppSource

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

Перечисления
APP_SOURCE_UNSPECIFIED Источник приложения не указан.
CHROME_WEBSTORE Как правило, для расширений и приложений Chrome.
PLAY_STORE Приложение Play Store.

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

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

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

object ( RiskAssessmentEntry )

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

overallRiskLevel

enum ( RiskLevel )

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

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

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

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

enum ( RiskAssessmentProvider )

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

riskAssessment

object ( RiskAssessment )

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

riskLevel

enum ( RiskLevel )

Уровень риска, выделенный для оценки риска.

RiskAssessmentProvider

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

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

Оценка риска

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

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

string

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

detailsUrl

string

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

version

string

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

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

Уровень риска для расширения/приложения.

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