Must be set to "devices/-/deviceUsers" to search across all DeviceUser belonging to the user.
Query parameters
Parameters
pageSize
integer
The maximum number of DeviceUsers to return. If unspecified, at most 20 DeviceUsers will be returned. The maximum value is 20; values above 20 will be coerced to 20.
pageToken
string
A page token, received from a previousLookupDeviceUserscall. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided toLookupDeviceUsersmust match the call that provided the page token.
Raw Resource Id used by Google Endpoint Verification.
If the user is enrolled into Google Endpoint Verification, this id will be saved as the 'device_resource_id' field in the following platform dependent files.
Resource namesof the DeviceUsers in the format:devices/{device}/deviceUsers/{user_resource}, where device is the unique ID assigned to a Device and user_resource is the unique user ID
customer
string
The customer resource name that may be passed back to other Devices API methods such as List, Get, etc.
nextPageToken
string
Token to retrieve the next page of results. Empty if there are no more results.
[[["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 method retrieves the resource names of DeviceUsers associated with the caller's credentials, based on the provided properties.\u003c/p\u003e\n"],["\u003cp\u003eThe required properties for identification vary by platform: iOS needs no properties, Android requires 'androidId', and Desktop requires 'rawResourceId'.\u003c/p\u003e\n"],["\u003cp\u003eThe method supports pagination, allowing retrieval of results in multiple pages using the 'pageSize' and 'pageToken' parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe method uses a GET request with a specific URL structure that requires setting the parent path to "devices/-/deviceUsers", and the 'userId' parameter must be set to 'me'.\u003c/p\u003e\n"],["\u003cp\u003eIt strictly requires end-user credentials and the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices.lookup\u003c/code\u003e for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: devices.deviceUsers.lookup\n\nLooks up resource names of the DeviceUsers associated with the caller's credentials, as well as the properties provided in the request.\n\nThis method must be called with end-user credentials with the scope: \u003chttps://www.googleapis.com/auth/cloud-identity.devices.lookup\u003e\n\nIf multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND.\n\nDifferent platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified.\n\n- iOS: No properties need to be passed, the caller's credentials are sufficient to identify the corresponding DeviceUser.\n- Android: Specifying the 'androidId' field is required.\n- Desktop: Specifying the 'rawResourceId' field is required.\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/{parent=devices/*/deviceUsers}:lookup`\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 containing resource names of the DeviceUsers associated with the caller's credentials.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-identity.devices.lookup`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
