Method: enterprises.devices.list

AI-generated Key Takeaways

• Lists all devices managed by a given enterprise, allowing for filtering by device custom name.

• Requires authorization with the https://www.googleapis.com/auth/sdm.service scope.

• Uses a GET request to the specified endpoint with the enterprise ID as a path parameter.

• The response provides a list of devices in JSON format, including details for each device.

• The request body should be empty, while query parameters can be used to specify filters.

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
  • JSON representation
• Authorization scopes
• Examples

Lists devices managed by the enterprise.

HTTP request

GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/devices

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent	string The parent enterprise to list devices under. E.g. "enterprises/XYZ".

Query parameters

Parameters
filter	string Optional filter to list devices. Filters can be done on: Device custom name (substring match): 'customName=wing'

Request body

The request body must be empty.

Response body

Response message for SmartDeviceManagementService.ListDevices

If successful, the response body contains data with the following structure:

JSON representation
{ "devices": [ { object (Device) } ] }

Fields
devices[]	object (Device) The list of devices.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/sdm.service

For more information, see the OAuth 2.0 Overview.