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

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

architecture

enum (Architecture)

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

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

integer

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

keylockerSupported

boolean

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

keylockerConfigured

boolean

النتائج فقط. ما إذا تم ضبط ميزة "قفل المفاتيح"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

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

label

string

النتائج فقط. تصنيف وحدة المعالجة المركزية مثال: 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 مع كتلة تشفير بحجم 128 بت.
MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256 تستخدم خوارزمية تشفير الذاكرة خوارزمية التشفير AES_XTS مع كتلة تشفير بحجم 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)
}
الحقول
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)

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

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. يُرجى العِلم أنّه قد يكون هناك قيمة وهمية "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
}
الحقول
displayName

string

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

displayWidthMm

integer

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

displayHeightMm

integer

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

internal

boolean

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

manufacturerId

string

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

modelId

integer

النتائج فقط. رمز المنتج المحدّد من الشركة المصنّعة

manufactureYear

integer

النتائج فقط. سنة التصنيع

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
}
الحقول
deviceId

string (int64 format)

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

resolutionWidth

integer

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

resolutionHeight

integer

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

refreshRate

integer

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

isInternal

boolean

النتائج فقط. يشير إلى ما إذا كان العرض داخليًا أم لا.

displayName

string

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

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 من نواة Linux والإصدارات الأحدث.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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 يُطلب من المستخدم تحديد ما إذا كان يُسمح بتوصيل الجهاز. بالإضافة إلى ذلك، يتم إرسال طلب إلى الجهاز يجب أن يتطابق مع الطلب المتوقّع استنادًا إلى مفتاح عشوائي مكتوب في سمة sysfs للمفتاح.
THUNDERBOLT_SECURITY_DP_ONLY_LEVEL تنشئ البرامج الثابتة تلقائيًا قنوات اتصال لبروتوكول Thunderbolt.
THUNDERBOLT_SECURITY_USB_ONLY_LEVEL تنشئ البرامج الثابتة تلقائيًا قنوات اتصال لوحدة تحكّم USB وDisplay Port في محطة الإرساء. تتم إزالة جميع روابط 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

تم استرداد عدّادات وقت التشغيل من وحدة المعالجة المركزية. لا تتوفّر حاليًا إحصاءات عدّادات وقت التشغيل إلا من خلال Intel vPro PSR على الجيل 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)

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

الطُرق

get

الحصول على جهاز قياس الأداء

list

إدراج جميع أجهزة قياس الأداء