REST Resource: devices.deviceUsers.clientStates

Resource: ClientState

Represents the state associated with an API client calling the Devices API.

Resource representing ClientState and supports updates from API users

JSON representation
{
  "name": string,
  "createTime": string,
  "lastUpdateTime": string,
  "etag": string,
  "customId": string,
  "assetTags": [
    string
  ],
  "healthScore": enum (HealthScore),
  "scoreReason": string,
  "managed": enum (ManagedState),
  "complianceState": enum (ComplianceState),
  "keyValuePairs": {
    string: {
      object (CustomAttributeValue)
    },
    ...
  },
  "ownerType": enum (OwnerType)
}
Fields
name

string

Output only. Resource name of the ClientState in format: devices/{device}/deviceUsers/{deviceUser}/clientState/{partner}, where partner corresponds to the partner storing the data. For partners belonging to the "BeyondCorp Alliance", this is the partner ID specified to you by Google.

For all other callers, this is a string of the form: {customer}-suffix, where customer is your customer ID. The suffix is any string the caller specifies. This string will be displayed verbatim in the administration console. This suffix is used in setting up Custom Access Levels in Context-Aware Access.

Your organization's customer ID can be obtained from the URL: GET https://www.googleapis.com/admin/directory/v1/customers/my_customer The id field in the response contains the customer ID starting with the letter 'C'. The customer ID to be used in this API is the string after the letter 'C' (not including 'C')

createTime

string (Timestamp format)

Output only. The time the client state data was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Output only. The time the client state data was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

etag

string

The token that needs to be passed back for concurrency control in updates. Token needs to be passed back in UpdateRequest

customId

string

This field may be used to store a unique identifier for the API resource within which these CustomAttributes are a field.

assetTags[]

string

The caller can specify asset tags for this resource

healthScore

enum (HealthScore)

The Health score of the resource. The Health score is the callers specification of the condition of the device from a usability point of view. For example, a third-party device management provider may specify a health score based on its compliance with organizational policies.

scoreReason

string

A descriptive cause of the health score.

managed

enum (ManagedState)

The management state of the resource as specified by the API client.

complianceState

enum (ComplianceState)

The compliance state of the resource as specified by the API client.

keyValuePairs

map (key: string, value: object (CustomAttributeValue))

The map of key-value attributes stored by callers specific to a device. The total serialized length of this map may not exceed 10KB. No limit is placed on the number of attributes in a map.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ownerType

enum (OwnerType)

Output only. The owner of the ClientState

HealthScore

Enums
HEALTH_SCORE_UNSPECIFIED Default value
VERY_POOR The object is in very poor health as defined by the caller.
POOR The object is in poor health as defined by the caller.
NEUTRAL The object health is neither good nor poor, as defined by the caller.
GOOD The object is in good health as defined by the caller.
VERY_GOOD The object is in very good health as defined by the caller.

ManagedState

Management status of the device as provided by the Client

Enums
MANAGED_STATE_UNSPECIFIED The management state of the resource is unknown or unspecified.
MANAGED The resource is managed.
UNMANAGED The resource is not managed.

ComplianceState

Whether the object is compliant with third party policies or not

Enums
COMPLIANCE_STATE_UNSPECIFIED The compliance state of the resource is unknown or unspecified.
COMPLIANT Device is compliant with third party policies
NON_COMPLIANT Device is not compliant with third party policies

CustomAttributeValue

Additional custom attribute values may be one of these types

JSON representation
{

  // Union field kind can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean
  // End of list of possible types for union field kind.
}
Fields
Union field kind. The kind of value. kind can be only one of the following:
numberValue

number

Represents a double value.

stringValue

string

Represents a string value.

boolValue

boolean

Represents a boolean value.

OwnerType

Ownership type of data

Enums
OWNER_TYPE_UNSPECIFIED Unknown owner type
OWNER_TYPE_CUSTOMER Customer is the owner
OWNER_TYPE_PARTNER Partner is the owner

Methods

get

Gets the client state for the device user

list

Lists the client states for the given search query.

patch

Updates the client state for the device user

Note: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium