تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: activities.watch
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

طلب HTTP
مَعلمات المسار
معامِلات طلب البحث
نص الطلب
نص الاستجابة
- تمثيل JSON
نطاقات التفويض
ApplicationName

ابدأ بتلقّي إشعارات بشأن أنشطة الحساب. لمزيد من المعلومات، يُرجى الاطّلاع على تلقّي إشعارات فورية.

طلب HTTP

POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات

المعلمات
`userKey or all`	`string` يمثّل رقم تعريف الملف الشخصي أو عنوان البريد الإلكتروني للمستخدم الذي يجب فلترة البيانات له. يمكن أن يكون `all` لجميع المعلومات، أو `userKey` لرقم تعريف الملف الشخصي الفريد للمستخدم على Google Workspace أو عنوان بريده الإلكتروني الأساسي. يجب ألّا يكون مستخدمًا تم حذفه. بالنسبة إلى مستخدم تم حذفه، يمكنك طلب `users.list` في Directory API باستخدام `showDeleted=true`، ثم استخدام `ID` المعروض كـ `userKey`.
`applicationName`	`enum (ApplicationName)` اسم التطبيق المطلوب استرداد الأحداث منه.

userKey or all

string

يمثّل رقم تعريف الملف الشخصي أو عنوان البريد الإلكتروني للمستخدم الذي يجب فلترة البيانات له. يمكن أن يكون all لجميع المعلومات، أو userKey لرقم تعريف الملف الشخصي الفريد للمستخدم على Google Workspace أو عنوان بريده الإلكتروني الأساسي. يجب ألّا يكون مستخدمًا تم حذفه. بالنسبة إلى مستخدم تم حذفه، يمكنك طلب users.list في Directory API باستخدام showDeleted=true، ثم استخدام ID المعروض كـ userKey.

applicationName

enum (ApplicationName)

اسم التطبيق المطلوب استرداد الأحداث منه.

مَعلمات طلب البحث

