REST Resource: customers.chromeBrowsers

Источник: ChromeBrowser

Устройство с управляемыми браузерами Chrome.

JSON-представление 
{
  "name": string,
  "browserPermanentId": string,
  "lastPolicyFetchTime": string,
  "osPlatform": string,
  "osArchitecture": string,
  "osVersion": string,
  "machineName": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "annotatedAssetId": string,
  "annotatedNotes": string,
  "lastRegistrationTime": string,
  "extensionCount": string,
  "policyCount": string,
  "lastDeviceUser": string,
  "lastActivityTime": string,
  "osPlatformVersion": string,
  "browserVersions": [
    string
  ],
  "lastStatusReportTime": string,
  "lastDeviceUsers": [
    {
      object (BrowserUser)
    }
  ],
  "machinePolicies": [
    {
      object (Policy)
    }
  ],
  "browsers": [
    {
      object (Browser)
    }
  ],
  "serialNumber": string,
  "virtualDeviceId": string,
  "machineExtensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "orgUnitId": string,
  "deviceIdentifiersHistory": {
    object (DeviceIdentifiersHistory)
  },
  "attestationCredential": {
    object (AttestationCredential)
  },
  "omahaRecentFetchTime": string
}
Поля
name

string

Идентификатор. Формат: customers/{customerId}/chromeBrowsers/{browserPermanentId}

browserPermanentId

string

Только вывод. Уникальный идентификатор браузера Chrome.

lastPolicyFetchTime

string ( Timestamp format)

Только вывод. Время, когда последняя загрузка политики на этом устройстве прошла успешно.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

osPlatform

string

Только вывод. Платформа ОС устройства.

osArchitecture

string

Только вывод. Архитектура ЦП устройства.

osVersion

string

Только вывод. Версия ОС устройства.

machineName

string

Только вывод. Имя машины.

annotatedLocation

string

Необязательно. Адрес или местоположение устройства, указанные администратором.

annotatedUser

string

Необязательно. Пользователь устройства, указанный администратором.

annotatedAssetId

string

Необязательно. Идентификатор актива, указанный администратором или заданный при регистрации.

annotatedNotes

string

Необязательно. Примечания к данному устройству, внесенные администратором.

lastRegistrationTime

string ( Timestamp format)

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

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

extensionCount

string ( int64 format)

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

policyCount

string ( int64 format)

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

lastDeviceUser

string

Только вывод. Последний пользователь, вошедший в браузер Chrome на этом устройстве.

lastActivityTime

string ( Timestamp format)

Только вывод. Время последней активности на устройстве (отчетность, получение политик или регистрация).

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

osPlatformVersion

string

Только вывод. Платформа и версия операционной системы устройства объединены.

browserVersions[]

string

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

lastStatusReportTime

string ( Timestamp format)

Только вывод. Время, когда устройство в последний раз отправило отчет о состоянии.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastDeviceUsers[]

object ( BrowserUser )

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

machinePolicies[]

object ( Policy )

Только вывод. Список всех политик уровня устройства, установленных для браузеров Chrome на этом устройстве.

browsers[]

object ( Browser )

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

serialNumber

string

Только вывод. Серийный номер устройства.

virtualDeviceId

string

Только вывод. Первоначальный идентификатор устройства, отправленный первым браузером Chrome, который зарегистрировал это устройство.

machineExtensionPolicies[]

object ( ExtensionPolicy )

Только вывод. Список всех политик уровня устройства, установленных для расширений Chrome на этом устройстве.

orgUnitId

string

Только вывод. Зашифрованный идентификатор организационного подразделения браузера.

deviceIdentifiersHistory

object ( DeviceIdentifiersHistory )

Только вывод. История идентификаторов, переданных этому устройству.

attestationCredential

object ( AttestationCredential )

Только для вывода. Учетные данные для аттестации, используемые для Device Trust Connector.

omahaRecentFetchTime

string ( Timestamp format)

Только вывод. Последние данные о запросах на получение информации о политиках от Omaha. Не обязательно последние запросы, поскольку это поле обновляется только ежедневно.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

BrowserUser

Пользователь браузера Chrome.

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

string

