---
title: "PATCH /v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}"
method: PATCH
path: "/v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}"
tags: ["customers"]
---

# PATCH /v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}

`PATCH /v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}`

## Request

- Base URL: `https://chromemanagement.googleapis.com`
- URL: `https://chromemanagement.googleapis.com/v1/customers/{customersId}/chromeBrowsers/{chromeBrowsersId}`
- Auth: none declared

Updates annotation information for a Chrome Browser.

## Path parameters

- `customersId` string, required
- `chromeBrowsersId` string, required

## Query parameters

- `updateMask` string, google-fieldmask

## Request body

- GoogleChromeManagementVersionsV1ChromeBrowser: A device with managed Chrome Browsers.
  - `annotatedAssetId` string: Optional. Asset identifier as annotated by the administrator or specified during enrollment.
  - `annotatedLocation` string: Optional. Address or location of the device as annotated by the administrator.
  - `annotatedNotes` string: Optional. Notes about this device as annotated by the administrator.
  - `annotatedUser` string: Optional. User of the device as annotated by the administrator.
  - `attestationCredential` GoogleChromeManagementVersionsV1AttestationCredential: Information of public key associated with a Chrome browser profile.
    - `keyRotationTime` string, google-datetime: Output only. Latest rotation timestamp of the public key rotation.
    - `keyTrustLevel` 'KEY_TRUST_LEVEL_UNSPECIFIED' | 'CHROME_BROWSER_HW_KEY' | 'CHROME_BROWSER_OS_KEY': Output only. Trust level of the public key.
    - `keyType` 'KEY_TYPE_UNSPECIFIED' | 'RSA_KEY' | 'EC_KEY': Output only. Type of the public key.
    - `publicKey` string, byte: Output only. Value of the public key.
  - `browserPermanentId` string: Output only. Unique identifier of Chrome Browser.
  - `browserVersions` string[]: Output only. List of all browser versions installed on this device.
  - `browsers` GoogleChromeManagementVersionsV1Browser[]: Output only. List of Chrome browsers installed on this device.
    - `browserVersion` string: Output only. Browser version installed.
    - `channel` 'CHANNEL_UNSPECIFIED' | 'CHANNEL_STABLE' | 'CHANNEL_BETA' | 'CHANNEL_DEV' | 'CHANNEL_CANARY': Output only. The channel of the browser installed.
    - `executablePath` string: Output only. The path to the Chrome.exe executable for this browser.
    - `lastPolicyFetchTime` string, google-datetime: Output only. The time when the last request to fetch policies succeeded on this Chrome browser.
    - `lastStatusReportTime` string, google-datetime: Output only. The time when the last report was received from this Chrome 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 "browser_version".
    - `plugins` GoogleChromeManagementVersionsV1Plugin[]: Output only. List of all plugins installed on this Chrome browser.
      - `description` string: Output only. The description of the installed plugin.
      - `filename` string: Output only. The filename of the installed plugin.
      - `pluginName` string: Output only. The name of the installed plugin.
    - `profiles` GoogleChromeManagementVersionsV1Profile[]: Output only. The list of profiles for this browser.
      - `chromeSignedInUserEmail` string: Output only. The email of the user signed in to this profile, if any.
      - `extensionPolicies` GoogleChromeManagementVersionsV1ExtensionPolicy[]: Output only. The list of extensions with applied extension policies.
        - `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` GoogleChromeManagementVersionsV1Policy[]: Output only. List of policies applied to this extension.
          - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
          - `policyName` string: Output only. The name of the policy.
          - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
          - `value` string: Output only. The value of the policy.
      - `extensions` GoogleChromeManagementVersionsV1Extension[]: Output only. The list of extensions installed for this profile.
        - `appType` 'EXTENSION_TYPE_UNSPECIFIED' | 'EXTENSION' | 'APP' | 'THEME' | 'HOSTED_APP': Output only. The type of the extension.
        - `configuredAppPolicy` 'CONFIGURED_APP_POLICY_UNSPECIFIED' | 'CONFIGURED_APP_POLICY_NONE' | 'CONFIGURED_APP_POLICY_SHOULD_FORCE' | 'CONFIGURED_APP_POLICY_SHOULD_BLOCK': Output only. If the extension is controlled by a browser policy.
        - `description` string: Output only. The localized description of this extension.
        - `disabled` boolean: Output only. Whether the extension is disabled.
        - `extensionId` string: Output only. The id of the extension.
        - `extensionName` string: Output only. The localized name of this extension as reported by Chrome.
        - `homepageUri` string: Output only. The URL of the homepage for this extension.
        - `icons` GoogleChromeManagementVersionsV1ExtensionIcon[]: Output only. The list of icons available for this extension.
          - `size` integer: Output only. The size of the extension icon.
          - `uri` string: Output only. The URL to the extension icon.
        - `installType` 'INSTALLATION_TYPE_UNSPECIFIED' | 'MULTIPLE' | 'NORMAL' | 'ADMIN' | 'DEVELOPMENT' | 'SIDELOAD' | 'OTHER': Output only. The way the extension was installed.
        - `manifestVersion` integer: Output only. The manifest version of this extension.
        - `permissions` string[]: Output only. The list of permissions required for this extension.
        - `version` string: Output only. The version of the extension.
      - `id` string: Output only. A unique ID for this profile.
      - `lastPolicyFetchTime` string, google-datetime: Output only. The time when the last request to fetch policies succeeded for this profile.
      - `lastStatusReportTime` string, google-datetime: Output only. The time when the last report was received from this profile.
      - `profileName` string: Output only. The name given to this profile.
      - `safeBrowsingWarnings` string, int64: Output only. The number of safe browsing warnings that were shown on this profile.
      - `safeBrowsingWarningsClickThroughs` string, int64: Output only. The number of safe browsing warnings that were clicked through on this profile.
      - `safeBrowsingWarningsResetTime` string, google-datetime: Output only. The last time the safe browsing warning info was reset to 0.
      - `userPolicies` GoogleChromeManagementVersionsV1Policy[]: Output only. The list of Chrome browser policies applied to this profile.
        - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
        - `policyName` string: Output only. The name of the policy.
        - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
        - `value` string: Output only. The value of the policy.
  - `deviceIdentifiersHistory` GoogleChromeManagementVersionsV1DeviceIdentifiersHistory: History of device identifiers reported from a device.
    - `deviceIdCollision` boolean: Output only. The device id is potentially being used by multiple devices.
    - `lastDeviceIdCollisionDetectionTime` string, google-datetime: Output only. The last time we detected the device id collision.
    - `records` GoogleChromeManagementVersionsV1DeviceIdentifiersRecord[]: Output only. List of device identifiers sent by this device. In descending order by last_activity_time.
      - `firstRecordTime` string, google-datetime: Output only. The first time these identifiers were reported.
      - `identifiers` GoogleChromeManagementVersionsV1DeviceIdentifiers: Collection of device identifiers.
        - `hostName` string: Output only. The device's host name.
        - `machineName` string: Output only. The name of the machine associated with the device.
        - `serialNumber` string: Output only. The device's serial number.
      - `lastActivityTime` string, google-datetime: Output only. The time of the last activity of these identifiers either from reporting, policy fetching or registration.
  - `extensionCount` string, int64: Output only. The number of distinct extensions installed on all the Chrome browsers of this device.
  - `lastActivityTime` string, google-datetime: Output only. The time of the last activity on the device device either from reporting, policy fetching or registration.
  - `lastDeviceUser` string: Output only. The last user who logged into a Chrome browser on this device.
  - `lastDeviceUsers` GoogleChromeManagementVersionsV1BrowserUser[]: Output only. List of recent browser users, in descending order by last report time.
    - `lastStatusReportTime` string, google-datetime: Output only. The time when this user info last reported a status.
    - `userName` string: Output only. The user name of the user that signed into chrome.
  - `lastPolicyFetchTime` string, google-datetime: Output only. The time the last policy fetch succeeded on this device.
  - `lastRegistrationTime` string, google-datetime: Output only. The time the device last tried to register.
  - `lastStatusReportTime` string, google-datetime: Output only. The time the device last sent a status report.
  - `machineExtensionPolicies` GoogleChromeManagementVersionsV1ExtensionPolicy[]: Output only. The list of all device level policies set for extensions installed in Chrome on this device.
    - `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` GoogleChromeManagementVersionsV1Policy[]: Output only. List of policies applied to this extension.
      - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
      - `policyName` string: Output only. The name of the policy.
      - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
      - `value` string: Output only. The value of the policy.
  - `machineName` string: Output only. Machine name.
  - `machinePolicies` GoogleChromeManagementVersionsV1Policy[]: Output only. The list of all device level policies set for Chrome browsers on this device.
    - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
    - `policyName` string: Output only. The name of the policy.
    - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
    - `value` string: Output only. The value of the policy.
  - `name` string: Identifier. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}
  - `omahaRecentFetchTime` string, google-datetime: Output only. Recent policy fetch activity by Omaha. Not necessarily the last fetch since this field is only updated daily.
  - `orgUnitId` string: Output only. The obfuscated organizational unit ID of the browser.
  - `osArchitecture` string: Output only. Device CPU architecture.
  - `osPlatform` string: Output only. Device Os platform.
  - `osPlatformVersion` string: Output only. Device Os platform and version combined.
  - `osVersion` string: Output only. Device Os Version.
  - `policyCount` string, int64: Output only. The number of distinct policies set on all the Chrome browsers of 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.

