Method: customers.reports.countInstalledApps

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

HTTP-запрос

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

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

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

Параметры
customer

string

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

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

Параметры
orgUnitId

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

  • имя_приложения
  • тип приложения
  • install_type
  • количество_разрешений
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • оценка риска
orderBy

string

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

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

  • имя_приложения
  • тип приложения
  • install_type
  • количество_разрешений
  • total_install_count
  • 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 )

Только для вывода. Если имеются, предоставьте данные оценки рисков, связанных с этим расширением.

AppInstalLightType

Способ установки приложения. Если не все установленные экземпляры этого приложения имеют одинаковый тип установки, то тип установки — МНОЖЕСТВЕННЫЙ.

Перечисления
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 )

Только выходные данные. Уровень риска, распределенный по группам, для оценки рисков.

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

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

Перечисления
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Значение по умолчанию, если поставщик не указан.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

Оценка риска

Оценка рисков для расширения 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 Расширение, представляющее высокий риск.
,

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

HTTP-запрос

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

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

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

Параметры
customer

string

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

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

Параметры
orgUnitId

string

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

pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

  • имя_приложения
  • тип приложения
  • install_type
  • количество_разрешений
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
  • manifest_versions
  • оценка риска
orderBy

string

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

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

  • имя_приложения
  • тип приложения
  • install_type
  • количество_разрешений
  • total_install_count
  • 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 )

Только для вывода. Если имеются, предоставьте данные оценки рисков, связанных с этим расширением.

AppInstalLightType

Способ установки приложения. Если не все установленные экземпляры этого приложения имеют одинаковый тип установки, то тип установки — МНОЖЕСТВЕННЫЙ.

Перечисления
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 )

Только выходные данные. Уровень риска, распределенный по группам, для оценки рисков.

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

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

Перечисления
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Значение по умолчанию, если поставщик не указан.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

Оценка риска

Оценка рисков для расширения 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 Расширение, представляющее высокий риск.