## Resource: Device

A Device within the Cloud Identity Devices API.

Represents a `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#Device` known to Google Cloud, independent of the device ownership, type, and whether it is assigned or in use by a user.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "lastSyncTime": string, "ownerType": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#DeviceOwnership`), "model": string, "osVersion": string, "deviceType": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#DeviceType`), "serialNumber": string, "assetTag": string, "imei": string, "meid": string, "wifiMacAddresses": [ string ], "networkOperator": string, "manufacturer": string, "releaseVersion": string, "brand": string, "buildNumber": string, "kernelVersion": string, "basebandVersion": string, "enabledDeveloperOptions": boolean, "otherAccounts": [ string ], "enabledUsbDebugging": boolean, "securityPatchTime": string, "bootloaderVersion": string, "encryptionState": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#EncryptionState`), "androidSpecificAttributes": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#AndroidAttributes`) }, "managementState": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#ManagementState`), "compromisedState": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CompromisedState`), "deviceId": string, "unifiedDeviceId": string, "endpointVerificationSpecificAttributes": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#EndpointVerificationSpecificAttributes`) }, "hostname": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the Device in format: `devices/{device}`, where device is the unique id assigned to the Device. Important: Device API scopes require that you use domain-wide delegation to access the API. For more information, see [Set up the Devices API](https://cloud.google.com/identity/docs/how-to/setup-devices). |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. When the Company-Owned device was imported. This field is empty for BYOD devices. 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"`. |
| `lastSyncTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Most recent time when device synced with this service. 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"`. |
| `ownerType` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#DeviceOwnership`)`` Output only. Whether the device is owned by the company or an individual |
| `model` | `string` Output only. Model name of device. Example: Pixel 3. |
| `osVersion` | `string` Output only. OS version of the device. Example: Android 8.1.0. |
| `deviceType` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#DeviceType`)`` Output only. Type of device. |
| `serialNumber` | `string` Serial Number of device. Example: HT82V1A01076. |
| `assetTag` | `string` Asset tag of the device. |
| `imei` | `string` Output only. IMEI number of device if GSM device; empty otherwise. |
| `meid` | `string` Output only. MEID number of device if CDMA device; empty otherwise. |
| `wifiMacAddresses[]` | `string` WiFi MAC addresses of device. |
| `networkOperator` | `string` Output only. Mobile or network operator of device, if available. |
| `manufacturer` | `string` Output only. Device manufacturer. Example: Motorola. |
| `releaseVersion` | `string` Output only. OS release version. Example: 6.0. |
| `brand` | `string` Output only. Device brand. Example: Samsung. |
| `buildNumber` | `string` Output only. Build number of the device. |
| `kernelVersion` | `string` Output only. Kernel version of the device. |
| `basebandVersion` | `string` Output only. Baseband version of the device. |
| `enabledDeveloperOptions` | `boolean` Output only. Whether developer options is enabled on device. |
| `otherAccounts[]` | `string` Output only. Domain name for Google accounts on device. Type for other accounts on device. On Android, will only be populated if \|ownershipPrivilege\| is \|PROFILE_OWNER\| or \|DEVICE_OWNER\|. Does not include the account signed in to the device policy app if that account's domain has only one account. Examples: "com.example", "xyz.com". |
| `enabledUsbDebugging` | `boolean` Output only. Whether USB debugging is enabled on device. |
| `securityPatchTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. OS security patch update time on 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"`. |
| `bootloaderVersion` | `string` Output only. Device bootloader version. Example: 0.6.7. |
| `encryptionState` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#EncryptionState`)`` Output only. Device encryption state. |
| `androidSpecificAttributes` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#AndroidAttributes`)`` Output only. Attributes specific to Android devices. |
| `managementState` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#ManagementState`)`` Output only. Management state of the device |
| `compromisedState` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CompromisedState`)`` Output only. Represents whether the Device is compromised. |
| `deviceId` | `string` Unique identifier for the device. |
| `unifiedDeviceId` | `string` Output only. Unified device id of the device. |
| `endpointVerificationSpecificAttributes` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#EndpointVerificationSpecificAttributes`)`` Output only. Attributes specific to [Endpoint Verification](https://cloud.google.com/endpoint-verification/docs/overview) devices. |
| `hostname` | `string` Host name of the device. |

## DeviceOwnership

Possible owners of the device: Company or individual

| Enums ||
|---|---|
| `DEVICE_OWNERSHIP_UNSPECIFIED` | Default value. The value is unused. |
| `COMPANY` | Company owns the device. |
| `BYOD` | Bring Your Own Device (i.e. individual owns the device) |

## DeviceType

Type of device

| Enums ||
|---|---|
| `DEVICE_TYPE_UNSPECIFIED` | Unknown device type |
| `ANDROID` | Device is an Android device |
| `IOS` | Device is an iOS device |
| `GOOGLE_SYNC` | Device is a Google Sync device. |
| `WINDOWS` | Device is a Windows device. |
| `MAC_OS` | Device is a MacOS device. |
| `LINUX` | Device is a Linux device. |
| `CHROME_OS` | Device is a ChromeOS device. |
| `GOOGLEBOOK` | Device is a Googlebook device. |

## EncryptionState

Possible values of encryption state for this device.

| Enums ||
|---|---|
| `ENCRYPTION_STATE_UNSPECIFIED` | Encryption Status is not set. |
| `UNSUPPORTED_BY_DEVICE` | Device doesn't support encryption. |
| `ENCRYPTED` | Device is encrypted. |
| `NOT_ENCRYPTED` | Device is not encrypted. |

## AndroidAttributes

Resource representing the Android specific attributes of a Device.

| JSON representation |
|---|
| ``` { "enabledUnknownSources": boolean, "supportsWorkProfile": boolean, "ownerProfileAccount": boolean, "ownershipPrivilege": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#OwnershipPrivilege`), "verifiedBoot": boolean, "ctsProfileMatch": boolean, "verifyAppsEnabled": boolean, "hasPotentiallyHarmfulApps": boolean } ``` |

| Fields ||
|---|---|
| `enabledUnknownSources` | `boolean` Whether applications from unknown sources can be installed on device. |
| `supportsWorkProfile` | `boolean` Whether device supports Android work profiles. If false, this service will not block access to corp data even if an administrator turns on the "Enforce Work Profile" policy. |
| `ownerProfileAccount` | `boolean` Whether this account is on an owner/primary profile. For phones, only true for owner profiles. Android 4+ devices can have secondary or restricted user profiles. |
| `ownershipPrivilege` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#OwnershipPrivilege`)`` Ownership privileges on device. |
| `verifiedBoot` | `boolean` Whether Android verified boot status is GREEN. |
| `ctsProfileMatch` | `boolean` Whether the device passes Android CTS compliance. |
| `verifyAppsEnabled` | `boolean` Whether Google Play Protect Verify Apps is enabled. |
| `hasPotentiallyHarmfulApps` | `boolean` Whether any potentially harmful apps were detected on the device. |

