📘 Definition

The "List User's Devices" action in the Google Workspace category allows administrators to retrieve a filtered list of devices associated with a specific user in their organization. This includes detailed information such as device ID, operating system, ownership type, and sync history. By applying various filters like ownership type, device status, model, or OS, admins can search across both corporate-owned and personally-owned devices.

This action is particularly useful for device management, compliance auditing, and policy enforcement across Google Workspace-managed hardware. It requires a Google Workspace Administration connection using a service account with domain-wide delegation.

Example Use Cases :

Device Inventory Lookup

Quickly retrieve a list of all devices a specific user has registered, helping IT teams maintain visibility into device usage across the organization.

Security Compliance Audit

Filter devices by operating system or ownership to ensure all user devices meet company compliance standards (e.g., only company-owned or up-to-date OS).

Device Sync Verification

Check when a user’s device last synced with Google Workspace to ensure policies are applied and devices are actively monitored.

Identify Inactive or Unauthorized Devices

List devices with a "pending" or "account wiped" status to flag inactive or potentially unauthorized hardware for follow-up or removal.

Model-Specific Device Management

Search for all users with specific device models (e.g., "MacBook Pro") for targeted software rollouts or recalls.

Inputs:

Connection

A Google Workspace Administration connection that authorizes access to your domain.

*You must upload a credential JSON file for a service account with domain-wide delegation.*👉 How to create one

User Email

The email address of the user whose devices you want to list.

Example: [email protected]

Select Filter:

Email

An optional filter to narrow down devices based on email patterns or partial matches.

Useful when searching for all users from a subdomain or with similar naming conventions.

Ownership

Defines the type of device ownership to include in the result.

Company owned: Devices issued by the organization
User owned: BYOD (Bring Your Own Device)

Helps in separating corporate-managed devices from personal devices.

OS

Filter by the operating system of the device.

Example: Windows, macOS, Android, iOSUseful for OS-specific policy checks or software deployments.

Device ID

A unique alphanumeric identifier assigned to each device by Google Workspace.

Example: 12345ABCDEFXYZUse when targeting a specific device for troubleshooting or auditing.

Model

Specify the device model to filter results.

Example: MacBook Pro, Pixel 7Ideal for checking device type adoption across users.

User Name

Partial or full name string to search devices based on associated usernames.

Example: entering john will return results for all usernames containing "john".

Status

Filters devices by their Google Workspace provisioning status:

pending: Registered but not yet approved
approved: Active and synced
account wiped: Device has had its account removed

Helpful for identifying devices requiring action or review.

Outputs:

Devices

A collection of device records associated with the specified user, each containing the following detailed fields:

User Email

The email address of the user who is registered on the device.

Helps identify the owner or user of each listed device.

Device ID

A unique identifier assigned to the device by Google Workspace Mobile Management.

Useful for targeting specific devices for administrative tasks or audits.

Status

The current management status of the user on the device.Possible values include:

pending: Awaiting admin approval
approved: Device is fully provisioned and compliant
account wiped: The user account has been removed from the device

Enables monitoring and enforcement of compliance across devices.

First Sync

Timestamp of the first time the user registered the device with Google Workspace.

Useful for tracking when the device was first added to the management system.

Last Sync

The most recent time the device successfully synced with the organization's policy settings.

Helps determine if the device is up to date and in compliance.

OS

The operating system version of the device (e.g., Windows 11, Android 13).

Useful for OS-specific management or vulnerability tracking.

Ownership

Indicates whether the device is owned by the company or by the individual user.Values:

Company
User

Helps distinguish between corporate-managed devices and personal BYOD assets.

Example :

Audit Devices Assigned to a Departing Employee**

An IT administrator needs to perform an audit of all devices associated with an employee who is leaving the company. To ensure data security, the admin uses the "List User's Devices" action in a workflow to retrieve all devices linked to the user's email.

Setup:

In the action settings, the admin provides the User Email of the employee.
They leave most filters blank to retrieve a full list of devices (laptops, phones, etc.) the user has registered.
The flow runs and returns details such as device ID, ownership (whether it's company-owned or personal), OS version, and sync status.

**Outcome:**This enables the admin to review the device inventory and take necessary actions—like disabling or wiping access—before offboarding is complete.