Documentation
Start typing to search…

List Mobile Devices

🧾 Definition

The "List Mobile Devices" action retrieves a paginated list of all mobile devices owned by users within a specified Google Workspace account. This includes critical device metadata such as the device model, OS, sync status, and user associations. It enables administrators to audit, manage, and monitor mobile device usage within their organization for security, compliance, and inventory purposes. By leveraging this action, admins can efficiently track user devices and take action as needed—such as enforcing security policies or verifying device compliance.


Example Use Cases :

Security Audit of User Devices

Easily retrieve a list of all mobile devices connected to your Google Workspace domain to ensure only authorized devices are accessing company data.

Mobile Device Inventory Management

Maintain an up-to-date inventory of all mobile devices across your organization, including their models, OS versions, and sync statuses.

User Access Review

Verify which devices are associated with specific users to detect anomalies, such as unexpected devices under a user account.

Automated Compliance Checks

Integrate into an automated flow to periodically fetch device lists and check for outdated OS versions or inactive syncs for compliance enforcement.

Reporting and Auditing

Generate regular reports showing mobile device usage patterns across the organization for internal audits or external compliance requirements.



Input :

Connection

A required Google Workspace Administration connection.To use this action, you must upload a Google service account credential JSON file with domain-wide delegation enabled. This allows Zenphi to securely interact with your Google Admin resources.👉 How to create this connection

Admin Email Address

The email address of a Google Workspace super administrator.This email is used to impersonate the admin during the request, granting the necessary permissions to access device data across users.

User Email (Optional)

Specify a user's email address if you'd like to retrieve devices for a specific user only.Leave it blank to retrieve devices across all users in the domain.

Customer Id (Optional)

The unique ID of your Google Workspace account.If you leave this field empty, Google will use the default customer ID associated with the admin account provided above. This is usually sufficient unless you manage multiple organizations.

Page Token (Optional)

Use this token to fetch the next page of results when listing devices.This is useful for processing large volumes of device records in a paginated manner. If left empty, the first page will be returned.


Output :

Devices

A list of user-owned mobile devices retrieved from the Google Workspace account. Each device entry includes the following details:

  • ** Resource Id**A unique identifier assigned by the Google API to reference this specific mobile device. It’s used in device management operations like updates or deletions.

  • ** Status**The current status of the device (e.g., active, inactive, wiped). Helps administrators monitor compliance and device activity.

  • ** Device Id**The unique identifier for the mobile device:

    • For Google Sync devices: the serial number.
    • For Android/iOS: a software-generated unique ID.

  • ** Emails**A list of email addresses associated with the device owner(s). Useful for identifying the user tied to a device.

  • ** Last Sync**The most recent date and time the device synced with Google Admin policies. Presented in ISO 8601 format (e.g., 2024-10-14T09:27:35Z).Helps determine whether the device is still in active use.

  • ** Model**The model name of the mobile device (e.g., Pixel 6, iPhone 13). Useful for inventory and compatibility checks.

  • ** Names**The display name(s) of the user(s) who own the device. Provides additional context alongside email addresses.

  • ** OS (Operating System)**Indicates the operating system and version of the device (e.g., Android 13, iOS 16.4).Helps IT admins monitor supported platforms.

  • ** Type**The type of mobile device (e.g., Android, iOS, Google Sync). Useful for filtering and categorizing device types.

🔁 Next Page Token

If the result includes more devices than the maximum limit per page, this field provides a token to fetch the next batch of results.If empty, it means there are no additional pages.


📘 Example Scenario

IT Device Audit for Security Compliance

An IT administrator at a company wants to ensure all mobile devices used by employees are compliant with company policies. As part of a monthly audit, the admin sets up a Zenphi flow using the "List Mobile Devices" action to automatically retrieve a list of all user-owned devices across the organization.

They provide:

  • The admin's email address
  • Optionally a specific user’s email to narrow the search
  • Their Google Workspace Customer ID (or leave it empty to use the default)
  • Optionally the Page Token if retrieving the next set of results

The flow gathers device data including model, OS, sync status, and owner information, then sends a report to the IT team or saves it to a Google Sheet for further analysis.

This helps identify outdated OS versions, inactive devices, or unauthorized device types—ensuring tighter mobile security controls.

Updated 11 days ago