يمكنك البدء بتلقّي إشعارات عن أنشطة الحساب. لمزيد من المعلومات، راجع تلقّي إشعارات فورية.
طلب HTTP
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
يستخدم عنوان 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" |
نص الطلب
يحتوي نص الطلب على مثال SubscriptionChannel
.
نص الاستجابة
قناة إشعارات تُستخدم لمراقبة التغييرات في الموارد.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
الحقول | |
---|---|
id |
معرّف فريد عالمي (UUID) أو سلسلة فريدة مشابهة تحدّد هذه القناة. |
token |
سلسلة عشوائية يتم إرسالها إلى العنوان المستهدف مع كل إشعار يتم إرساله عبر هذه القناة. اختياريّ. |
expiration |
تاريخ ووقت انتهاء صلاحية قناة الإشعار، ويتم التعبير عنه بالطابع الزمني لنظام التشغيل Unix، بالمللي ثانية اختياريّ. |
type |
نوع آلية الإرسال المستخدمة لهذه القناة. يجب ضبط القيمة على |
address |
العنوان الذي تريد إرسال الإشعارات إليه لهذه القناة |
payload |
قيمة منطقية للإشارة إلى ما إذا كانت حمولة البيانات مطلوبة. حمولة البيانات هي البيانات المرسلة في نص رسالة HTTP POST أو PUT أو PATCH وتتضمن معلومات مهمة حول الطلب. اختياريّ. |
params |
معلمات إضافية تتحكم في سلوك قناة التسليم. اختياريّ. عنصر يحتوي على قائمة من أزواج |
resourceId |
رقم تعريف مبهم يحدد المورد الذي تتم مشاهدته على هذه القناة. ثابتة على مستوى الإصدارات المختلفة من واجهة برمجة التطبيقات. |
resourceUri |
تمثّل هذه السمة معرّفًا خاصًا بإصدار المورد الذي تتم مشاهدته. |
kind |
لتحديد ذلك كقناة إشعارات يتم استخدامها لمراقبة التغييرات في مورد، وهو " |
نطاقات التفويض
يجب توفير نطاق 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. |