REST Resource: partners.devices

  • This content outlines the structure and components of device data for zero-touch enrollment, covering Android and Chrome OS devices.

  • A device is identified by a DeviceIdentifier, which includes details like serial number, manufacturer, model, and various hardware IDs such as IMEI and MEID.

  • DeviceMetadata allows the association of key-value pairs with a device to include custom metadata, while DeviceClaim records claims made by resellers for customers.

  • The DeviceProvisioningSectionType specifies claim types, including SECTION_TYPE_ZERO_TOUCH, and AdditionalService identifies other services like device protection, which is also known as Android Enterprise Essentials.

  • Several methods are listed, such as claiming, finding, getting, and unclaiming devices, which are essential for managing device enrollment and reseller metadata.

Resource: Device

An Android or Chrome OS device registered for zero-touch enrollment.

JSON representation 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ]
}
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 partners/[PARTNER_ID]/devices/[DEVICE_ID]. Assigned by the server.
deviceMetadata

object (DeviceMetadata)

The metadata attached to the device. Structured as key-value pairs. To learn more, read Device metadata.
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 partners.devices.unclaim or partners.devices.unclaimAsync to remove the device from zero-touch enrollment.

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,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": 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.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
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 Android manufacturers.
model

string

The device model's name. Allowed values are listed in Android models and Chrome OS models.
deviceType

enum (DeviceType)

The type of the device
chromeOsAttestedDeviceId

string

An identifier provided by OEMs, carried through the production and sales process. Only applicable to Chrome OS devices.
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.
Union field hardware_id2. The second hardware ID, for dual-SIM devices. If set, it must be the same identifier type as the first hardware ID. hardware_id2 can be only one of the following:
imei2

string

The device’s second IMEI number.
meid2

string

The device’s second MEID number.

DeviceType

The operating system of the device.

Enums
DEVICE_TYPE_ANDROID Android device
DEVICE_TYPE_CHROME_OS Chrome OS device

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,
  "googleWorkspaceCustomerId": string,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
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.
googleWorkspaceCustomerId

string

The ID of the Google Workspace account that owns the Chrome OS device.
resellerId

string (int64 format)

The ID of the reseller that claimed the device.
additionalService

enum (AdditionalService)

The Additional service registered for 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.

AdditionalService

Additional service registered for the device.

Enums
DEVICE_PROTECTION Device protection service, also known as Android Enterprise Essentials. To claim a device with the device protection service you must enroll with the partnership team.

Methods

claim

 Claims a device for a customer and adds it to zero-touch enrollment.

claimAsync

 Claims a batch of devices for a customer asynchronously.

findByIdentifier

 Finds devices by hardware identifiers, such as IMEI.

findByOwner

 Finds devices claimed for customers.

get

 Gets a device.

metadata

 Updates reseller metadata associated with the device.

unclaim

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

unclaimAsync

 Unclaims a batch of devices for a customer asynchronously.

updateMetadataAsync

 Updates the reseller metadata attached to a batch of devices.