المعلمات
`actorIpAddress`	`string` عنوان بروتوكول الإنترنت (IP) للمضيف الذي تم تنفيذ الحدث عليه. هذه طريقة إضافية لفلترة ملخّص التقرير باستخدام عنوان IP للمستخدم الذي يتم تسجيل نشاطه. قد يعكس عنوان IP هذا الموقع الجغرافي الفعلي للمستخدم أو لا يعكسه. على سبيل المثال، يمكن أن يكون عنوان IP هو عنوان خادم الوكيل الخاص بالمستخدم أو عنوان شبكة افتراضية خاصة (VPN). تتيح هذه المَعلمة استخدام إصدارَي عنوانَي IPv4 وIPv6.
`customerId`	`string` المعرّف الفريد للعميل الذي تريد استرداد بياناته.
`endTime`	`string` لضبط نهاية النطاق الزمني المعروض في التقرير يتم إدخال التاريخ بـ تنسيق RFC 3339، على سبيل المثال ‎2010-10-28T10:26:35.000Z. القيمة التلقائية هي الوقت التقريبي لطلب البيانات من واجهة برمجة التطبيقات. يتضمّن تقرير واجهة برمجة التطبيقات ثلاثة مفاهيم أساسية للوقت: تاريخ طلب واجهة برمجة التطبيقات لتقرير: وقت إنشاء واجهة برمجة التطبيقات للتقرير واسترداده. وقت بدء التقرير: بداية الفترة الزمنية المعروضة في التقرير. يجب أن يكون `startTime` قبل `endTime` (إذا تم تحديده) والوقت الحالي عند تقديم الطلب، وإلا ستعرض واجهة برمجة التطبيقات خطأ. وقت انتهاء التقرير: نهاية الفترة الزمنية المعروضة في التقرير. على سبيل المثال، يمكن أن تبدأ الفترة الزمنية للأحداث الملخّصة في تقرير معيّن في نيسان (أبريل) وتنتهي في أيار (مايو). ويمكن طلب التقرير نفسه في آب (أغسطس). في حال عدم تحديد `endTime`، يعرض التقرير جميع الأنشطة من `startTime` حتى الوقت الحالي أو آخر 180 يومًا إذا كان `endTime` قبل أكثر من 180 يومًا.`startTime`
`eventName`	`string` اسم الحدث الذي تبحث عنه واجهة برمجة التطبيقات. يرتبط كل `eventName` بخدمة أو ميزة معيّنة في Google Workspace تنظّمها واجهة برمجة التطبيقات إلى أنواع من الأحداث. ومن الأمثلة على ذلك أحداث "تقويم Google" في تقارير تطبيق "وحدة تحكّم المشرف". تحتوي بنية إعدادات "تقويم Google" `type` على جميع أنشطة "تقويم Google" `eventName` التي تسجّلها واجهة برمجة التطبيقات. عندما يغيّر مشرف إعدادًا في "تقويم Google"، تسجِّل واجهة برمجة التطبيقات هذا النشاط في مَعلمتَي إعدادات "تقويم Google" `type` و`eventName`. لمزيد من المعلومات عن سلاسل طلبات البحث والمَعلمات في `eventName`، اطّلِع على قائمة أسماء الأحداث للتطبيقات المختلفة أعلاه في `applicationName`.
`filters`	`string` سلسلة طلب البحث `filters` هي قائمة مفصولة بفواصل تتألف من مَعلمات الأحداث التي يتم التلاعب بها باستخدام عوامل التشغيل ذات الصلة. تكون مَعلمات الأحداث على الشكل `{parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...`. تكون مَعلمات الأحداث هذه مرتبطة بـ `eventName` معيّن. يتم عرض تقرير فارغ إذا لم تكن مَعلمة الطلب تنتمي إلى `eventName`. لمزيد من المعلومات عن حقول `eventName` المتاحة لكل تطبيق والمَعلمات المرتبطة بها، انتقِل إلى جدول ApplicationName، ثم انقر على صفحة "أحداث النشاط" في الملحق للتطبيق الذي تريده. في أمثلة أنشطة Drive التالية، تتألف القائمة المعروضة من جميع أحداث `edit` التي تتطابق فيها قيمة المَعلمة `doc_id` مع الشروط التي يحدّدها عامل التشغيل التعريفي. في المثال الأول، يعرض الطلب جميع المستندات المعدَّلة التي تكون قيمة `doc_id` فيها تساوي `12345`. في المثال الثاني، يعرض التقرير أي مستندات تم تعديلها حيث لا تساوي قيمة `doc_id` القيمة `98765`. يتم ترميز عامل التشغيل `<>` بترميز عنوان URL في سلسلة طلب البحث (`%3C%3E`): `GET...&eventName=edit&filters=doc_id==12345 GET...&eventName=edit&filters=doc_id%3C%3E98765` يتيح طلب البحث `filters` عوامل التشغيل التالية ذات الصلة: `==`: "يساوي". `<>`: لا يساوي يجب أن تكون مرمَّزة بترميز URL (%3C%3E). `<`: "أصغر من". يجب أن تكون عناوين URL مرمَّزة (%3C). `<=`: "أصغر من أو يساوي". يجب أن تكون مُرمّزة بعنوان URL (‎%3C=). `>`: "أكبر من". يجب أن يكون ترميزه بنظام عناوين URL (%3E). `>=`: "أكبر من أو يساوي". يجب أن تكون مُرمّزة لعنوان URL (%3E=). ملاحظة: لا تقبل واجهة برمجة التطبيقات قيمًا متعدّدة للمَعلمة نفسها. إذا تم تقديم مَعلمة أكثر من مرّة في طلب واجهة برمجة التطبيقات، لا تقبل واجهة برمجة التطبيقات سوى القيمة الأخيرة لهذه المَعلمة. بالإضافة إلى ذلك، إذا تم تقديم مَعلمة غير صالحة في طلب واجهة برمجة التطبيقات، تتجاهل واجهة برمجة التطبيقات هذه المَعلمة وتُعرِض الردّ المقابل للمَعلمات الصالحة المتبقية. إذا لم يتم طلب أي مَعلمات، يتم عرض جميع المَعلمات.
`maxResults`	`integer` لتحديد عدد سجلات الأنشطة التي يتم عرضها في كل صفحة استجابة. على سبيل المثال، إذا ضبط الطلب `maxResults=1` وكان التقرير يتضمّن نشاطَين، سيتضمّن التقرير صفحتَين. تحتوي سمة `nextPageToken` في الاستجابة على الرمز المميّز للصفحة الثانية. سلسلة طلب البحث `maxResults` اختيارية في الطلب. القيمة التلقائية هي 1000.
`orgUnitID (deprecated)`	`string` `Deprecated`. تم إيقاف هذا الحقل نهائيًا ولم يعُد متاحًا. رقم تعريف الوحدة التنظيمية المطلوب إعداد تقارير عنها. لن يتم عرض سجلات الأنشطة إلا للمستخدمين الذين ينتمون إلى الوحدة التنظيمية المحدّدة. ولن تظهر البيانات المسجّلة بتاريخ يسبق 17 كانون الأول (ديسمبر) 2018 ضمن النتائج التي تمت فلترتها.
`pageToken`	`string` الرمز المميّز لتحديد الصفحة التالية. يحتوي التقرير الذي يتضمّن صفحات متعددة على سمة `nextPageToken` في الاستجابة. في طلب المتابعة للحصول على الصفحة التالية من التقرير، أدخِل قيمة `nextPageToken` في سلسلة طلب البحث `pageToken`.
`startTime`	`string` لضبط بداية النطاق الزمني المعروض في التقرير يتم إدخال التاريخ بـ تنسيق RFC 3339، على سبيل المثال ‎2010-10-28T10:26:35.000Z. يعرض التقرير جميع الأنشطة من ‎`startTime` حتى ‎`endTime`. يجب أن يكون `startTime` قبل `endTime` (إذا تم تحديده) والوقت الحالي عند تقديم الطلب، وإلا ستعرض واجهة برمجة التطبيقات خطأ.
`groupIdFilter`	`string` أرقام تعريف المجموعات مفصولة بفواصل (مموَّهة) يتم فلترة أنشطة المستخدمين وفقًا لها، أي أنّ الردّ سيتضمّن أنشطة المستخدمين الذين ينتمون إلى رقم تعريف مجموعة واحد على الأقل من أرقام التعريف المذكورة هنا. التنسيق: "id:abc123,id:xyz456" ملاحظة مهمة: للفلترة حسب المجموعات، يجب إضافة المجموعات بوضوح إلى القائمة المسموح بها لمجموعات الفلترة. لمزيد من المعلومات حول إضافة مجموعات إلى القائمة المسموح بها لمجموعات الفلترة، يُرجى الاطّلاع على مقالة فلترة النتائج حسب "مجموعة Google" .

نص الطلب

يحتوي نص الطلب على مثال SubscriptionChannel.

نص الاستجابة

قناة إشعارات تُستخدَم للتتبّع المستمر لتغييرات الموارد

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string }

تمثيل JSON

{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}

الحقول
`id`	`string` معرّف UUID أو سلسلة فريدة مشابهة تُحدِّد هذه القناة.
`token`	`string` سلسلة عشوائية يتم إرسالها إلى العنوان المستهدَف مع كل إشعار يتم إرساله عبر هذه القناة. اختياريّ.
`expiration`	`string (int64 format)` تاريخ ووقت انتهاء صلاحية قناة الإشعارات، مُعبَّرًا عنه كطابع زمني لنظام التشغيل UNIX، بالمللي ثانية اختياريّ.
`type`	`string` نوع آلية الإرسال المستخدَمة لهذه القناة. يجب ضبط القيمة على `"web_hook"`.
`address`	`string` العنوان الذي يتم إرسال الإشعارات إليه لهذه القناة.
`payload`	`boolean` قيمة منطقية للإشارة إلى ما إذا كان يتم طلب الحمولة الحمولة هي البيانات التي يتم إرسالها في نص رسالة HTTP POST أو PUT أو PATCH، وتحتوي على معلومات مهمة عن الطلب. اختياريّ.
`params`	`map (key: string, value: string)` مَعلمات إضافية تتحكّم في سلوك قناة الإرسال اختياريّ. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`resourceId`	`string` معرّف غير شفاف يحدّد المورد الذي تتم مشاهدته على هذه القناة. أن تكون مستقرة على مستوى إصدارات واجهة برمجة التطبيقات المختلفة
`resourceUri`	`string` معرّف خاص بالإصدار للمورد الذي تتم مشاهدته
`kind`	`string` يحدِّد هذا الحقل القناة كقناة إشعارات تُستخدَم للتتبّع عن التغييرات في المورد "`api#channel`".

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/admin.reports.audit.readonly

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

ApplicationName