REST Resource: customers.telemetry.devices

المورد: TelemetryDevice

بيانات القياس عن بُعد التي يتم جمعها من جهاز مُدار

  • مطلوب إذن دقيق: TELEMETRY_API_DEVICE
تمثيل JSON 
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "deviceId": string,
  "serialNumber": string,
  "cpuInfo": [
    {
      object (CpuInfo)
    }
  ],
  "cpuStatusReport": [
    {
      object (CpuStatusReport)
    }
  ],
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryStatusReport": [
    {
      object (MemoryStatusReport)
    }
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "networkStatusReport": [
    {
      object (NetworkStatusReport)
    }
  ],
  "networkDiagnosticsReport": [
    {
      object (NetworkDiagnosticsReport)
    }
  ],
  "osUpdateStatus": [
    {
      object (OsUpdateStatus)
    }
  ],
  "graphicsInfo": {
    object (GraphicsInfo)
  },
  "graphicsStatusReport": [
    {
      object (GraphicsStatusReport)
    }
  ],
  "batteryInfo": [
    {
      object (BatteryInfo)
    }
  ],
  "batteryStatusReport": [
    {
      object (BatteryStatusReport)
    }
  ],
  "storageInfo": {
    object (StorageInfo)
  },
  "storageStatusReport": [
    {
      object (StorageStatusReport)
    }
  ],
  "thunderboltInfo": [
    {
      object (ThunderboltInfo)
    }
  ],
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "bootPerformanceReport": [
    {
      object (BootPerformanceReport)
    }
  ],
  "heartbeatStatusReport": [
    {
      object (HeartbeatStatusReport)
    }
  ],
  "kioskAppStatusReport": [
    {
      object (KioskAppStatusReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ],
  "runtimeCountersReport": [
    {
      object (RuntimeCountersReport)
    }
  ]
}
الحقول
name

string

النتائج فقط. اسم مورد الجهاز
customer

string

النتائج فقط. عميل Google Workspace الذي سجّلت مؤسسته الجهاز.
orgUnitId

string

النتائج فقط. رقم تعريف الوحدة التنظيمية للجهاز.
deviceId

string

النتائج فقط. المعرّف الفريد لواجهة برمجة تطبيقات Directory API الخاص بالجهاز. هذه القيمة هي نفسها معرّف Directory API في "وحدة تحكّم المشرف" ضمن علامة التبويب "أجهزة ChromeOS".
serialNumber

string

النتائج فقط. الرقم التسلسلي للجهاز هذه القيمة هي نفسها الرقم التسلسلي في "وحدة تحكّم المشرف" ضمن علامة التبويب "أجهزة ChromeOS".
cpuInfo[]

object (CpuInfo)

النتائج فقط. معلومات بشأن مواصفات وحدة المعالجة المركزية (CPU) للجهاز
cpuStatusReport[]

object (CpuStatusReport)

النتائج فقط. تقارير حالة وحدة المعالجة المركزية التي يتم جمعها بشكل دوري والمرتّبة بترتيب تنازلي حسب reportTime
memoryInfo

object (MemoryInfo)

النتائج فقط. معلومات حول مواصفات ذاكرة الجهاز
memoryStatusReport[]

object (MemoryStatusReport)

النتائج فقط. تقارير حالة الذاكرة التي يتم جمعها بشكل دوري، ويتم ترتيبها تنازليًا حسب reportTime.
networkInfo

object (NetworkInfo)

النتائج فقط. معلومات أجهزة الشبكة
networkStatusReport[]

object (NetworkStatusReport)

النتائج فقط. يتم جمع مواصفات الشبكة بشكل دوري.
networkDiagnosticsReport[]

object (NetworkDiagnosticsReport)

النتائج فقط. يتم جمع بيانات تشخيص الشبكة بشكل دوري.
osUpdateStatus[]

object (OsUpdateStatus)

النتائج فقط. يحتوي على معلومات ذات صلة بحالة تحديث ChromeOS.
graphicsInfo

object (GraphicsInfo)

النتائج فقط. يحتوي على معلومات حول الأجهزة الطرفية الرسومية للجهاز.
graphicsStatusReport[]

object (GraphicsStatusReport)

النتائج فقط. تقارير الرسومات التي يتم جمعها بشكل دوري
batteryInfo[]

object (BatteryInfo)

النتائج فقط. تعرض هذه السمة معلومات عن مواصفات بطارية الجهاز.
batteryStatusReport[]

object (BatteryStatusReport)

النتائج فقط. يتم جمع تقارير البطارية بشكل دوري.
storageInfo

object (StorageInfo)

النتائج فقط. معلومات عن مواصفات التخزين للجهاز
storageStatusReport[]

object (StorageStatusReport)

النتائج فقط. يتم جمع تقارير التخزين بشكل دوري.
thunderboltInfo[]

object (ThunderboltInfo)

النتائج فقط. معلومات عن ناقل Thunderbolt
audioStatusReport[]

object (AudioStatusReport)

النتائج فقط. يتم جمع التقارير الصوتية بشكل دوري وترتيبها تنازليًا حسب reportTime.
bootPerformanceReport[]

object (BootPerformanceReport)

النتائج فقط. تقارير أداء تشغيل الجهاز
heartbeatStatusReport[]

object (HeartbeatStatusReport)

النتائج فقط. تقرير حالة نبضات القلب الذي يحتوي على طوابع زمنية يتم ترتيبها بشكل دوري بترتيب تنازلي حسب reportTime
kioskAppStatusReport[]

object (KioskAppStatusReport)

النتائج فقط. تقرير حالة تطبيق Kiosk لجهاز Kiosk
networkBandwidthReport[]

object (NetworkBandwidthReport)

النتائج فقط. تقارير معدّل نقل البيانات على الشبكة التي يتم جمعها بشكل دوري والمرتّبة بترتيب تنازلي حسب reportTime
peripheralsReport[]

object (PeripheralsReport)

النتائج فقط. يتم جمع تقارير الأجهزة الطرفية بشكل دوري ويتم ترتيبها تنازليًا حسب reportTime.
appReport[]

object (AppReport)

النتائج فقط. يتم جمع تقارير التطبيقات بشكل دوري وترتيبها تنازليًا حسب reportTime.
runtimeCountersReport[]

object (RuntimeCountersReport)

النتائج فقط. تُبلِغ تقارير عدّادات وقت التشغيل عن وقت التشغيل الإجمالي للجهاز، بالإضافة إلى عدد عمليات الانتقال من S0 إلى S3 ومن S0 إلى S4 ومن S0 إلى S5، ما يعني الانتقال إلى حالات السكون والإسبات وإيقاف التشغيل.

CpuInfo

مواصفات وحدة المعالجة المركزية للجهاز

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceCpuInfo
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_CPU_INFO
تمثيل JSON 
{
  "model": string,
  "architecture": enum (Architecture),
  "maxClockSpeed": integer,
  "keylockerSupported": boolean,
  "keylockerConfigured": boolean
}
الحقول
model

string

النتائج فقط. اسم طراز وحدة المعالجة المركزية مثال: وحدة معالجة مركزية من Intel(R) Core(TM) i5-8250U بسرعة 1.60 غيغاهرتز
architecture

enum (Architecture)

النتائج فقط. نوع البنية لوحدة المعالجة المركزية

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceCpuInfo
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
maxClockSpeed

integer

النتائج فقط. أقصى سرعة في الساعة لوحدة المعالجة المركزية (CPU) بالكيلوهرتز.
keylockerSupported

boolean

النتائج فقط. تحدِّد ما إذا كانت ميزة "قفل المفاتيح" متاحة.
keylockerConfigured

boolean

النتائج فقط. تحدِّد ما إذا تم ضبط ميزة Keylocker.‫TRUE = مفعَّل، FALSE = غير مفعَّل يتمّ عرض هذا الحقل فقط إذا كانت قيمة keylockerSupported هي TRUE.

الهندسة المعمارية

نوع البنية لوحدة المعالجة المركزية

عمليات التعداد
ARCHITECTURE_UNSPECIFIED البنية غير معروفة.
X64 بنية x64

CpuStatusReport

تقدّم هذه السمة معلومات عن حالة وحدة المعالجة المركزية.

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceCpuInfo
  • معدّل تكرار جمع البيانات: كل 10 دقائق
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب الحصول على إذن دقيق: TELEMETRY_API_CPU_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "cpuUtilizationPct": integer,
  "cpuTemperatureInfo": [
    {
      object (CpuTemperatureInfo)
    }
  ]
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني بالملّي ثانية الذي يمثّل الوقت الذي تم فيه أخذ عيّنة من هذا التقرير.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

النتائج فقط. معدّل تكرار أخذ عيّنات من التقرير

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
cpuUtilizationPct

integer

النتائج فقط. عينة من استخدام وحدة المعالجة المركزية (من 0 إلى 100 بالمائة)
cpuTemperatureInfo[]

object (CpuTemperatureInfo)

النتائج فقط. معلومات نموذج درجة حرارة وحدة المعالجة المركزية لكل نواة بالدرجة المئوية

CpuTemperatureInfo

درجة حرارة وحدة المعالجة المركزية (CPU) للجهاز يتم أخذ عيّنات لكل نواة من نوى وحدة المعالجة المركزية بالدرجة المئوية.

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceCpuInfo
  • معدّل تكرار جمع البيانات: كل 10 دقائق
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
تمثيل JSON 
{
  "temperatureCelsius": integer,
  "label": string
}
الحقول
temperatureCelsius

integer

النتائج فقط. درجة حرارة وحدة المعالجة المركزية بالدرجة المئوية
label

string

النتائج فقط. تصنيف وحدة المعالجة المركزية (CPU) مثال: Core 0

MemoryInfo

معلومات ذاكرة الجهاز

  • يحتوي هذا الحقل على معلومات القياس عن بُعد ومعلومات الجهاز:
    • totalRamBytes - معلومات الجهاز
    • availableRamBytes - معلومات القياس عن بُعد
    • totalMemoryEncryption - معلومات الجهاز
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceMemoryInfo
  • معدّل تكرار جمع البيانات:
    • ‫totalRamBytes - عند التحميل فقط
    • availableRamBytes - كل 10 دقائق
    • ‫totalMemoryEncryption - عند بدء تشغيل الجهاز
  • معدّل تكرار إعداد التقارير التلقائي عن البيانات:
    • من totalRamBytes إلى 3 ساعات
    • من availableRamBytes إلى 3 ساعات
    • ‫totalMemoryEncryption - عند بدء تشغيل الجهاز
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت مرة أخرى: فقط في totalMemoryEncryption
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_MEMORY_INFO
تمثيل JSON 
{
  "totalRamBytes": string,
  "availableRamBytes": string,
  "totalMemoryEncryption": {
    object (TotalMemoryEncryptionInfo)
  }
}
الحقول
totalRamBytes

string (int64 format)

النتائج فقط. إجمالي ذاكرة الوصول العشوائي بالبايت
availableRamBytes

string (int64 format)

النتائج فقط. مقدار ذاكرة الوصول العشوائي المتاحة بالبايت
totalMemoryEncryption

object (TotalMemoryEncryptionInfo)

النتائج فقط. معلومات التشفير الكلي للذاكرة على الجهاز

TotalMemoryEncryptionInfo

معلومات تشفير الذاكرة على الجهاز

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceMemoryInfo
  • معدّل تكرار جمع البيانات: عند بدء تشغيل الجهاز
  • معدّل تكرار إعداد التقارير التلقائي عن البيانات: عند بدء تشغيل الجهاز
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
تمثيل JSON 
{
  "encryptionState": enum (MemoryEncryptionState),
  "maxKeys": string,
  "keyLength": string,
  "encryptionAlgorithm": enum (MemoryEncryptionAlgorithm)
}
الحقول
encryptionState

enum (MemoryEncryptionState)

حالة تشفير الذاكرة على الجهاز
maxKeys

string (int64 format)

الحد الأقصى لعدد المفاتيح التي يمكن استخدامها للتشفير
keyLength

string (int64 format)

طول مفاتيح التشفير
encryptionAlgorithm

enum (MemoryEncryptionAlgorithm)

خوارزمية تشفير الذاكرة

MemoryEncryptionState

حالة تشفير الذاكرة على الجهاز

عمليات التعداد
MEMORY_ENCRYPTION_STATE_UNSPECIFIED لم يتم ضبط حالة تشفير الذاكرة.
MEMORY_ENCRYPTION_STATE_UNKNOWN حالة تشفير الذاكرة غير معروفة.
MEMORY_ENCRYPTION_STATE_DISABLED تشفير الذاكرة غير مفعَّل على الجهاز.
MEMORY_ENCRYPTION_STATE_TME يستخدم تشفير الذاكرة في الجهاز التشفير الكلي للذاكرة.
MEMORY_ENCRYPTION_STATE_MKTME يستخدم تشفير الذاكرة في الجهاز تشفيرًا إجماليًا متعدد المفاتيح للذاكرة.

MemoryEncryptionAlgorithm

خوارزمية التشفير المستخدَمة على الجهاز

عمليات التعداد
MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED لم يتم ضبط خوارزمية تشفير الذاكرة.
MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN خوارزمية تشفير الذاكرة المستخدَمة غير معروفة.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128 تستخدم خوارزمية تشفير الذاكرة خوارزمية التشفير AES_XTS مع كتلةCypher بحجم 128 بت.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 تستخدم خوارزمية تشفير الذاكرة خوارزمية التشفير AES_XTS مع كتلة Cypher بحجم 256 بت.

MemoryStatusReport

تحتوي على عيّنات من تقارير حالة الذاكرة.

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceMemoryInfo
  • معدّل تكرار جمع البيانات: عند التحميل فقط، يتم جمع SystemRamFreeByes كل 10 دقائق
  • معدّل إعداد التقارير التلقائي عن البيانات: كل 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • مطلوب إذن دقيق: TELEMETRY_API_MEMORY_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "systemRamFreeBytes": string,
  "pageFaults": integer
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني بالملّي ثانية الذي يمثّل الوقت الذي تم فيه أخذ عيّنة من هذا التقرير.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

النتائج فقط. معدّل تكرار أخذ عيّنات من التقرير

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
systemRamFreeBytes

string (int64 format)

النتائج فقط. مقدار ذاكرة الوصول العشوائي (RAM) الخالية بالبايت (غير موثوق به بسبب ميزة "جمع البيانات غير المرغوب فيها").
pageFaults

integer

النتائج فقط. عدد أخطاء الصفحة أثناء عملية جمع البيانات هذه

NetworkInfo

معلومات أجهزة الشبكة

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportNetworkDeviceConfiguration
  • معدّل تكرار جمع البيانات: عند بدء تشغيل الجهاز
  • معدّل تكرار إعداد التقارير التلقائي عن البيانات: عند بدء تشغيل الجهاز
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_NETWORK_INFO
تمثيل JSON 
{
  "networkDevices": [
    {
      object (NetworkDevice)
    }
  ]
}
الحقول
networkDevices[]

object (NetworkDevice)

النتائج فقط. قائمة بأجهزة الشبكة

NetworkDevice

تفاصيل حول جهاز الشبكة

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportNetworkDeviceConfiguration
  • معدّل تكرار جمع البيانات: عند بدء تشغيل الجهاز
  • معدّل تكرار إعداد التقارير التلقائي عن البيانات: عند بدء تشغيل الجهاز
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
تمثيل JSON 
{
  "type": enum (NetworkDeviceType),
  "macAddress": string,
  "meid": string,
  "imei": string,
  "iccid": string,
  "mdn": string
}
الحقول
type

enum (NetworkDeviceType)

النتائج فقط. نوع جهاز الشبكة
macAddress

string

النتائج فقط. عنوان MAC (إذا كان ذلك منطبقًا) لجهاز الشبكة المقابل
meid

string

النتائج فقط. معرّف الجهاز الجوّال (MEID) لجهاز الشبكة المقابل (إذا كان ذلك منطبقًا)
imei

string

النتائج فقط. رقم IMEI (إذا كان ذلك منطبقًا) لجهاز الشبكة المقابل
iccid

string

النتائج فقط. رقم تعريف بطاقة الدائرة الكهربائية المدمجة المرتبط بشريحة SIM للجهاز.
mdn

string

النتائج فقط. رقم دليل الجوّال المرتبط بشريحة SIM للجهاز.

NetworkDeviceType

أنواع أجهزة الشبكة

عمليات التعداد
NETWORK_DEVICE_TYPE_UNSPECIFIED لم يتم تحديد نوع جهاز الشبكة.
CELLULAR_DEVICE جهاز جوّال
ETHERNET_DEVICE جهاز إيثرنت
WIFI_DEVICE جهاز Wi-Fi

NetworkStatusReport

حالة الشبكات المرئية أو التي تم ضبطها

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportNetworkStatus
  • معدّل تكرار جمع البيانات: 60 دقيقة
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم الإبلاغ عن هذا الحدث للمستخدمين التابعين فقط: نعم
  • مطلوب إذن دقيق: TELEMETRY_API_NETWORK_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "sampleFrequency": string,
  "signalStrengthDbm": integer,
  "lanIpAddress": string,
  "gatewayIpAddress": string,
  "transmissionBitRateMbps": string,
  "receivingBitRateMbps": string,
  "transmissionPowerDbm": integer,
  "encryptionOn": boolean,
  "wifiLinkQuality": string,
  "wifiPowerManagementEnabled": boolean,
  "guid": string,
  "connectionState": enum (NetworkConnectionState),
  "connectionType": enum (NetworkType),
  "ipv6Address": [
    string
  ],
  "gatewayIpv6Address": string,
  "metered": boolean,
  "linkDownSpeedKbps": string
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه تسجيل حالة الشبكة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
sampleFrequency

string (Duration format)

النتائج فقط. معدّل تكرار أخذ عيّنات من التقرير

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
signalStrengthDbm

integer

النتائج فقط. قوة إشارة الشبكات اللاسلكية تُقاس بالديسيبل.
lanIpAddress

string

النتائج فقط. عنوان IP لشبكة LAN
gatewayIpAddress

string

النتائج فقط. عنوان IP للمدخل
transmissionBitRateMbps

string (int64 format)

النتائج فقط. معدل نقل بيانات الإرسال يُقاس بالميغابايت في الثانية.
receivingBitRateMbps

string (int64 format)

النتائج فقط. معدل نقل بيانات الاستلام يُقاس بالميغابايت في الثانية.
transmissionPowerDbm

integer

النتائج فقط. تقاس قوة الإرسال بالديسيبل.
encryptionOn

boolean

النتائج فقط. تُحدِّد هذه السياسة ما إذا كان مفتاح تشفير شبكة Wi-Fi غير مفعَّل.
wifiPowerManagementEnabled

boolean

النتائج فقط. تم تفعيل إدارة طاقة Wi-Fi
guid

string

النتائج فقط. المعرّف الفريد العام لاتصال الشبكة
connectionState

enum (NetworkConnectionState)

النتائج فقط. حالة الاتصال الحالية بالشبكة
connectionType

enum (NetworkType)

النتائج فقط. نوع اتصال الشبكة
ipv6Address[]

string

النتائج فقط. عناوين IPv6 المُعيَّنة لهذه الشبكة، إن وُجدت كل عنوان هو سلسلة في التمثيل النصي العادي لبروتوكول IPv6 (مثل "2001:db8::1").
gatewayIpv6Address

string

النتائج فقط. عنوان IPv6 للمدخل لهذه الواجهة، إذا تم رصده
metered

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا تم رصد الشبكة على أنّها شبكة تفرض تكلفة استخدام.

NetworkType

أنواع اتصالات الشبكة

عمليات التعداد
NETWORK_TYPE_UNSPECIFIED نوع اتصال الشبكة غير محدد
CELLULAR اتصال شبكة الجوّال
ETHERNET اتصال شبكة إيثرنت
TETHER توصيل الاتصال بالشبكة
VPN اتصال شبكة VPN
WIFI اتصال شبكة Wi-Fi

NetworkDiagnosticsReport

نتائج اختبار الشبكة لتحديد حالة اتصال الجهاز بالشبكة، مثلاً ما إذا كان وقت استجابة بروتوكول HTTPS مرتفعًا أو عاديًا

  • مطلوب إذن دقيق: TELEMETRY_API_NETWORK_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "httpsLatencyData": {
    object (HttpsLatencyRoutineData)
  }
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت جمع بيانات التشخيص

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
httpsLatencyData

object (HttpsLatencyRoutineData)

النتائج فقط. بيانات اختبار وقت استجابة بروتوكول HTTPS

OsUpdateStatus

يحتوي على معلومات بشأن حالة تحديث نظام التشغيل الحالية.

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceOsUpdateStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • الإذن الدقيق المطلوب: TELEMETRY_API_OS_REPORT
تمثيل JSON 
{
  "updateState": enum (UpdateState),
  "newPlatformVersion": string,
  "newRequestedPlatformVersion": string,
  "lastUpdateTime": string,
  "lastUpdateCheckTime": string,
  "lastRebootTime": string
}
الحقول
updateState

enum (UpdateState)

النتائج فقط. الحالة الحالية لتحديث نظام التشغيل
newPlatformVersion

string

النتائج فقط. يتم تنزيل وتطبيق إصدار جديد من صورة نظام التشغيل. لا يتم ضبط هذا الحقل إلا عندما تكون حالة التحديث OS_IMAGE_DOWNLOAD_IN_PROGRESS أو OS_UPDATE_NEED_REBOOT. يُرجى العِلم أنّ هذا قد يكون عنوان IP وهميًا "0.0.0.0" للحالة OS_UPDATE_NEED_REBOOT في بعض الحالات الحدّية، مثل إعادة تشغيل محرك التحديث بدون إعادة التشغيل.
newRequestedPlatformVersion

string

النتائج فقط. إصدار النظام الأساسي الجديد المطلوب من تطبيق Kiosk الذي تم تحديثه في انتظار المراجعة
lastUpdateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر عملية تعديل ناجحة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastUpdateCheckTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر عملية بحث عن تحديث.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
lastRebootTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر عملية إعادة تشغيل

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

UpdateState

حالة تحديث نظام التشغيل

عمليات التعداد
UPDATE_STATE_UNSPECIFIED لم يتم تحديد الولاية.
OS_IMAGE_DOWNLOAD_NOT_STARTED لم يبدأ نظام التشغيل في التنزيل.
OS_IMAGE_DOWNLOAD_IN_PROGRESS بدأ نظام التشغيل في التنزيل على الجهاز.
OS_UPDATE_NEED_REBOOT يجب إعادة تشغيل الجهاز لإنهاء التحميل.

GraphicsInfo

معلومات النظام الفرعي للرسومات

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceGraphicsStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • مطلوب إذن دقيق: TELEMETRY_API_GRAPHICS_INFO
تمثيل JSON 
{
  "adapterInfo": {
    object (GraphicsAdapterInfo)
  },
  "eprivacySupported": boolean,
  "displayDevices": [
    {
      object (DisplayDevice)
    }
  ],
  "touchScreenInfo": {
    object (TouchScreenInfo)
  }
}
الحقول
adapterInfo

object (GraphicsAdapterInfo)

النتائج فقط. معلومات حول مهايئ الرسومات (وحدة معالجة الرسومات)
eprivacySupported

boolean

النتائج فقط. هل شاشة الخصوصية الإلكترونية مدعومة أم لا.
displayDevices[]

object (DisplayDevice)

النتائج فقط. معلومات عن شاشات الجهاز
touchScreenInfo

object (TouchScreenInfo)

النتائج فقط. معلومات حول شاشات اللمس الداخلية للجهاز

GraphicsAdapterInfo

معلومات عن مهايئ الرسومات (وحدة معالجة الرسومات)

تمثيل JSON 
{
  "adapter": string,
  "driverVersion": string,
  "deviceId": string
}
الحقول
adapter

string

النتائج فقط. اسم المحوّل مثال: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
driverVersion

string

النتائج فقط. يشير إلى إصدار برنامج تشغيل وحدة معالجة الرسومات.
deviceId

string (int64 format)

النتائج فقط. تمثّل هذه السمة معرّف جهاز بطاقة الرسومات.

DisplayDevice

معلومات جهاز العرض

تمثيل JSON 
{
  "displayName": string,
  "displayWidthMm": integer,
  "displayHeightMm": integer,
  "internal": boolean,
  "manufacturerId": string,
  "modelId": integer,
  "manufactureYear": integer,
  "serialNumber": integer,
  "edidVersion": string
}
الحقول
displayName

string

النتائج فقط. عرض اسم الجهاز
displayWidthMm

integer

النتائج فقط. عرض الشاشة بالمليمتر
displayHeightMm

integer

النتائج فقط. ارتفاع الشاشة بالمليمتر
internal

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كان العرض داخليًا أم لا.
manufacturerId

string

النتائج فقط. معرّف الشركة المصنّعة المكوّن من ثلاثة أحرف
modelId

integer

النتائج فقط. رمز المنتج الخاص بالشركة المصنّعة
manufactureYear

integer

النتائج فقط. تمثّل هذه السمة سنة التصنيع.
serialNumber

integer

النتائج فقط. الرقم التسلسلي
edidVersion

string

النتائج فقط. إصدار EDID

TouchScreenInfo

معلومات عن شاشة اللمس على الجهاز

تمثيل JSON 
{
  "touchpadLibrary": string,
  "devices": [
    {
      object (TouchScreenDevice)
    }
  ]
}
الحقول
touchpadLibrary

string

النتائج فقط. اسم مكتبة لوحة اللمس المستخدَمة في حزمة الإدخال
devices[]

object (TouchScreenDevice)

النتائج فقط. قائمة الأجهزة المزودة بشاشة تعمل باللمس مدمَجة

TouchScreenDevice

معلومات عن جهاز مزوّد بشاشة تعمل باللمس مدمَجة

تمثيل JSON 
{
  "displayName": string,
  "touchPointCount": integer,
  "stylusCapable": boolean
}
الحقول
displayName

string

النتائج فقط. اسم العرض لجهاز الشاشة التي تعمل باللمس
touchPointCount

integer

النتائج فقط. عدد نقاط اللمس المتاحة على الجهاز
stylusCapable

boolean

النتائج فقط. تحديد ما إذا كان الجهاز الذي يعمل باللمس متوافقًا مع القلم الإلكتروني أو لا

GraphicsStatusReport

معلومات النظام الفرعي للرسومات

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceGraphicsInfo
  • معدّل تكرار جمع البيانات: 3 ساعات
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_GRAPHICS_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "displays": [
    {
      object (DisplayInfo)
    }
  ]
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه تسجيل بيانات الرسومات

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
displays[]

object (DisplayInfo)

النتائج فقط. معلومات عن شاشات الجهاز

DisplayInfo

معلومات عن شاشة العرض

تمثيل JSON 
{
  "deviceId": string,
  "resolutionWidth": integer,
  "resolutionHeight": integer,
  "refreshRate": integer,
  "isInternal": boolean,
  "displayName": string,
  "serialNumber": integer,
  "edidVersion": string
}
الحقول
deviceId

string (int64 format)

النتائج فقط. تمثّل هذه السمة معرّف جهاز بطاقة الرسومات.
resolutionWidth

integer

النتائج فقط. عرض الدقة بالبكسل.
resolutionHeight

integer

النتائج فقط. تمثّل هذه السمة ارتفاع الدقة بالبكسل.
refreshRate

integer

النتائج فقط. معدّل إعادة التحميل بالهرتز
isInternal

boolean

النتائج فقط. توضّح هذه السمة ما إذا كان العرض داخليًا أم لا.
displayName

string

النتائج فقط. عرض اسم الجهاز
serialNumber

integer

النتائج فقط. الرقم التسلسلي
edidVersion

string

النتائج فقط. إصدار EDID

BatteryInfo

تعرض هذه السمة معلومات عن البطارية.

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDevicePowerStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • الإذن الدقيق المطلوب: TELEMETRY_API_BATTERY_INFO
تمثيل JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "designCapacity": string,
  "designMinVoltage": integer,
  "manufactureDate": {
    object (Date)
  },
  "technology": string
}
الحقول
serialNumber

string

النتائج فقط. الرقم التسلسلي للبطارية
manufacturer

string

النتائج فقط. الشركة المصنّعة للبطارية
designCapacity

string (int64 format)

النتائج فقط. سعة التصميم (ميلي أمبير للساعة).
designMinVoltage

integer

النتائج فقط. الحد الأدنى للجهد الكهربائي الخارج (مللي فولت) المُصمَّم
manufactureDate

object (Date)

النتائج فقط. تاريخ تصنيع البطارية
technology

string

النتائج فقط. تقنية البطارية مثال: ليثيوم أيون

BatteryStatusReport

بيانات الحالة الخاصة بالبطارية

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDevicePowerStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • الإذن الدقيق المطلوب: TELEMETRY_API_BATTERY_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "serialNumber": string,
  "sample": [
    {
      object (BatterySampleReport)
    }
  ],
  "batteryHealth": enum (BatteryHealth),
  "fullChargeCapacity": string,
  "cycleCount": integer
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت جمع العيّنة على الجهاز

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
serialNumber

string

النتائج فقط. الرقم التسلسلي للبطارية
sample[]

object (BatterySampleReport)

النتائج فقط. بيانات أخذ العيّنات للبطارية مرتّبة تنازليًا حسب reportTime.
batteryHealth

enum (BatteryHealth)

النتائج فقط. حالة البطارية
fullChargeCapacity

string (int64 format)

النتائج فقط. سعة الشحن الكاملة (ميلي أمبير للساعة)
cycleCount

integer

النتائج فقط. عدد دورات الشحن

BatterySampleReport

بيانات أخذ العينات للبطارية

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDevicePowerStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
تمثيل JSON 
{
  "reportTime": string,
  "voltage": string,
  "remainingCapacity": string,
  "temperature": integer,
  "dischargeRate": integer,
  "chargeRate": integer,
  "current": string,
  "status": string
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت جمع العيّنة على الجهاز

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
voltage

string (int64 format)

النتائج فقط. جهد البطارية (مللي فولت)
remainingCapacity

string (int64 format)

النتائج فقط. سعة البطارية المتبقية (ميلي أمبير للساعة)
temperature

integer

النتائج فقط. درجة الحرارة بالدرجة المئوية.
dischargeRate

integer

النتائج فقط. يتم قياس معدّل تفريغ البطارية بالميغاواط. ويكون موجبًا في حال تفريغ البطارية، وسالبًا إذا كانت مشحونة.
chargeRate

integer

النتائج فقط. النسبة المئوية لشحن البطارية
current

string (int64 format)

النتائج فقط. تيار البطارية (ملّي أمبير)
status

string

النتائج فقط. تمت قراءة حالة البطارية من sysfs. مثال: تفريغ الشحن

BatteryHealth

تمثّل هذه السمة حالة البطارية الحالية.

  • لا تشير هذه الحالة إلى وجود عيب في البطارية. يتم احتسابها من خلال قسمة سعة الشحن الكاملة الحالية على سعة التصميم.
  • ويعود إلى الشركة المصنّعة تحديد سلامة البطارية وسياسة الضمان.
عمليات التعداد
BATTERY_HEALTH_UNSPECIFIED الحالة الصحية غير معروفة
BATTERY_HEALTH_NORMAL البطارية سليمة، سعة الشحن الكاملة / سعة التصميم > %80
BATTERY_REPLACE_SOON حالة البطارية غير جيدة إلى حدّ ما ويُنصح باستبدالها قريبًا، سعة الشحن الكاملة / سعة التصميم %75 - %80
BATTERY_REPLACE_NOW البطارية غير سليمة ويُنصح باستبدالها، سعة الشحن الكاملة / سعة التصميم < %75

StorageInfo

بيانات الحالة الخاصة بمساحة التخزين

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceStorageStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • مطلوب إذن دقيق: TELEMETRY_API_STORAGE_INFO
تمثيل JSON 
{
  "volume": [
    {
      object (DiskVolume)
    }
  ],
  "availableDiskBytes": string,
  "totalDiskBytes": string
}
الحقول
volume[]

object (DiskVolume)

معلومات عن وحدات تخزين القرص
availableDiskBytes

string (int64 format)

تمثّل هذه السمة المساحة المتاحة لتخزين بيانات المستخدم على الجهاز بالبايت.
totalDiskBytes

string (int64 format)

تمثّل هذه السمة إجمالي مساحة تخزين بيانات المستخدم على الجهاز بالبايت.

DiskVolume

معلومات عن وحدات تخزين القرص

تمثيل JSON 
{
  "volumeId": string,
  "storageFreeBytes": string,
  "storageTotalBytes": string
}
الحقول
volumeId

string

معرّف وحدة تخزين القرص
storageFreeBytes

string (int64 format)

مساحة التخزين المجانية بالبايت
storageTotalBytes

string (int64 format)

تمثّل هذه السمة إجمالي مساحة التخزين بالبايت.

StorageStatusReport

بيانات الحالة الخاصة بمساحة التخزين

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceStorageStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب الحصول على إذن دقيق: TELEMETRY_API_STORAGE_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "disk": [
    {
      object (DiskInfo)
    }
  ]
}
الحقول
reportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت جمع العيّنة على الجهاز

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
disk[]

object (DiskInfo)

النتائج فقط. تقارير على القرص

DiskInfo

حالة جهاز التخزين الفردي

تمثيل JSON 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "sizeBytes": string,
  "type": string,
  "health": string,
  "volumeIds": [
    string
  ],
  "bytesReadThisSession": string,
  "bytesWrittenThisSession": string,
  "readTimeThisSession": string,
  "writeTimeThisSession": string,
  "ioTimeThisSession": string,
  "discardTimeThisSession": string
}
الحقول
serialNumber

string

النتائج فقط. الرقم التسلسلي للقرص
manufacturer

string

النتائج فقط. الشركة المصنِّعة للقرص
model

string

النتائج فقط. طراز القرص
sizeBytes

string (int64 format)

النتائج فقط. حجم القرص
type

string

النتائج فقط. نوع القرص: eMMC / NVMe / ATA / SCSI
health

string

النتائج فقط. حالة القرص
volumeIds[]

string

النتائج فقط. وحدات تخزين القرص
bytesReadThisSession

string (int64 format)

النتائج فقط. عدد وحدات البايت التي تمت قراءتها منذ آخر عملية تشغيل
bytesWrittenThisSession

string (int64 format)

النتائج فقط. عدد وحدات البايت التي تمت كتابتها منذ آخر عملية تشغيل
readTimeThisSession

string (Duration format)

النتائج فقط. الوقت الذي تم استخدامه في القراءة من القرص منذ آخر عملية تشغيل

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
writeTimeThisSession

string (Duration format)

النتائج فقط. الوقت المستغرَق في الكتابة على القرص منذ آخر عملية تشغيل

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
ioTimeThisSession

string (Duration format)

النتائج فقط. تحسب هذه السمة الوقت الذي كان فيه القرص وصفّ الانتظار مشغولَين، لذا على عكس الحقول أعلاه، لا يتم احتساب الطلبات المتوازية عدة مرات.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
discardTimeThisSession

string (Duration format)

النتائج فقط. الوقت المستغرَق في تجاهل الإشعارات منذ آخر عملية تشغيل عملية تجاهل البيانات هي الكتابة إلى وحدات تخزين فارغة لم يعُد يتم استخدامها. متوافق مع الإصدار 4.18 من النواة والإصدارات الأحدث

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"

ThunderboltInfo

معلومات ناقل Thunderbolt

  • يوفّر هذا الحقل معلومات الجهاز، وهي معلومات ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceSecurityStatus
  • معدّل تكرار جمع البيانات: عند بدء تشغيل الجهاز
  • معدّل تكرار إعداد التقارير التلقائي عن البيانات: عند بدء تشغيل الجهاز
    • التحكّم بالسياسات: لا
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • مطلوب إذن دقيق: TELEMETRY_API_BUS_DEVICE_INFO
تمثيل JSON 
{
  "securityLevel": enum (ThunderboltSecurityLevel)
}
الحقول
securityLevel