Только вывод. Имя пользователя, вошедшего в Chrome.

lastStatusReportTime

string ( Timestamp format)

Только вывод. Время, когда информация о данном пользователе в последний раз сообщала о каком-либо статусе.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Политика

Политика, применяемая управляемым браузером Chrome. Политика может применяться на различных уровнях (компьютер, профиль, расширение).

JSON-представление 
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
Поля
source

enum ( PolicySource )

Только выходные данные. Источник политики.

policyName

string

Только вывод. Название политики.

value

string

Только результат. Ценность полиса.

error

string

Только вывод. Локализованная строка со всеми ошибками, которые были обнаружены при попытке применения этой политики, если таковые имелись.

Браузер

Конкретная установка Chrome на устройстве с управляемыми браузерами Chrome.

JSON-представление 
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
Поля
browserVersion

string

Только вывод. Установлена ​​версия браузера.

channel

enum ( Channel )

Только вывод. Установленный канал браузера.

lastStatusReportTime

string ( Timestamp format)

Только вывод. Время получения последнего отчета из этого браузера Chrome.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastPolicyFetchTime

string ( Timestamp format)

Только вывод. Время, когда последний запрос на получение политик был успешно выполнен в этом браузере Chrome.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

executablePath

string

Только вывод. Путь к исполняемому файлу Chrome.exe для этого браузера.

plugins[]

object ( Plugin )

Только вывод. Список всех плагинов, установленных в этом браузере Chrome.

profiles[]

object ( Profile )

Только вывод. Список профилей для этого браузера.

pendingInstallVersion

string

Только для вывода. Установлена ​​ожидающая версия браузера. Это поле заполняется только в том случае, если у текущего активного браузера другая версия, отличная от "browserVersion".

Канал

Возможные каналы распространения браузера.

Перечисления
CHANNEL_UNSPECIFIED Представляет собой неуказанный канал.
CHANNEL_STABLE Представляет собой стабильный канал.
CHANNEL_BETA Представляет собой бета-канал.
CHANNEL_DEV Представляет собой канал для разработчиков.
CHANNEL_CANARY Изображает канарейку.

Плагин

Информация об установленном плагине для браузера Chrome на устройстве с поддержкой управляемых браузеров Chrome.

JSON-представление 
{
  "pluginName": string,
  "description": string,
  "filename": string
}
Поля
pluginName

string

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

description

string

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

filename

string

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

Профиль

В результате анализа профиля было обнаружено, что браузер Chrome установлен на устройстве с поддержкой управляемых браузеров Chrome.

JSON-представление 
{
  "profileName": string,
  "id": string,
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "safeBrowsingWarnings": string,
  "safeBrowsingWarningsClickThroughs": string,
  "chromeSignedInUserEmail": string,
  "extensions": [
    {
      object (Extension)
    }
  ],
  "userPolicies": [
    {
      object (Policy)
    }
  ],
  "extensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "safeBrowsingWarningsResetTime": string
}
Поля
profileName

string

Только для вывода. Название, присвоенное этому профилю.

id

string

Только для вывода. Уникальный идентификатор для этого профиля.

lastStatusReportTime

string ( Timestamp format)

Только выходные данные. Время получения последнего отчета от этого профиля.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastPolicyFetchTime

string ( Timestamp format)

Только вывод. Время, когда последний запрос на получение политик для этого профиля был успешно выполнен.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

safeBrowsingWarnings

string ( int64 format)

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

safeBrowsingWarningsClickThroughs

string ( int64 format)

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

chromeSignedInUserEmail

string

Только вывод. Адрес электронной почты пользователя, вошедшего в систему под этим профилем, если таковой имеется.

extensions[]

object ( Extension )

Только вывод. Список расширений, установленных для этого профиля.

userPolicies[]

object ( Policy )

Только вывод. Список политик браузера Chrome, применяемых к этому профилю.

extensionPolicies[]

object ( ExtensionPolicy )

Только вывод. Список расширений с примененными политиками расширений.

safeBrowsingWarningsResetTime

string ( Timestamp format)

Только вывод. В последний раз предупреждение о безопасном просмотре было сброшено до 0.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Расширение

