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 واحدًا فقط مما يلي:
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]