واجهة برمجة التطبيقات لإعداد التقارير: تقرير نشاط تدقيق الجهاز
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعرض تقرير نشاط تدقيق الجهاز معلومات عن الأنشطة التي تجريها جميع الأجهزة الخاضعة لإدارة نقاط النهاية من Google.
يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع مَعلمات خاصة بالتقرير، مثل البريد الإلكتروني للمستخدم. الحد الأقصى للفترة الزمنية لكل تقرير هو آخر 180 يومًا.
لا يجوز استخدام تقرير نشاط تدقيق الجهاز إلا للأغراض المشروعة وفقًا لاتفاقية العملاء. راجِع مقالة
المقارنة بين إصدارات Google Workspace
لمعرفة الإصدارات التي تتضمّن هذه التقارير.
استرداد أحداث تدقيق الأجهزة لنطاق
لاسترداد جميع أحداث تدقيق الأجهزة لجميع المستخدمين في نطاقك، استخدِم طلب HTTP التالي GET وأضِف رمز التفويض الموضّح في مستندات التفويض.
لمزيد من المعلومات عن سلاسل طلبات البحث وسمات الاستجابة، يُرجى الاطّلاع على أحداث أنشطة تدقيق الأجهزة.
لسهولة القراءة، تم تنسيق المثال التالي باستخدام أحرف الرجوع إلى أول السطر:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page
يحصل المثال التالي على تقرير عن جميع أحداث تدقيق الأجهزة في حسابك
خلال آخر 180 يومًا. تعرض مَعلمة طلب البحث maxResults 25 نتيجة لكل صفحة.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
يحصل المثال التالي على تقرير عن جميع أحداث تدقيق الأجهزة خلال آخر 180 يومًا. تحدّد customerId تقرير أي عميل يتم استرجاعه.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb
استرداد أحداث تدقيق الجهاز حسب اسم الحدث
في بعض الحالات، قد تحتاج إلى استرداد أحداث معيّنة، مثل أحداث النشاط المريب. لإجراء ذلك، استخدِم طلب GET HTTP بالشكل التالي:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameterrelational operatorparameter value
يوضّح المثال التالي كيفية استرداد جميع أحداث النشاط المريب لمستخدمي Android ضمن النطاق:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Reports API: Device Audit Activity Report\n\nThe device audit activity report returns information on activities by all\ndevices under\n[Google endpoint management](https://support.google.com/a/answer/1734200).\nEach report uses the basic report endpoint request with report-specific\nparameters such as a user's email. The maximum time period for each report is\nthe last 180 days.\n\nThe device audit activity report may be used only for lawful purposes in\naccordance with your Customer Agreement. See\n[Compare Google Workspace editions](https://support.google.com/a/answer/6043385#reports)\nto find which editions include these reports.\n\nRetrieve device audit events for a domain\n-----------------------------------------\n\nTo retrieve all device audit events for all users within your domain, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](/workspace/admin/reports/v1/guides/authorizing).\nFor more information about the request query strings and response properties,\nsee\n[Device Audit Activity Events](/workspace/admin/reports/v1/appendix/activity/mobile).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/mobile?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's device audit events\nfor the past 180 days. The `maxResults` query parameter returns 25 results per\npage. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25\n```\n\nThe following example gets a report on all device audit events for the past 180\ndays. The `customerId` specifies which customer's report is retrieved. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb\n```\n\nRetrieve device audit events by event name\n------------------------------------------\n\nIn some instances, you may want to retrieve specific\n[events](/workspace/admin/reports/v1/appendix/activity/mobile),\nsuch as suspicious activity events. To do this, use a `GET` HTTP request in\nthe following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/mobile?maxResults=maximum number of events returned on a response page\n&eventName=name of the event\n&filters=event parameter relational operator parameter value\n```\n\nThe following example shows how to retrieve all suspicious activity events for\nAndroid users within the domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25\n```"]]