## OwnershipPrivilege

Specifies how the device ownership privilege is configured on the device.

| Enums ||
|---|---|
| `OWNERSHIP_PRIVILEGE_UNSPECIFIED` | Ownership privilege is not set. |
| `DEVICE_ADMINISTRATOR` | Active device administrator privileges on the device. |
| `PROFILE_OWNER` | Profile Owner privileges. The account is in a managed corporate profile. |
| `DEVICE_OWNER` | Device Owner privileges on the device. |

## ManagementState

Possible management states of a device.

| Enums ||
|---|---|
| `MANAGEMENT_STATE_UNSPECIFIED` | Default value. This value is unused. |
| `APPROVED` | Device is approved. |
| `BLOCKED` | Device is blocked. |
| `PENDING` | Device is pending approval. |
| `UNPROVISIONED` | The device is not provisioned. Device will start from this state until some action is taken (i.e. a user starts using the device). |
| `WIPING` | Data and settings on the device are being removed. |
| `WIPED` | All data and settings on the device are removed. |

## CompromisedState

Represents whether the device is compromised

| Enums ||
|---|---|
| `COMPROMISED_STATE_UNSPECIFIED` | Default value. |
| `COMPROMISED` | The device is compromised (currently, this means Android device is rooted). |
| `UNCOMPROMISED` | The device is safe (currently, this means Android device is unrooted). |

## EndpointVerificationSpecificAttributes

