Method: customers.telemetry.events.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. رقم تعريف العميل أو "my_customer" استخدام العميل المرتبط بالحساب الذي يقدّم الطلب.
|
معامِلات طلب البحث
| المعلمات |
filter |
string
اختياريّ. يجب تضمين الموارد التي تتطابق مع الفلتر فقط. على الرغم من أنّ هذه المَعلمة اختيارية في الوقت الحالي، ستكون هذه المَعلمة مطلوبة. يُرجى تحديد نوع حدث واحد على الأقل. حقول الفلاتر المتوافقة: - deviceId
- userId
- deviceOrgUnitId
- userOrgUnitId
- timestamp
- eventType
"الطابع الزمني" يقبل الفلتر إما تنسيق Unix Epoch مللي ثانية أو RFC3339 UTC "Zulu" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. يجب إحاطة كلا التنسيقين بعلامات اقتباس مزدوجة بسيطة. أمثلة: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، "1679283943823".
|
readMask |
string (FieldMask format)
مطلوب. قراءة القناع لتحديد الحقول المطلوب عرضها على الرغم من أنّ هذا الحقل سيكون مطلوبًا في الوقت الحالي، سيصبح اختياريًا، بينما ستكون مَعلمة الفلتر التي تستخدِم نوع حدث مطلوبة. مسارات readMask المتوافقة هي: - جهاز
- المستخدم
- audioSevereUnderrunEvent
- usbPeripheralsEvent
- httpsLatencyChangeEvent
- networkStateChangeEvent
- wifiSignalStrengthEvent
- vpnConnectionStateChangeEvent
- appInstallEvent
- appUninstallEvent
- appLaunchEvent
- osCrashEvent
هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
pageSize |
integer
اختياريّ. الحد الأقصى لعدد النتائج المطلوب عرضها. القيمة التلقائية هي 100. الحد الأقصى للقيمة هو 1,000.
|
pageToken |
string
اختياريّ. رمز مميز لتحديد الصفحة التالية في القائمة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ على بيانات أحداث القياس عن بُعد لأحد العملاء
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"telemetryEvents": [
{
object (TelemetryEvent)
}
],
"nextPageToken": string
} |
| الحقول |
telemetryEvents[] |
object (TelemetryEvent)
أحداث القياس عن بُعد التي تم عرضها في الردّ
|
nextPageToken |
string
رمز مميز لتحديد الصفحة التالية في القائمة.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.telemetry.readonly
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eList telemetry events for a specific customer using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by device, user, organizational unit, timestamp, or event type using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eSpecify desired fields in the response using the \u003ccode\u003ereadMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of telemetry events and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.telemetry.readonly\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],[],null,[]]
