DeviceReference
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
DeviceReference 是一种 API 抽象，允许您使用以下某种标识符类型向方法提供 device 参数：
- 数字形式的 API 资源 ID。
- 属于制造好设备的真实硬件 ID，例如 IMEI 识别码。
在设备上操作的方法接受 DeviceReference 作为参数类型，因为这对调用方来说更灵活。如需详细了解设备标识符，请参阅标识符。
| JSON 表示法 |
{
// 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.
} |
| 字段 |
联合字段 device。必需。设备的唯一标识符。device 只能是下列其中一项： |
deviceId |
string (int64 format)
设备的 ID。
|
deviceIdentifier |
object (DeviceIdentifier)
设备的硬件 ID。
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003e\u003ccode\u003eDeviceReference\u003c/code\u003e allows methods to accept a device argument using either a numeric API resource ID or real-world hardware IDs.\u003c/p\u003e\n"],["\u003cp\u003eMethods use \u003ccode\u003eDeviceReference\u003c/code\u003e as a parameter for flexibility in identifying devices.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edevice\u003c/code\u003e field in the JSON representation is a union field, accepting either a \u003ccode\u003edeviceId\u003c/code\u003e or \u003ccode\u003edeviceIdentifier\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edeviceId\u003c/code\u003e is a string that represents the unique ID of the device, and \u003ccode\u003edeviceIdentifier\u003c/code\u003e refers to an object containing the hardware IDs.\u003c/p\u003e\n"]]],["A `DeviceReference` is used as a device argument in methods, accepting either a numeric API resource ID (`deviceId`) or real-world hardware IDs (`deviceIdentifier`) like IMEI. The JSON representation uses a union field named `device` that contains either a `deviceId` string (int64 format) or a `deviceIdentifier` object, which holds the device's hardware IDs. Methods use this type for increased flexibility in identifying devices.\n"],null,["# DeviceReference\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nA `DeviceReference` is an API abstraction that lets you supply a *device* argument to a method using one of the following identifier types:\n\n- A numeric API resource ID.\n- Real-world hardware IDs, such as IMEI number, belonging to the manufactured device.\n\nMethods 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](https://developers.google.com/zero-touch/guides/identifiers).\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { // Union field `device` can be only one of the following: \"deviceId\": string, \"deviceIdentifier\": { object (/zero-touch/reference/customer/rest/v1/customers.devices#DeviceIdentifier) } // End of list of possible types for union field `device`. } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------|---|\n| Union field `device`. Required. The unique identifier for the device. `device` can be only one of the following: |||\n| `deviceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the device. |\n| `deviceIdentifier` | `object (`[DeviceIdentifier](/zero-touch/reference/customer/rest/v1/customers.devices#DeviceIdentifier)`)` The hardware IDs of the device. |"]]