Resource representing the [Endpoint Verification-specific attributes](https://cloud.google.com/endpoint-verification/docs/device-information) of a device.

| JSON representation |
|---|
| ``` { "certificateAttributes": [ { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateAttributes`) } ], "browserAttributes": [ { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserAttributes`) } ], "additionalSignals": { object } } ``` |

| Fields ||
|---|---|
| `certificateAttributes[]` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateAttributes`)`` Details of certificates. |
| `browserAttributes[]` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserAttributes`)`` Details of browser profiles reported by Endpoint Verification. |
| `additionalSignals` | ``object (`https://protobuf.dev/reference/protobuf/google.protobuf#struct` format)`` [Additional signals](https://cloud.google.com/endpoint-verification/docs/device-information) reported by Endpoint Verification. It includes the following attributes: - Non-configurable attributes: hotfixes, av_installed, av_enabled, windows_domain_name, is_os_native_firewall_enabled, and is_secure_boot_enabled. - [Configurable attributes](https://cloud.google.com/endpoint-verification/docs/collect-config-attributes): file, folder, and binary attributes; registry entries; and properties in a plist. |

## CertificateAttributes

Stores information about a certificate.

| JSON representation |
|---|
| ``` { "fingerprint": string, "thumbprint": string, "validationState": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateValidationState`), "serialNumber": string, "validityStartTime": string, "validityExpirationTime": string, "issuer": string, "subject": string, "certificateTemplate": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateTemplate`) } } ``` |

| Fields ||
|---|---|
| `fingerprint` | `string` The encoded certificate fingerprint. |
| `thumbprint` | `string` The certificate thumbprint. |
| `validationState` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateValidationState`)`` Output only. Validation state of this certificate. |
| `serialNumber` | `string` Serial number of the certificate, Example: "123456789". |
| `validityStartTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Certificate not valid before this timestamp. 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"`. |
| `validityExpirationTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Certificate not valid at or after this timestamp. 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"`. |
| `issuer` | `string` The name of the issuer of this certificate. |
| `subject` | `string` The subject name of this certificate. |
| `certificateTemplate` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#CertificateTemplate`)`` The X.509 extension for CertificateTemplate. |

## CertificateValidationState

Certificate validation status, which denotes if the certificate chain was validated for this certificate and if this certificate chains up to a trusted root for enterprise certificates.

| Enums ||
|---|---|
| `CERTIFICATE_VALIDATION_STATE_UNSPECIFIED` | Default value. |
| `VALIDATION_SUCCESSFUL` | Certificate validation was successful. |
| `VALIDATION_FAILED` | Certificate validation failed. |

## CertificateTemplate

CertificateTemplate (v3 Extension in X.509).

| JSON representation |
|---|
| ``` { "id": string, "majorVersion": integer, "minorVersion": integer } ``` |

| Fields ||
|---|---|
| `id` | `string` The template id of the template. Example: "1.3.6.1.4.1.311.21.8.15608621.11768144.5720724.16068415.6889630.81.2472537.7784047". |
| `majorVersion` | `integer` The Major version of the template. Example: 100. |
| `minorVersion` | `integer` The minor version of the template. Example: 12. |

## BrowserAttributes

Contains information about browser profiles reported by the [Endpoint Verification extension](https://chromewebstore.google.com/detail/endpoint-verification/callobklhcbilhphinckomhgkigmfocg?pli=1).

| JSON representation |
|---|
| ``` { "lastProfileSyncTime": string, "chromeBrowserInfo": { object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserInfo`) }, "chromeProfileId": string } ``` |

| Fields ||
|---|---|
| `lastProfileSyncTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Timestamp in milliseconds since the Unix epoch when the profile/gcm id was last synced. 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"`. |
| `chromeBrowserInfo` | ``object (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserInfo`)`` Represents the current state of the [Chrome browser attributes](https://cloud.google.com/access-context-manager/docs/browser-attributes) sent by the [Endpoint Verification extension](https://chromewebstore.google.com/detail/endpoint-verification/callobklhcbilhphinckomhgkigmfocg?pli=1). |
| `chromeProfileId` | `string` Chrome profile ID that is exposed by the Chrome API. It is unique for each device. |

## BrowserInfo

Browser-specific fields reported by the [Endpoint Verification extension](https://chromewebstore.google.com/detail/endpoint-verification/callobklhcbilhphinckomhgkigmfocg?pli=1).

| JSON representation |
|---|
| ``` { "browserVersion": string, "browserManagementState": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserManagementState`), "isFileUploadAnalysisEnabled": boolean, "isFileDownloadAnalysisEnabled": boolean, "isBulkDataEntryAnalysisEnabled": boolean, "isSecurityEventAnalysisEnabled": boolean, "isRealtimeUrlCheckEnabled": boolean, "safeBrowsingProtectionLevel": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#SafeBrowsingLevel`), "isSiteIsolationEnabled": boolean, "isBuiltInDnsClientEnabled": boolean, "passwordProtectionWarningTrigger": enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#PasswordProtectionTrigger`), "isChromeRemoteDesktopAppBlocked": boolean, "isChromeCleanupEnabled": boolean, "isThirdPartyBlockingEnabled": boolean } ``` |

| Fields ||
|---|---|
| `browserVersion` | `string` Version of the request initiating browser. E.g. `91.0.4442.4`. |
| `browserManagementState` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#BrowserManagementState`)`` Output only. Browser's management state. |
| `isFileUploadAnalysisEnabled` | `boolean` Current state of [file upload analysis](https://chromeenterprise.google/policies/#OnFileAttachedEnterpriseConnector). Set to true if provider list from Chrome is non-empty. |
| `isFileDownloadAnalysisEnabled` | `boolean` Current state of [file download analysis](https://chromeenterprise.google/policies/#OnFileDownloadedEnterpriseConnector). Set to true if provider list from Chrome is non-empty. |
| `isBulkDataEntryAnalysisEnabled` | `boolean` Current state of [bulk data analysis](https://chromeenterprise.google/policies/#OnBulkDataEntryEnterpriseConnector). Set to true if provider list from Chrome is non-empty. |
| `isSecurityEventAnalysisEnabled` | `boolean` Current state of [security event analysis](https://chromeenterprise.google/policies/#OnSecurityEventEnterpriseConnector). Set to true if provider list from Chrome is non-empty. |
| `isRealtimeUrlCheckEnabled` | `boolean` Current state of [real-time URL check](https://chromeenterprise.google/policies/#EnterpriseRealTimeUrlCheckMode). Set to true if provider list from Chrome is non-empty. |
| `safeBrowsingProtectionLevel` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#SafeBrowsingLevel`)`` Current state of [Safe Browsing protection level](https://chromeenterprise.google/policies/#SafeBrowsingProtectionLevel). |
| `isSiteIsolationEnabled` | `boolean` Current state of [site isolation](https://chromeenterprise.google/policies/?policy=IsolateOrigins). |
| `isBuiltInDnsClientEnabled` | `boolean` Current state of [built-in DNS client](https://chromeenterprise.google/policies/#BuiltInDnsClientEnabled). |
| `passwordProtectionWarningTrigger` | ``enum (`https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices#PasswordProtectionTrigger`)`` Current state of [password protection trigger](https://chromeenterprise.google/policies/#PasswordProtectionWarningTrigger). |
| `isChromeRemoteDesktopAppBlocked` | `boolean` Current state of [Chrome Remote Desktop app](https://chromeenterprise.google/policies/#URLBlocklist). |
| `isChromeCleanupEnabled (deprecated)` | `boolean` > [!WARNING] > This field is deprecated! Deprecated: This field is not used for Chrome version 118 and later. Current state of [Chrome Cleanup](https://chromeenterprise.google/policies/#ChromeCleanupEnabled). |
| `isThirdPartyBlockingEnabled` | `boolean` Current state of [third-party blocking](https://chromeenterprise.google/policies/#ThirdPartyBlockingEnabled). |

## BrowserManagementState

Information regarding management state of the profile.

| Enums ||
|---|---|
| `UNSPECIFIED` | Management state is not specified. |
| `UNMANAGED` | Browser/Profile is not managed by any customer. |
| `MANAGED_BY_OTHER_DOMAIN` | Browser/Profile is managed, but by some other customer. |
| `PROFILE_MANAGED` | Profile is managed by customer. |
| `BROWSER_MANAGED` | Browser is managed by customer. |

## SafeBrowsingLevel

Information regarding the browsing protection level policy of the browser.

| Enums ||
|---|---|
| `SAFE_BROWSING_LEVEL_UNSPECIFIED` | Browser protection level is not specified. |
| `DISABLED` | No protection against dangerous websites, downloads, and extensions. |
| `STANDARD` | Standard protection against websites, downloads, and extensions that are known to be dangerous. |
| `ENHANCED` | Faster, proactive protection against dangerous websites, downloads, and extensions. |

## PasswordProtectionTrigger

Information regarding the password protect warning trigger policy of the browser

| Enums ||
|---|---|
| `PASSWORD_PROTECTION_TRIGGER_UNSPECIFIED` | Password protection is not specified. |
| `PROTECTION_OFF` | Password reuse is never detected. |
| `PASSWORD_REUSE` | Warning is shown when the user reuses their protected password on a non-allowed site. |
| `PHISHING_REUSE` | Warning is shown when the user reuses their protected password on a phishing site. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/cancelWipe` | Cancels an unfinished device wipe. |
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/create` | Creates a device. |
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/delete` | Deletes the specified device. |
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/get` | Retrieves the specified device. |
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/list` | Lists/Searches devices. |
| ### `https://docs.cloud.google.com/identity/docs/reference/rest/v1/devices/wipe` | Wipes all data on the specified device. |