- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ApplicationName
- النشاط
- جرِّبه الآن
استرداد قائمة الأنشطة لحساب وتطبيق عميل معين مثل تطبيق وحدة تحكم المشرف أو تطبيق Google Drive. لمزيد من المعلومات، يُرجى الاطّلاع على أدلة تقارير نشاط المشرف وGoogle Drive. لمزيد من المعلومات عن مَعلمات تقرير النشاط، يمكنك الاطّلاع على الأدلة المرجعية لمَعلمات النشاط.
طلب HTTP
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
userKey or all |
تمثل معرّف الملف الشخصي أو البريد الإلكتروني للمستخدم الذي يجب تصفية البيانات له. يمكن أن يكون |
applicationName |
اسم التطبيق الذي سيتم استرداد الأحداث له. |
معلمات طلب البحث
المَعلمات | |
---|---|
actorIpAddress |
عنوان بروتوكول الإنترنت (IP) للمضيف الذي وقع فيه الحدث. هذه طريقة إضافية لفلترة ملخّص التقرير باستخدام عنوان IP للمستخدِم الذي يتم الإبلاغ عن نشاطه. وقد يعكس عنوان IP هذا الموقع الجغرافي الفعلي للمستخدم أو لا يعكسه. على سبيل المثال، يمكن أن يكون عنوان IP هو عنوان الخادم الوكيل للمستخدم أو عنوان شبكة افتراضية خاصة (VPN). تتوافق هذه المَعلمة مع إصدارَي عنوانَي IPv4 وIPv6. |
customerId |
المعرّف الفريد للعميل لاسترداد البيانات له. |
endTime |
تحدِّد هذه السياسة نهاية النطاق الزمني المعروض في التقرير. التاريخ بتنسيق RFC 3339، على سبيل المثال 2010-10-28T10:26:35.000Z. القيمة التلقائية هي الوقت التقريبي لطلب البيانات من واجهة برمجة التطبيقات. يتضمن تقرير واجهة برمجة التطبيقات ثلاثة مفاهيم زمنية أساسية:
endTime ، يعرض التقرير جميع الأنشطة من "startTime " حتى الوقت الحالي أو آخر 180 يومًا إذا كانت قيمة السمة "startTime " أكثر من 180 يومًا في الماضي.
|
eventName |
اسم الحدث الذي تطلبه واجهة برمجة التطبيقات ويرتبط كل " |
filters |
سلسلة طلب البحث ترتبط مَعلمات الأحداث هذه بعنصر في أمثلة نشاط Drive التالية، تتكوّن القائمة التي يتم عرضها من جميع أحداث
يدعم طلب البحث
ملاحظة: لا تقبل واجهة برمجة التطبيقات قيمًا متعددة للمَعلمة نفسها. في حال تقديم مَعلمة أكثر من مرّة في طلب البيانات من واجهة برمجة التطبيقات، لن تقبل واجهة برمجة التطبيقات إلا القيمة الأخيرة منها. وبالإضافة إلى ذلك، إذا تم تقديم معلَمة غير صالحة في طلب البيانات من واجهة برمجة التطبيقات، تتجاهل واجهة برمجة التطبيقات هذه المَعلمة وتعرض الاستجابة المقابلة للمعلَمات الصالحة المتبقية. وإذا لم يتم طلب أي مَعلمات، يتم عرض جميع المَعلمات. |
maxResults |
لتحديد عدد سجلات النشاط التي تظهر في كل صفحة استجابة. على سبيل المثال، إذا ضبط الطلب |
orgUnitID |
رقم تعريف الوحدة التنظيمية المطلوب إعداد تقارير عنها. لن يتم عرض سجلّات النشاط إلا للمستخدمين الذين ينتمون إلى الوحدة التنظيمية المحدّدة. |
pageToken |
الرمز المميز لتحديد الصفحة التالية. تقرير يحتوي على صفحات متعددة يحتوي على السمة |
startTime |
تحدِّد بداية النطاق الزمني المعروض في التقرير. التاريخ بتنسيق RFC 3339، على سبيل المثال 2010-10-28T10:26:35.000Z. يعرض التقرير جميع الأنشطة من |
groupIdFilter |
أرقام تعريف المجموعات المفصولة بفواصل (التي يتم تشويشها) والتي تتم فلترة أنشطة المستخدمين عليها، بمعنى أن الرد سيحتوي فقط على أنشطة للمستخدمين الذين يشكلون جزءًا من واحد على الأقل من أرقام تعريف المجموعات المذكورة هنا. التنسيق: "id:abc123,id:xyz456" |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
نموذج JSON لمجموعة من الأنشطة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى تقرير النشاط، تكون القيمة هي |
etag |
علامة ETag للمورد. |
items[] |
كل سجل نشاط في الرد. |
nextPageToken |
رمز مميز لاسترداد الصفحة التالية للمتابعة من التقرير. يتم استخدام قيمة |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admin.reports.audit.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
ApplicationName
عمليات التعداد | |
---|---|
access_transparency |
تعرض تقارير نشاط "شفافية الوصول" في Google Workspace معلومات عن الأنواع المختلفة من أحداث نشاط "شفافية الوصول". |
admin |
تعرض تقارير النشاط لتطبيق وحدة تحكُّم المشرف معلومات الحساب حول الأنواع المختلفة من أحداث نشاط المشرف. |
calendar |
تعرض تقارير الأنشطة في تطبيق "تقويم Google" معلومات حول مختلف أحداث أنشطة التقويم. |
chat |
تعرض تقارير نشاط Chat معلومات عن أحداث نشاط Chat المختلفة. |
drive |
تعرض تقارير الأنشطة لتطبيق Google Drive معلومات حول أحداث أنشطة Google Drive المختلفة. لا يتوفر تقرير نشاط Drive إلا لعملاء Google Workspace Business وGoogle Workspace Enterprise. |
gcp |
تعرض تقارير النشاط في تطبيق Google Cloud Platform معلومات عن أحداث نشاط Google Cloud Platform المختلفة. |
gplus |
تعرض تقارير الأنشطة في تطبيق +Google معلومات حول أحداث أنشطة +Google المختلفة. |
groups |
تعرض تقارير نشاط تطبيق "مجموعات Google" معلومات حول مختلف أحداث نشاط "مجموعات Google". |
groups_enterprise |
تعرض تقارير نشاط مجموعات Enterprise معلومات حول أحداث أنشطة مجموعة Enterprise المختلفة. |
jamboard |
تعرض تقارير نشاط Jamboard معلومات حول أحداث نشاط Jamboard المختلفة. |
login |
تعرِض تقارير نشاط تطبيق تسجيل الدخول معلومات الحساب عن الأنواع المختلفة من أحداث نشاط تسجيل الدخول. |
meet |
يعرض تقرير نشاط تدقيق Meet معلومات عن الأنواع المختلفة من أحداث نشاط تدقيق Meet. |
mobile |
يعرض تقرير نشاط تدقيق الجهاز معلومات حول الأنواع المختلفة من أحداث نشاط تدقيق الجهاز. |
rules |
يعرض تقرير نشاط القواعد معلومات عن أنواع مختلفة من أحداث نشاط القواعد. |
saml |
يعرض تقرير نشاط SAML معلومات عن الأنواع المختلفة من أحداث نشاط SAML. |
token |
تعرض تقارير النشاط لتطبيق الرمز المميّز معلومات عن الحساب حول الأنواع المختلفة من أحداث نشاط الرمز المميّز. |
user_accounts |
تعرض تقارير نشاط تطبيق "حسابات المستخدمين" معلومات عن الحسابات حول أنواع مختلفة من أحداث نشاط حسابات المستخدمين. |
context_aware_access |
تعرض تقارير نشاط الوصول الواعي بالسياق معلومات عن أحداث رفض وصول المستخدمين بسبب قواعد الوصول الواعي بالسياق. |
chrome |
تعرض تقارير نشاط Chrome معلومات حول أحداث متصفّح Chrome ونظام التشغيل Chrome. |
data_studio |
تعرض تقارير نشاط "مركز البيانات" معلومات عن أنواع مختلفة من أحداث أنشطة "مركز البيانات". |
keep |
تعرض تقارير النشاط في تطبيق Keep معلومات عن أحداث أنشطة Google Keep المختلفة. لا يتوفر تقرير نشاط Keep إلا لعملاء Google Workspace Business وGoogle Workspace Enterprise. |
vault |
تعرض تقارير نشاط Vault معلومات حول الأنواع المختلفة لأحداث نشاط Vault. |
النشاط
نموذج JSON لمورد النشاط
تمثيل JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
الحقول | |
---|---|
kind |
نوع مورد واجهة برمجة التطبيقات. بالنسبة إلى تقرير النشاط، تكون القيمة هي |
etag |
علامة ETag للإدخال. |
ownerDomain |
هذا هو النطاق الذي سيتأثر بحدث التقرير. على سبيل المثال، نطاق وحدة تحكّم المشرف أو مالك مستند تطبيق Drive. |
ipAddress |
عنوان IP للمستخدم الذي ينفّذ الإجراء. هذا هو عنوان بروتوكول الإنترنت (IP) الخاص بالمستخدم عند تسجيل الدخول إلى Google Workspace، وقد يعكس ذلك الموقع الجغرافي للمستخدم أو لا يعكس ذلك. على سبيل المثال، يمكن أن يكون عنوان IP هو عنوان الخادم الوكيل للمستخدم أو عنوان شبكة افتراضية خاصة (VPN). تتوافق واجهة برمجة التطبيقات مع IPv4 وIPv6. |
events[] |
أحداث النشاط في التقرير |
events[].type |
نوع الحدث يتم تحديد خدمة أو ميزة Google Workspace التي يغيّرها المشرف في السمة |
events[].name |
اسم الحدث هذا هو الاسم المحدّد للنشاط الذي تم الإبلاغ عنه من خلال واجهة برمجة التطبيقات. ويرتبط كل
لمزيد من المعلومات عن خصائص eventName ، يمكنك الاطّلاع على قائمة أسماء الأحداث للتطبيقات المختلفة أعلاه في applicationName .
|
events[].parameters[] |
أزواج من قيم المَعلمات لتطبيقات مختلفة. لمزيد من المعلومات عن مَعلمات |
events[].parameters[].messageValue |
أزواج قيم المَعلمات المتداخلة المرتبطة بهذه المَعلمة. يتم عرض نوع القيمة المعقد للمَعلمة كقائمة من قيم المَعلمات. على سبيل المثال، قد تكون قيمة معلَمة العنوان هي |
events[].parameters[].messageValue.parameter[] |
قيم المَعلمات |
events[].parameters[].name |
اسم المَعلمة. |
events[].parameters[].value |
قيمة سلسلة المعلَمة |
events[].parameters[].multiValue[] |
قيم السلسلة للمَعلمة |
events[].parameters[].intValue |
قيمة عدد صحيح للمعلَمة |
events[].parameters[].multiIntValue[] |
تمثّل هذه السمة القيم الصحيحة للمَعلمة. |
events[].parameters[].boolValue |
قيمة منطقية للمَعلمة |
events[].parameters[].multiMessageValue[] |
activity.قائمة من |
events[].parameters[].multiMessageValue[].parameter[] |
قيم المَعلمات |
id |
المعرّف الفريد لكل سجلّ نشاط |
id.time |
وقت حدوث النشاط. هذا الوقت في حقبة UNIX بالثواني. |
id.uniqueQualifier |
مؤهِّل فريد إذا كانت هناك أحداث متعدّدة في الوقت نفسه. |
id.applicationName |
اسم التطبيق الذي ينتمي إليه الحدث. للاطّلاع على القيم المحتمَلة، راجِع قائمة التطبيقات أعلاه في |
id.customerId |
المعرّف الفريد لحساب Google Workspace |
actor |
المستخدم الذي ينفّذ الإجراء. |
actor.profileId |
تمثّل هذه السمة رقم التعريف الفريد للملف الشخصي للممثِّل على Google Workspace. قد تكون هذه القيمة غير متوفرة إذا لم يكن المنفِّذ من مستخدمي Google Workspace، أو قد يكون الرقم 105250506097979753968 الذي يعمل كرقم تعريف عنصر نائب. |
actor.email |
عنوان البريد الإلكتروني الرئيسي للمنفِّذ قد لا يتوفّر هذا الخيار إذا لم يكن هناك عنوان بريد إلكتروني مرتبط بالمنفِّذ. |
actor.callerType |
تمثّل هذه السمة نوع الممثل. |
actor.key |
لا يتوفّر العرض إلا عندما تكون قيمة الحقل " |