DeviceReference
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
DeviceReference — это абстракция API, которая позволяет предоставить аргумент устройства методу, используя один из следующих типов идентификаторов:
- Числовой идентификатор ресурса API.
- Реальные идентификаторы оборудования, такие как номер 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) Идентификатор устройства. |
deviceIdentifier | object ( DeviceIdentifier ) Аппаратные идентификаторы устройства. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\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. |"]]
