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/{deviceId}/deviceUsers/{user_resource_id}, where deviceId is the unique ID assigned to a Device and user_resource_id is the unique user ID
customer
string
The customer Id 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 looks up the resource names of DeviceUsers associated with the caller's credentials, requiring the scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-identity.devices.lookup\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDifferent device platforms require varying information for identification: iOS requires no properties, Android requires the \u003ccode\u003eandroidId\u003c/code\u003e, and Desktop requires the \u003ccode\u003erawResourceId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf multiple properties are specified, the method will only return DeviceUsers that have all of those properties.\u003c/p\u003e\n"],["\u003cp\u003eThe method uses a GET request to \u003ccode\u003ehttps://cloudidentity.googleapis.com/v1beta1/{parent=devices/*/deviceUsers}:lookup\u003c/code\u003e, and the \u003ccode\u003eparent\u003c/code\u003e parameter must be set to "devices/-/deviceUsers".\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003enames\u003c/code\u003e in the format \u003ccode\u003edevices/{deviceId}/deviceUsers/{user_resource_id}\u003c/code\u003e, a \u003ccode\u003ecustomer\u003c/code\u003e ID, and a \u003ccode\u003enextPageToken\u003c/code\u003e for paginated results.\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/v1beta1/{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)."]]
