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)
    }
  ],
  "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)

النتائج فقط. تم تجميع تقارير حالة وحدة المعالجة المركزية (CPU) بشكل دوري بترتيب تنازلي بنسبة 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.

runtimeCountersReport[]

object (RuntimeCountersReport)

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

CpuInfo

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

  • يقدّم هذا الحقل معلومات عن الجهاز تكون ثابتة ولن تتغيّر بمرور الوقت.
  • يتم التحكّم في بيانات هذا الحقل من خلال السياسة: 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)

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

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

integer

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

keylockerSupported

boolean

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

keylockerConfigured

boolean

النتائج فقط. ما إذا تم ضبط قفل المفاتيح أم لا.TRUE = مفعّلة، FALSE = غير مفعّلة. يتم الإبلاغ فقط إذا كان KeylockerSupported = TRUE.

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

نوع بنية وحدة المعالجة المركزية (CPU).

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

CpuStatusReport

يوفر هذا الخيار معلومات عن حالة وحدة المعالجة المركزية (CPU).

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

sampleFrequency

string (Duration format)

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

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

cpuUtilizationPct

integer

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

cpuTemperatureInfo[]

object (CpuTemperatureInfo)

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

CpuTemperatureInfo

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

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

integer

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

label

string

النتائج فقط. تصنيف وحدة المعالجة المركزية (CPU) مثال: المجموعة الأساسية 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)

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

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

sampleFrequency

string (Duration format)

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

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

systemRamFreeBytes

string (int64 format)

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

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

lastUpdateCheckTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

lastRebootTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

النتائج فقط. معلومات عن محوّل الرسومات (GPU).

eprivacySupported

boolean

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

displayDevices[]

object (DisplayDevice)

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

touchScreenInfo

object (TouchScreenInfo)

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

GraphicsAdapterInfo

معلومات محوِّل الرسومات (GPU).

تمثيل 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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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

النتائج فقط. الحد الأدنى للجهد الكهربائي للإخراج (mV)

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

shutdownDuration

string (Duration format)

المدة الإجمالية منذ بدء إيقاف التشغيل

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

shutdownTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

shutdownReason

enum (ShutdownReason)

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

reportTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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)

طابع زمني لوقت اكتشاف تغيير الحالة

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

state

enum (State)

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

الحالة

حالة الجهاز

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

KioskAppStatusReport

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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

appId

string

رقم تعريف تطبيق Kiosk، على سبيل المثال "mdmkkicfmmkgmpkmkdikhlbggogpicma"

appVersion

string

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

RuntimeCountersReport

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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

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

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