Required.Resource nameof the ClientState in format:devices/{device}/deviceUsers/{deviceUser}/clientStates/{partner}, wheredeviceis the unique ID assigned to the Device,deviceUseris the unique ID assigned to the User andpartneridentifies the partner storing the data. To get the client state for devices belonging to your own organization, thepartnerIdis in the format:customerId-*anystring*. Where thecustomerIdis your organization's customer ID andanystringis any suffix. This suffix is used in setting up Custom Access Levels in Context-Aware Access. You may usemy_customerinstead of the customer ID for devices managed by your own organization.
You may specify-in place of the{device}, so the ClientState resource name can be:devices/-/deviceUsers/{deviceUserResource}/clientStates/{partner}.
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/{customer}, where customer is the customer to whom the device belongs.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance ofClientState.
[[["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 endpoint retrieves the client state for a specific device user using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe URL path requires the device ID, device user ID, and partner identifier to locate the specific client state.\u003c/p\u003e\n"],["\u003cp\u003eThe resource name format is \u003ccode\u003edevices/{device}/deviceUsers/{deviceUser}/clientStates/{partner}\u003c/code\u003e, with specific rules for customer-owned devices.\u003c/p\u003e\n"],["\u003cp\u003eAn optional customer parameter can be specified in the query to manage another organization's devices using \u003ccode\u003ecustomers/{customer}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a \u003ccode\u003eClientState\u003c/code\u003e resource, and authorization requires one of the listed OAuth scopes.\u003c/p\u003e\n"]]],[],null,["# Method: devices.deviceUsers.clientStates.get\n\nGets the client state for the device user\n\n### HTTP request\n\n`GET https://cloudidentity.googleapis.com/v1/{name=devices/*/deviceUsers/*/clientStates/*}`\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\nIf successful, the response body contains an instance of [ClientState](/identity/docs/reference/rest/v1/devices.deviceUsers.clientStates#ClientState).\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)."]]
