Required. To list all DeviceUsers, set this to "devices/-". To list all DeviceUsers owned by a device, set this to the resource name of the device. Format: devices/{device}
Query parameters
Parameters
customer
string
Optional. Resource name of the customer. If 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.
filter
string
Optional. Additional restrictions when fetching list of devices. For a list of search fields, refer to Mobile device search fields. Multiple search fields are separated by the space character.
pageSize
integer
Optional. The maximum number of DeviceUsers to return. If unspecified, at most 5 DeviceUsers will be returned. The maximum value is 20; values above 20 will be coerced to 20.
pageToken
string
Optional. A page token, received from a previous deviceUsers.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListBooks must match the call that provided the page token.
orderBy
string
Optional. Order specification for devices in the response.
Request body
The request body must be empty.
Response body
Response message that is returned from the deviceUsers.list method.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThis API endpoint allows listing and searching for DeviceUsers associated with devices within the Cloud Identity service.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify either all DeviceUsers or those associated with a specific device.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, such as \u003ccode\u003ecustomer\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e, enable filtering, pagination, and ordering of the results.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003edeviceUsers\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes, including \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices.readonly\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: devices.deviceUsers.list\n\nLists/Searches DeviceUsers.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/{parent=devices/*}/deviceUsers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message that is returned from the deviceUsers.list method.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-identity.devices.readonly`\n- `https://www.googleapis.com/auth/cloud-identity.devices`\n- `https://www.googleapis.com/auth/cloud-identity`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
