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 nameof the customer. If you're using this API for your own organization, usecustomers/my_customerIf you're using this API to manage another organization, usecustomers/{customerId}, where customerId 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 toMobile 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 previousdeviceUsers.listcall. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided toListBooksmust 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 page describes how to list and search \u003ccode\u003eDeviceUsers\u003c/code\u003e using the \u003ccode\u003eGET https://cloudidentity.googleapis.com/v1beta1/{parent=devices/*}/deviceUsers\u003c/code\u003e HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify whether to list all \u003ccode\u003eDeviceUsers\u003c/code\u003e or those owned by a specific device, using \u003ccode\u003edevices/-\u003c/code\u003e or \u003ccode\u003edevices/{device}\u003c/code\u003e, respectively.\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 can be used to refine the list and include customer information, filter based on device details, determine the number of results, and the order of the results.\u003c/p\u003e\n"],["\u003cp\u003eThe successful response body includes an array of \u003ccode\u003edeviceUsers\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for paginating through results, and the request body must be empty.\u003c/p\u003e\n"],["\u003cp\u003eThe necessary authorization scopes include \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/v1beta1/{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)."]]