Информация об установленных расширениях в профиле отображается в установленном браузере Chrome на устройстве с поддержкой управляемых браузеров Chrome.

JSON-представление 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "extensionName": string,
  "description": string,
  "appType": enum (ExtensionType),
  "homepageUri": string,
  "installType": enum (InstallationType),
  "configuredAppPolicy": enum (ConfiguredAppPolicy),
  "disabled": boolean,
  "icons": [
    {
      object (ExtensionIcon)
    }
  ],
  "manifestVersion": integer
}
Поля
extensionId

string

Только вывод. Идентификатор расширения.

version

string

Только вывод. Версия расширения.

permissions[]

string

Только вывод. Список разрешений, необходимых для этого расширения.

extensionName

string

Только вывод. Локализованное название этого расширения, как его сообщает Chrome.

description

string

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

appType

enum ( ExtensionType )

Только вывод. Тип расширения.

homepageUri

string

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

installType

enum ( InstallationType )

Только вывод. Способ установки расширения.

configuredAppPolicy

enum ( ConfiguredAppPolicy )

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

disabled

boolean

Только вывод. Указывает, отключено ли расширение.

icons[]

object ( ExtensionIcon )

Только для вывода. Список значков, доступных для этого расширения.

manifestVersion

integer

Только вывод. Версия манифеста этого расширения.

ConfiguredAppPolicy

Возможные настройки политик приложения для расширения.

Перечисления
CONFIGURED_APP_POLICY_UNSPECIFIED Представляет собой неуказанную настроенную политику приложения.
CONFIGURED_APP_POLICY_NONE Отображает отсутствие настроенной политики приложения.
CONFIGURED_APP_POLICY_SHOULD_FORCE Представляет собой расширение, которое следует принудительно установить.
CONFIGURED_APP_POLICY_SHOULD_BLOCK Обозначает расширение, которое следует заблокировать.

ExtensionIcon

Значок расширения для браузера Chrome.

JSON-представление 
{
  "size": integer,
  "uri": string
}
Поля
size

integer

Только для вывода. Размер значка расширения.

uri

string

Только вывод. URL-адрес значка расширения.

Политика расширения

Указанные правила применялись к расширению, установленному в профиле Chrome.

JSON-представление 
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
Поля
extensionId

string

Только вывод. Идентификатор расширения, к которому применяются политики.

extensionName

string

Только вывод. Название расширения, к которому применяются политики.

policies[]

object ( Policy )

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

История идентификаторов устройств

История идентификаторов устройства, полученных от устройства.

JSON-представление 
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
Поля
records[]

object ( DeviceIdentifiersRecord )

Только вывод. Список идентификаторов устройств, отправленных этим устройством. В порядке убывания по времени последней активности.

deviceIdCollision

boolean

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

lastDeviceIdCollisionDetectionTime

string ( Timestamp format)

Только вывод. Последнее обнаружение конфликта идентификаторов устройств.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

DeviceIdentifiersRecord

Запись идентификаторов устройств и времени их предоставления.

JSON-представление 
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
Поля
identifiers

object ( DeviceIdentifiers )

Только вывод. Идентификаторы устройств.

firstRecordTime

string ( Timestamp format)

Только для вывода. Впервые эти идентификаторы были зарегистрированы.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lastActivityTime

string ( Timestamp format)

Только для вывода. Время последней активности этих идентификаторов, будь то в процессе формирования отчетов, получения политик или регистрации.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Идентификаторы устройств

Сборник идентификаторов устройств.

JSON-представление 
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
Поля
machineName

string

Только вывод. Название машины, связанной с устройством.

serialNumber

string

Только вывод. Серийный номер устройства.

hostName

string

Только вывод. Имя хоста устройства.

Методы

delete

 Удаляет данные, собранные из профиля браузера Chrome.

get

 Получает информацию об одном браузере Chrome, идентифицированном по его идентификатору клиента и идентификатору ресурса.

list

 Получает список всех браузеров Chrome, используемых клиентом (с постраничной навигацией).

move

 Переместил управляемые браузеры Chrome в новое организационное подразделение (OU).

patch

 Обновляет информацию об аннотациях для браузера Chrome.