enum (ThunderboltSecurityLevel)

مستوى أمان ناقل Thunderbolt

ThunderboltSecurityLevel

مستوى أمان ناقل Thunderbolt

عمليات التعداد
THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED لم يتم ضبط مستوى أمان Thunderbolt.
THUNDERBOLT_SECURITY_NONE_LEVEL يتم ربط جميع الأجهزة تلقائيًا بواسطة البرامج الثابتة. لا يلزم الحصول على موافقة المستخدم.
THUNDERBOLT_SECURITY_USER_LEVEL يُسأل المستخدم عمّا إذا كان مسموحًا بتوصيل الجهاز.
THUNDERBOLT_SECURITY_SECURE_LEVEL يُسأل المستخدم عمّا إذا كان مسموحًا بتوصيل الجهاز. بالإضافة إلى ذلك، يتم إرسال تحدٍ إلى الجهاز يجب أن يتطابق مع التحدي المتوقّع استنادًا إلى مفتاح عشوائي مكتوب في سمة key sysfs.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL تنشئ البرامج الثابتة تلقائيًا قنوات لبروتوكول Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL تنشئ البرامج الثابتة تلقائيًا قنوات لوحدة التحكّم في USB ومنفذ DisplayPort في قاعدة توصيل. تتم إزالة جميع روابط PCIe التي تقع في اتجاه مجرى البيانات من قاعدة الإرساء.
THUNDERBOLT_SECURITY_NO_PCIE_LEVEL تم إيقاف الاتصال النفقي PCIE.

BootPerformanceReport

تقرير أداء تشغيل أحد الأجهزة

  • هذا الحقل هو معلومات قياس عن بُعد، وسيتغير بمرور الوقت عند استخدام الجهاز.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceBootMode
  • معدّل تكرار جمع البيانات: عند كل حدث تشغيل
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: نعم
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • الإذن الدقيق المطلوب: TELEMETRY_API_OS_REPORT
تمثيل JSON 
{
  "bootUpDuration": string,
  "bootUpTime": string,
  "shutdownDuration": string,
  "shutdownTime": string,
  "shutdownReason": enum (ShutdownReason),
  "reportTime": string
}
الحقول
bootUpDuration

string (Duration format)

إجمالي وقت التشغيل

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
bootUpTime

string (Timestamp format)

الطابع الزمني لوقت تشغيل الطاقة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
shutdownDuration

string (Duration format)

إجمالي الوقت منذ بدء إيقاف التشغيل حتى إيقاف الجهاز.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
shutdownTime

string (Timestamp format)

الطابع الزمني لوقت إيقاف التشغيل

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
shutdownReason

enum (ShutdownReason)

سبب إيقاف التشغيل
reportTime

string (Timestamp format)

الطابع الزمني لوقت جمع التقرير

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

ShutdownReason

سبب إيقاف التشغيل

عمليات التعداد
SHUTDOWN_REASON_UNSPECIFIED لم يتم تحديد سبب إيقاف التشغيل.
USER_REQUEST بدأها المستخدم.
SYSTEM_UPDATE تم بدء تحديث النظام.
LOW_BATTERY تم إيقاف التشغيل بسبب انخفاض طاقة البطارية.
OTHER تم إيقاف التشغيل لأسباب أخرى.

HeartbeatStatusReport

تقرير حالة الإشارة الدورية للجهاز

  • متوفّر لأجهزة Kiosk
  • يوفر هذا الحقل حالة الجهاز على الإنترنت أو بلا إنترنت أو غير معروفة، ولن يتم تضمينه إلا إذا تغيّرت الحالة (على سبيل المثال، من "متصل بالإنترنت" إلى "غير متصل بالإنترنت").
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: HeartbeatEnabled مزيد من المعلومات
  • معدّل تكرار إشارة نبض القلب: دقيقتان
    • ملاحظة: إذا انقطع اتصال الجهاز بالإنترنت، قد يستغرق تعديل حالة اتصال الجهاز ما يصل إلى 12 دقيقة.
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: غير متوفر
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "state": enum (State)
}
الحقول
reportTime

string (Timestamp format)

الطابع الزمني لرصد تغيير الحالة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
state

enum (State)

الحالة التي تم تغيير الجهاز إليها

ولاية

حالة الجهاز

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد الولاية
UNKNOWN الجهاز غير مؤهَّل لمراقبة نبضات القلب
ONLINE الجهاز متصل بالإنترنت
OFFLINE الجهاز غير متصل بالإنترنت.
DEVICE_OUTDATED الجهاز قديم

KioskAppStatusReport

تقرير حالة تطبيق Kiosk على أحد الأجهزة

  • متوفّر لأجهزة Kiosk
  • يوفّر هذا الحقل رقم تعريف التطبيق ورقم الإصدار اللذين يتم تشغيلهما على جهاز Kiosk والطابع الزمني لآخر مرة تم فيها تعديل التقرير.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: ReportDeviceSessionStatus
  • معدّل تكرار جمع البيانات: عند التحميل فقط
  • معدّل تكرار إعداد التقارير التلقائي للبيانات: 3 ساعات
    • التحكّم في السياسة: نعم
  • ذاكرة التخزين المؤقت: إذا كان الجهاز غير متصل بالإنترنت، يتم تخزين البيانات التي تم جمعها محليًا، وسيتم إرسالها عند اتصال الجهاز بالإنترنت في المرة التالية: لا
  • يتم تسجيل هذا الحدث للمستخدمين التابعين فقط: غير متوفّر
  • يجب منح إذن دقيق: TELEMETRY_API_APPS_REPORT
تمثيل JSON 
{
  "reportTime": string,
  "appId": string,
  "appVersion": string
}
الحقول
reportTime

string (Timestamp format)

الطابع الزمني لوقت جمع التقرير

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
appId

string

معرّف تطبيق Kiosk، مثل "mdmkkicfmmkgmpkmkdikhlbggogpicma"
appVersion

string

رقم إصدار تطبيق Kiosk، مثل "1.10.118"

RuntimeCountersReport

عدّادات وقت التشغيل التي يتم استردادها من وحدة المعالجة المركزية في الوقت الحالي، لا تتوافق بيانات القياس عن بُعد لعدّادات وقت التشغيل إلا مع ميزة PSR في Intel vPro على الإصدار 14 أو الإصدارات الأحدث.

تمثيل JSON 
{
  "reportTime": string,
  "uptimeRuntimeDuration": string,
  "enterSleepCount": string,
  "enterHibernationCount": string,
  "enterPoweroffCount": string
}
الحقول
reportTime

string (Timestamp format)

الطابع الزمني لوقت جمع التقرير

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
uptimeRuntimeDuration

string (Duration format)

إجمالي مدة التشغيل منذ البداية يتم حاليًا دائمًا استخدام وقت التشغيل S0 من Intel vPro PSR.

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
enterSleepCount

string (int64 format)

عدد المرات التي دخل فيها الجهاز في حالة السكون. يتم الحصول عليها حاليًا من خلال PSR، ويتم احتسابها من S0 إلى S3.
enterHibernationCount

string (int64 format)

عدد المرات التي دخل فيها الجهاز في وضع الإسبات. يتم الحصول عليها حاليًا من خلال PSR، ويتم احتسابها من S0 إلى S4.
enterPoweroffCount

string (int64 format)

عدد المرات التي دخل فيها الجهاز في حالة إيقاف التشغيل. يتم الحصول عليها حاليًا من خلال تقرير حالة البرنامج، ويتم احتسابها من S0 إلى S5.

الطُرق

get

 الحصول على جهاز قياس عن بُعد

list

 أدرِج جميع أجهزة القياس عن بُعد.