A DeviceReference is an API abstraction that lets you supply a device argument to a method using one of the following identifier types:

  • A numeric API resource ID.
  • Real-world hardware IDs, such as IMEI number, belonging to the manufactured device.

Methods that operate on devices take a DeviceReference as a parameter type because it's more flexible for the caller. To learn more about device identifiers, read Identifiers.

JSON representation

  // Union field device can be only one of the following:
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  // End of list of possible types for union field device.
Union field device. Required. The unique identifier for the device. device can be only one of the following:

string (int64 format)

The ID of the device.


object (DeviceIdentifier)

The hardware IDs of the device.