DeviceReference هو عنصر مجرد في واجهة برمجة التطبيقات يتيح لك تقديم وسيطة device إلى طريقة باستخدام أحد أنواع المعرّفات التالية:
رقم تعريف مرجعي لمورد واجهة برمجة التطبيقات
معرّفات الأجهزة في الواقع، مثل رقم 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 واحدًا فقط مما يلي:
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`DeviceReference` allows methods to accept a device argument using either a numeric API resource ID or real-world hardware IDs."],["Methods use `DeviceReference` as a parameter for flexibility in identifying devices."],["The `device` field in the JSON representation is a union field, accepting either a `deviceId` or `deviceIdentifier`."],["`deviceId` is a string that represents the unique ID of the device, and `deviceIdentifier` refers to an object containing the hardware IDs."]]],["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"]]
