REST Resource: customers.devices

Resource: Device

An Android device registered for zero-touch enrollment.

JSON representation
{
  "deviceId": string,
  "deviceIdentifier": {
    object(DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object(DeviceMetadata)
  },
  "claims": [
    {
      object(DeviceClaim)
    }
  ],
  "configuration": string
}
Fields
deviceId

string (int64 format)

Output only. The ID of the device. Assigned by the server.

deviceIdentifier

object(DeviceIdentifier)

The hardware IDs that identify a manufactured device. To learn more, read Identifiers.

name

string

Output only. The API resource name in the format customers/[CUSTOMER_ID]/devices/[DEVICE_ID]. Assigned by the server.

deviceMetadata

object(DeviceMetadata)

The metadata attached to the device. Structured as key-value pairs.

claims[]

object(DeviceClaim)

Output only. The provisioning claims for a device. Devices claimed for zero-touch enrollment have a claim with the type SECTION_TYPE_ZERO_TOUCH. Call customers.devices.unclaim to remove the device from zero-touch enrollment.

configuration

string

The configuration applied to the device in the format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. The value is null if the device doesn't have a configuration applied.

DeviceIdentifier

Encapsulates hardware and product IDs to identify a manufactured device. To understand requirements on identifier sets, read Identifiers.

JSON representation
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
Fields
serialNumber

string

The manufacturer's serial number for the device. This value might not be unique across different device models.

manufacturer

string

The device manufacturer’s name. Matches the device's built-in value returned from android.os.Build.MANUFACTURER. Allowed values are listed in manufacturers.

model

string

The device model's name. Matches the device's built-in value returned from android.os.Build.MODEL. Allowed values are listed in models.

Union field hardware_id. Hardware ID based on a modem ID. hardware_id can be only one of the following:
imei

string

The device’s IMEI number. Validated on input.

meid

string

The device’s MEID number.

DeviceMetadata

Metadata entries that can be attached to a Device. To learn more, read Device metadata.

JSON representation
{
  "entries": {
    string: string,
    ...
  }
}
Fields
entries

map (key: string, value: string)

Metadata entries recorded as key-value pairs.

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

DeviceClaim

A record of a device claimed by a reseller for a customer. Devices claimed for zero-touch enrollment have a claim with the type SECTION_TYPE_ZERO_TOUCH. To learn more, read Claim devices for customers.

JSON representation
{
  "sectionType": enum(DeviceProvisioningSectionType),
  "ownerCompanyId": string
}
Fields
sectionType

enum(DeviceProvisioningSectionType)

Output only. The type of claim made on the device.

ownerCompanyId

string (int64 format)

The ID of the Customer that purchased the device.

DeviceProvisioningSectionType

The section type of a provisioning record.

Enums
SECTION_TYPE_SIM_LOCK SIM-lock section type.
SECTION_TYPE_ZERO_TOUCH Zero-touch enrollment section type.

Methods

applyConfiguration

Applies a Configuration to the device to register the device for zero-touch enrollment.

get

Gets the details of a device.

list

Lists a customer's devices.

removeConfiguration

Removes a configuration from device.

unclaim

Unclaims a device from a customer and removes it from zero-touch enrollment.

Send feedback about...

Android zero-touch enrollment