REST Resource: customers.chromeBrowsers

Resource: ChromeBrowser

A device with managed Chrome Browsers.

JSON representation 
{
  "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
}
Fields
name

string

Identifier. Format: customers/{customerId}/chromeBrowsers/{browserPermanentId}
browserPermanentId

string

Output only. Unique identifier of Chrome Browser.
lastPolicyFetchTime

string (Timestamp format)

Output only. The time the last policy fetch succeeded on this device.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
osPlatform

string

Output only. Device Os platform.
osArchitecture

string

Output only. Device CPU architecture.
osVersion

string

Output only. Device Os Version.
machineName

string

Output only. Machine name.
annotatedLocation

string

Optional. Address or location of the device as annotated by the administrator.
annotatedUser

string

Optional. User of the device as annotated by the administrator.
annotatedAssetId

string

Optional. Asset identifier as annotated by the administrator or specified during enrollment.
annotatedNotes

string

Optional. Notes about this device as annotated by the administrator.
lastRegistrationTime

string (Timestamp format)

Output only. The time the device last tried to register.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
extensionCount

string (int64 format)

Output only. The number of distinct extensions installed on all the Chrome browsers of this device.
policyCount

string (int64 format)

Output only. The number of distinct policies set on all the Chrome browsers of this device.
lastDeviceUser

string

Output only. The last user who logged into a Chrome browser on this device.
lastActivityTime

string (Timestamp format)

Output only. The time of the last activity on the device device either from reporting, policy fetching or registration.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
osPlatformVersion

string

Output only. Device Os platform and version combined.
browserVersions[]

string

Output only. List of all browser versions installed on this device.
lastStatusReportTime

string (Timestamp format)

Output only. The time the device last sent a status report.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastDeviceUsers[]

object (BrowserUser)

Output only. List of recent browser users, in descending order by last report time.
machinePolicies[]

object (Policy)

Output only. The list of all device level policies set for Chrome browsers on this device.
browsers[]

object (Browser)

Output only. List of Chrome browsers installed on this device.
serialNumber

string

Output only. The device's serial number.
virtualDeviceId

string

Output only. The initial device id sent by the first Chrome browser that enrolled this device.
machineExtensionPolicies[]

object (ExtensionPolicy)

Output only. The list of all device level policies set for extensions installed in Chrome on this device.
orgUnitId

string

Output only. The obfuscated organizational unit ID of the browser.
deviceIdentifiersHistory

object (DeviceIdentifiersHistory)

Output only. The history of identifiers reported to this device.
attestationCredential

object (AttestationCredential)

Output only. The attestation credential used for Device Trust Connector.
omahaRecentFetchTime

string (Timestamp format)

Output only. Recent policy fetch activity by Omaha. Not necessarily the last fetch since this field is only updated daily.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

BrowserUser

A Chrome browser user.

JSON representation 
{
  "userName": string,
  "lastStatusReportTime": string
}
Fields
userName

string

Output only. The user name of the user that signed into chrome.
lastStatusReportTime

string (Timestamp format)

Output only. The time when this user info last reported a status.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

Policy

The applied policy reported by a managed Chrome browser. The policy can be applied at various scopes (machine, profile, extension).

JSON representation 
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
Fields
source

enum (PolicySource)

Output only. The source of the policy.
policyName

string

Output only. The name of the policy.
value

string

Output only. The value of the policy.
error

string

Output only. A localized string with all the errors reported when trying to apply this policy, if any.

Browser

A specific installation of Chrome on a device with managed Chrome browsers.

JSON representation 
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
Fields
browserVersion

string

Output only. Browser version installed.
channel

enum (Channel)

Output only. The channel of the browser installed.
lastStatusReportTime

string (Timestamp format)

Output only. The time when the last report was received from this Chrome browser.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastPolicyFetchTime

string (Timestamp format)

Output only. The time when the last request to fetch policies succeeded on this Chrome browser.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
executablePath

string

Output only. The path to the Chrome.exe executable for this browser.
plugins[]

object (Plugin)

Output only. List of all plugins installed on this Chrome browser.
profiles[]

object (Profile)

Output only. The list of profiles for this browser.
pendingInstallVersion

string

Output only. Pending version of a browser is installed. This field is only set when the current active browser has a different version as in "browserVersion".

Channel

Possible release channels of a browser.

Enums
CHANNEL_UNSPECIFIED Represents an unspecified channel.
CHANNEL_STABLE Represents a stable channel.
CHANNEL_BETA Represents a beta channel.
CHANNEL_DEV Represents a dev channel.
CHANNEL_CANARY Represents a canary channel.

Plugin

Information about a Chrome browser plugin installed on a reported Chrome installation on a device with managed Chrome browsers.

JSON representation 
{
  "pluginName": string,
  "description": string,
  "filename": string
}
Fields
pluginName

string

Output only. The name of the installed plugin.
description

string

Output only. The description of the installed plugin.
filename

string

Output only. The filename of the installed plugin.

Profile

A profile reported on an installation of Chrome on a device with managed chrome browsers.

JSON representation 
{
  "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
}
Fields
profileName

string

Output only. The name given to this profile.
id

string

Output only. A unique ID for this profile.
lastStatusReportTime

string (Timestamp format)

Output only. The time when the last report was received from this profile.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastPolicyFetchTime

string (Timestamp format)

Output only. The time when the last request to fetch policies succeeded for this profile.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
safeBrowsingWarnings

string (int64 format)

Output only. The number of safe browsing warnings that were shown on this profile.
safeBrowsingWarningsClickThroughs

string (int64 format)

Output only. The number of safe browsing warnings that were clicked through on this profile.
chromeSignedInUserEmail

string

Output only. The email of the user signed in to this profile, if any.
extensions[]

object (Extension)

Output only. The list of extensions installed for this profile.
userPolicies[]

object (Policy)

Output only. The list of Chrome browser policies applied to this profile.
extensionPolicies[]

object (ExtensionPolicy)

Output only. The list of extensions with applied extension policies.
safeBrowsingWarningsResetTime

string (Timestamp format)

Output only. The last time the safe browsing warning info was reset to 0.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

Extension

Information about extensions installed on profile reported on an installed Chrome on a device with managed chrome browsers.

JSON representation 
{
  "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
}
Fields
extensionId

string

Output only. The id of the extension.
version

string

Output only. The version of the extension.
permissions[]

string

Output only. The list of permissions required for this extension.
extensionName

string

Output only. The localized name of this extension as reported by Chrome.
description

string

Output only. The localized description of this extension.
appType

enum (ExtensionType)

Output only. The type of the extension.
homepageUri

string

Output only. The URL of the homepage for this extension.
installType

enum (InstallationType)

Output only. The way the extension was installed.
configuredAppPolicy

enum (ConfiguredAppPolicy)

Output only. If the extension is controlled by a browser policy.
disabled

boolean

Output only. Whether the extension is disabled.
icons[]

object (ExtensionIcon)

Output only. The list of icons available for this extension.
manifestVersion

integer

Output only. The manifest version of this extension.

ConfiguredAppPolicy

Possible configured app policies for an extension.

Enums
CONFIGURED_APP_POLICY_UNSPECIFIED Represents an unspecified configured app policy.
CONFIGURED_APP_POLICY_NONE Represents no configured app policy.
CONFIGURED_APP_POLICY_SHOULD_FORCE Represents an extension that should be forced.
CONFIGURED_APP_POLICY_SHOULD_BLOCK Represents an extension that should be blocked.

ExtensionIcon

An icon of a Chrome browser extension.

JSON representation 
{
  "size": integer,
  "uri": string
}
Fields
size

integer

Output only. The size of the extension icon.
uri

string

Output only. The URL to the extension icon.

ExtensionPolicy

The reported policies applied to an extension installed on a Chrome profile.

JSON representation 
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
Fields
extensionId

string

Output only. The id of the extension the policies are applied to.
extensionName

string

Output only. The name of the extension the policies are applied to.
policies[]

object (Policy)

Output only. List of policies applied to this extension.

DeviceIdentifiersHistory

History of device identifiers reported from a device.

JSON representation 
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
Fields
records[]

object (DeviceIdentifiersRecord)

Output only. List of device identifiers sent by this device. In descending order by lastActivityTime.
deviceIdCollision

boolean

Output only. The device id is potentially being used by multiple devices.
lastDeviceIdCollisionDetectionTime

string (Timestamp format)

Output only. The last time we detected the device id collision.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

DeviceIdentifiersRecord

Record of the device identifiers and when they were reported.

JSON representation 
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
Fields
identifiers

object (DeviceIdentifiers)

Output only. Device identifiers.
firstRecordTime

string (Timestamp format)

Output only. The first time these identifiers were reported.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastActivityTime

string (Timestamp format)

Output only. The time of the last activity of these identifiers either from reporting, policy fetching or registration.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

DeviceIdentifiers

Collection of device identifiers.

JSON representation 
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
Fields
machineName

string

Output only. The name of the machine associated with the device.
serialNumber

string

Output only. The device's serial number.
hostName

string

Output only. The device's host name.

Methods

delete

 Deletes the data collected from a Chrome browser profile.

get

 Retrieves a single Chrome Browser identified by its customer ID and resource ID.

list

 Retrieves all Chrome Browsers of a customer (paginated).

move

 Moves managed Chrome Browsers to a new Organizational Unit (OU).

patch

 Updates annotation information for a Chrome Browser.