## Response `200`

Successful response

- GoogleChromeManagementVersionsV1ChromeBrowser: A device with managed Chrome Browsers.
  - `annotatedAssetId` string: Optional. Asset identifier as annotated by the administrator or specified during enrollment.
  - `annotatedLocation` string: Optional. Address or location of the device as annotated by the administrator.
  - `annotatedNotes` string: Optional. Notes about this device as annotated by the administrator.
  - `annotatedUser` string: Optional. User of the device as annotated by the administrator.
  - `attestationCredential` GoogleChromeManagementVersionsV1AttestationCredential: Information of public key associated with a Chrome browser profile.
    - `keyRotationTime` string, google-datetime: Output only. Latest rotation timestamp of the public key rotation.
    - `keyTrustLevel` 'KEY_TRUST_LEVEL_UNSPECIFIED' | 'CHROME_BROWSER_HW_KEY' | 'CHROME_BROWSER_OS_KEY': Output only. Trust level of the public key.
    - `keyType` 'KEY_TYPE_UNSPECIFIED' | 'RSA_KEY' | 'EC_KEY': Output only. Type of the public key.
    - `publicKey` string, byte: Output only. Value of the public key.
  - `browserPermanentId` string: Output only. Unique identifier of Chrome Browser.
  - `browserVersions` string[]: Output only. List of all browser versions installed on this device.
  - `browsers` GoogleChromeManagementVersionsV1Browser[]: Output only. List of Chrome browsers installed on this device.
    - `browserVersion` string: Output only. Browser version installed.
    - `channel` 'CHANNEL_UNSPECIFIED' | 'CHANNEL_STABLE' | 'CHANNEL_BETA' | 'CHANNEL_DEV' | 'CHANNEL_CANARY': Output only. The channel of the browser installed.
    - `executablePath` string: Output only. The path to the Chrome.exe executable for this browser.
    - `lastPolicyFetchTime` string, google-datetime: Output only. The time when the last request to fetch policies succeeded on this Chrome browser.
    - `lastStatusReportTime` string, google-datetime: Output only. The time when the last report was received from this Chrome 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 "browser_version".
    - `plugins` GoogleChromeManagementVersionsV1Plugin[]: Output only. List of all plugins installed on this Chrome browser.
      - `description` string: Output only. The description of the installed plugin.
      - `filename` string: Output only. The filename of the installed plugin.
      - `pluginName` string: Output only. The name of the installed plugin.
    - `profiles` GoogleChromeManagementVersionsV1Profile[]: Output only. The list of profiles for this browser.
      - `chromeSignedInUserEmail` string: Output only. The email of the user signed in to this profile, if any.
      - `extensionPolicies` GoogleChromeManagementVersionsV1ExtensionPolicy[]: Output only. The list of extensions with applied extension policies.
        - `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` GoogleChromeManagementVersionsV1Policy[]: Output only. List of policies applied to this extension.
          - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
          - `policyName` string: Output only. The name of the policy.
          - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
          - `value` string: Output only. The value of the policy.
      - `extensions` GoogleChromeManagementVersionsV1Extension[]: Output only. The list of extensions installed for this profile.
        - `appType` 'EXTENSION_TYPE_UNSPECIFIED' | 'EXTENSION' | 'APP' | 'THEME' | 'HOSTED_APP': Output only. The type of the extension.
        - `configuredAppPolicy` 'CONFIGURED_APP_POLICY_UNSPECIFIED' | 'CONFIGURED_APP_POLICY_NONE' | 'CONFIGURED_APP_POLICY_SHOULD_FORCE' | 'CONFIGURED_APP_POLICY_SHOULD_BLOCK': Output only. If the extension is controlled by a browser policy.
        - `description` string: Output only. The localized description of this extension.
        - `disabled` boolean: Output only. Whether the extension is disabled.
        - `extensionId` string: Output only. The id of the extension.
        - `extensionName` string: Output only. The localized name of this extension as reported by Chrome.
        - `homepageUri` string: Output only. The URL of the homepage for this extension.
        - `icons` GoogleChromeManagementVersionsV1ExtensionIcon[]: Output only. The list of icons available for this extension.
          - `size` integer: Output only. The size of the extension icon.
          - `uri` string: Output only. The URL to the extension icon.
        - `installType` 'INSTALLATION_TYPE_UNSPECIFIED' | 'MULTIPLE' | 'NORMAL' | 'ADMIN' | 'DEVELOPMENT' | 'SIDELOAD' | 'OTHER': Output only. The way the extension was installed.
        - `manifestVersion` integer: Output only. The manifest version of this extension.
        - `permissions` string[]: Output only. The list of permissions required for this extension.
        - `version` string: Output only. The version of the extension.
      - `id` string: Output only. A unique ID for this profile.
      - `lastPolicyFetchTime` string, google-datetime: Output only. The time when the last request to fetch policies succeeded for this profile.
      - `lastStatusReportTime` string, google-datetime: Output only. The time when the last report was received from this profile.
      - `profileName` string: Output only. The name given to this profile.
      - `safeBrowsingWarnings` string, int64: Output only. The number of safe browsing warnings that were shown on this profile.
      - `safeBrowsingWarningsClickThroughs` string, int64: Output only. The number of safe browsing warnings that were clicked through on this profile.
      - `safeBrowsingWarningsResetTime` string, google-datetime: Output only. The last time the safe browsing warning info was reset to 0.
      - `userPolicies` GoogleChromeManagementVersionsV1Policy[]: Output only. The list of Chrome browser policies applied to this profile.
        - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
        - `policyName` string: Output only. The name of the policy.
        - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
        - `value` string: Output only. The value of the policy.
  - `deviceIdentifiersHistory` GoogleChromeManagementVersionsV1DeviceIdentifiersHistory: History of device identifiers reported from a device.
    - `deviceIdCollision` boolean: Output only. The device id is potentially being used by multiple devices.
    - `lastDeviceIdCollisionDetectionTime` string, google-datetime: Output only. The last time we detected the device id collision.
    - `records` GoogleChromeManagementVersionsV1DeviceIdentifiersRecord[]: Output only. List of device identifiers sent by this device. In descending order by last_activity_time.
      - `firstRecordTime` string, google-datetime: Output only. The first time these identifiers were reported.
      - `identifiers` GoogleChromeManagementVersionsV1DeviceIdentifiers: Collection of device identifiers.
        - `hostName` string: Output only. The device's host name.
        - `machineName` string: Output only. The name of the machine associated with the device.
        - `serialNumber` string: Output only. The device's serial number.
      - `lastActivityTime` string, google-datetime: Output only. The time of the last activity of these identifiers either from reporting, policy fetching or registration.
  - `extensionCount` string, int64: Output only. The number of distinct extensions installed on all the Chrome browsers of this device.
  - `lastActivityTime` string, google-datetime: Output only. The time of the last activity on the device device either from reporting, policy fetching or registration.
  - `lastDeviceUser` string: Output only. The last user who logged into a Chrome browser on this device.
  - `lastDeviceUsers` GoogleChromeManagementVersionsV1BrowserUser[]: Output only. List of recent browser users, in descending order by last report time.
    - `lastStatusReportTime` string, google-datetime: Output only. The time when this user info last reported a status.
    - `userName` string: Output only. The user name of the user that signed into chrome.
  - `lastPolicyFetchTime` string, google-datetime: Output only. The time the last policy fetch succeeded on this device.
  - `lastRegistrationTime` string, google-datetime: Output only. The time the device last tried to register.
  - `lastStatusReportTime` string, google-datetime: Output only. The time the device last sent a status report.
  - `machineExtensionPolicies` GoogleChromeManagementVersionsV1ExtensionPolicy[]: Output only. The list of all device level policies set for extensions installed in Chrome on this device.
    - `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` GoogleChromeManagementVersionsV1Policy[]: Output only. List of policies applied to this extension.
      - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
      - `policyName` string: Output only. The name of the policy.
      - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
      - `value` string: Output only. The value of the policy.
  - `machineName` string: Output only. Machine name.
  - `machinePolicies` GoogleChromeManagementVersionsV1Policy[]: Output only. The list of all device level policies set for Chrome browsers on this device.
    - `error` string: Output only. A localized string with all the errors reported when trying to apply this policy, if any.
    - `policyName` string: Output only. The name of the policy.
    - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. The source of the policy.
    - `value` string: Output only. The value of the policy.
  - `name` string: Identifier. Format: customers/{customer_id}/chromeBrowsers/{browser_permanent_id}
  - `omahaRecentFetchTime` string, google-datetime: Output only. Recent policy fetch activity by Omaha. Not necessarily the last fetch since this field is only updated daily.
  - `orgUnitId` string: Output only. The obfuscated organizational unit ID of the browser.
  - `osArchitecture` string: Output only. Device CPU architecture.
  - `osPlatform` string: Output only. Device Os platform.
  - `osPlatformVersion` string: Output only. Device Os platform and version combined.
  - `osVersion` string: Output only. Device Os Version.
  - `policyCount` string, int64: Output only. The number of distinct policies set on all the Chrome browsers of 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.

---

[API](https://skmtc.dev/google/apis/chromemanagement.md) - [All operations](https://skmtc.dev/google/apis/chromemanagement/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chromemanagement/revisions/872a15abbbd0?raw)
