Skip to main content

Get Device

Retrieves the specified device.

Basic Parameters

ParameterDescription
CustomerIf you're using this API for your own organization, use customers/my_customer. If you're using this API to manage another organization, use customers/{customer}, where customer is the customer to whom the device belongs.
Device NameThe unique ID assigned to the Device. You can find a device after setting the "View" parameter, by its serial number if it is company-owned, otherwise by its device ID.
ViewThe location of the device to fetch.
VIEW_UNSPECIFIED - Default value. The value is unused. The returned results are the same as in the Devices tab in the Google Workspace Mobile & Endpoints UI.
COMPANY_INVENTORY - This view contains all devices imported by the company admin. Each device in the response contains all information specified by the company admin when importing the device (i.e. asset tags). This includes devices that may be unaassigned or assigned to users.
USER_ASSIGNED_DEVICES - This view contains all devices with at least one user registered on the device. Each device in the response contains all device information, except for asset tags.

Advanced Parameters

ParameterDescription
Delegated User OverridePerform the action on behalf of another user, overriding the delegated user defined in the connection.

If not specified, the delegated user is the one provided in the connection.

Has no effect when using an OAuth connection.

NOTE: the connection details are not edited by this input.

Example Output

{
"androidSpecificAttributes": {
"enabledUnknownSources": false,
"ownerProfileAccount": false,
"ownershipPrivilege": "Ownership privileges on device.",
"supportsWorkProfile": false
},
"assetTag": "Asset tag of the device.",
"basebandVersion": "Output only. Baseband version of the device.",
"bootloaderVersion": "Output only. Device bootloader version. Example: 0.6.7.",
"brand": "Output only. Device brand. Example: Samsung.",
"buildNumber": "Output only. Build number of the device.",
"compromisedState": "Output only. Represents whether the Device is compromised.",
"createTime": "Output only. When the Company-Owned device was imported. This field is empty for BYOD devices.",
"deviceId": "Unique identifier for the device.",
"deviceType": "Output only. Type of device.",
"enabledDeveloperOptions": false,
"enabledUsbDebugging": false,
"encryptionState": "Output only. Device encryption state.",
"imei": "Output only. IMEI number of device if GSM device; empty otherwise.",
"kernelVersion": "Output only. Kernel version of the device.",
"lastSyncTime": "Most recent time when device synced with this service.",
"managementState": "Output only. Management state of the device",
"manufacturer": "Output only. Device manufacturer. Example: Motorola.",
"meid": "Output only. MEID number of device if CDMA device; empty otherwise.",
"model": "Output only. Model name of device. Example: Pixel 3.",
"name": "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.",
"networkOperator": "Output only. Mobile or network operator of device, if available.",
"osVersion": "Output only. OS version of the device. Example: Android 8.1.0.",
"otherAccounts": [
"string"
],
"ownerType": "Output only. Whether the device is owned by the company or an individual",
"releaseVersion": "Output only. OS release version. Example: 6.0.",
"securityPatchTime": "Output only. OS security patch update time on device.",
"serialNumber": "Serial Number of device. Example: HT82V1A01076.",
"wifiMacAddresses": [
"string"
]
}

Workflow Library Example

Get Device with Google Workspace and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop