Method: activities.list

يسترجع هذا الطلب قائمة الأنشطة لحساب عميل وتطبيق معيّنَين، مثل تطبيق "وحدة تحكّم المشرف" أو تطبيق Google Drive. لمزيد من المعلومات، يُرجى الاطّلاع على الأدلة المتعلّقة بتقارير نشاط المشرف وGoogle Drive. لمزيد من المعلومات عن مَعلمات تقرير النشاط، اطّلِع على الأدلّة المرجعية لمَعلمات النشاط.

طلب HTTP

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

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

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

المعلمات
userKey

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، يعرض التقرير جميع الأنشطة من endTime حتى الوقت الحالي أو آخر 180 يومًا إذا كان endTime قبل أكثر من 180 يومًا.startTimestartTime
eventName

string

اسم الحدث الذي تبحث عنه واجهة برمجة التطبيقات. يرتبط كل eventName بخدمة أو ميزة معيّنة في Google Workspace تنظّمها واجهة برمجة التطبيقات إلى أنواع من الأحداث. ومن الأمثلة على ذلك أحداث "تقويم Google" في تقارير تطبيق "وحدة تحكّم المشرف". تحتوي بنية إعدادات "تقويم Google" type على جميع أنشطة "تقويم Google" eventName التي تسجّلها واجهة برمجة التطبيقات. عندما يغيّر المشرف إعداد "تقويم Google"، تسجّل واجهة برمجة التطبيقات هذا النشاط في المَعلمتَين type وeventName في إعدادات "تقويم Google". لمزيد من المعلومات عن سلاسل طلبات البحث والمَعلمات في 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

string

رقم تعريف الوحدة التنظيمية المطلوب إعداد تقارير عنها. لن يتم عرض سجلات الأنشطة إلا للمستخدمين الذين ينتمون إلى الوحدة التنظيمية المحدّدة.

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"

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

نموذج JSON لمجموعة من الأنشطة

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

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات بالنسبة إلى تقرير النشاط، تكون القيمة هي reports#activities.
etag

string

علامة ETag للمورد
items[]

object (Activity)

كل سجلّ نشاط في الاستجابة
nextPageToken

string

رمز مميّز لاسترداد الصفحة التالية للمتابعة في التقرير يتم استخدام القيمة nextPageToken في سلسلة طلب البحث pageToken الخاصة بالطلب.

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

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

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

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

ApplicationName

عمليات التعداد
access_transparency

تعرض تقارير نشاط "شفافية الوصول إلى Google Workspace" معلومات عن الأنواع المختلفة من أحداث نشاط "شفافية الوصول".
admin

تعرض تقارير النشاط في تطبيق "وحدة تحكُّم المشرف" معلومات الحساب عن أنواع مختلفة من أحداث نشاط المشرف.
calendar

تعرِض تقارير النشاط في تطبيق "تقويم Google" معلومات عن أحداث نشاط "تقويم Google" المختلفة.
chat تعرِض تقارير نشاط Chat معلومات عن أحداث نشاط Chat المختلفة.
drive

تعرض تقارير النشاط في تطبيق Google Drive معلومات عن أحداث نشاط Google Drive المختلفة. لا يتوفّر تقرير نشاط Drive إلا لعملاء Google Workspace Business وEnterprise.
gcp تعرِض تقارير نشاط تطبيق Google Cloud Platform معلومات عن أحداث نشاط Google Cloud Platform المختلفة.
gplus تعرِض تقارير النشاط في تطبيق Google+ معلومات عن أحداث النشاط على Google+ المختلفة.
groups

تعرِض تقارير النشاط في تطبيق "مجموعات Google" معلومات عن أحداث نشاط "مجموعات Google" المختلفة.
groups_enterprise

تعرِض تقارير نشاط "مجموعات Google" لإصدار 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 وEnterprise.
vault تعرض تقارير نشاط Vault معلومات حول الأنواع المختلفة من أحداث نشاط Vault.

النشاط

نموذج JSON لمورد النشاط

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
الحقول
kind

string

نوع مورد واجهة برمجة التطبيقات بالنسبة إلى تقرير النشاط، تكون القيمة هي audit#activity.
etag

string

علامة ETag للإدخال
ownerDomain

string

هذا هو النطاق المتأثر بحدث التقرير. على سبيل المثال، نطاق "وحدة تحكّم المشرف" أو مالك المستند في تطبيق Drive.
ipAddress

string

عنوان IP للمستخدم الذي يتّخذ الإجراء هذا هو عنوان بروتوكول الإنترنت (IP) للمستخدم عند تسجيل الدخول إلى Google Workspace، وقد يعكس الموقع الجغرافي للمستخدم أو لا يعكسه. على سبيل المثال، يمكن أن يكون عنوان IP هو عنوان خادم الوكيل الخاص بالمستخدم أو عنوان شبكة افتراضية خاصة (VPN). تتيح واجهة برمجة التطبيقات IPv4 وIPv6.
events[]

object

أحداث النشاط في التقرير
events[].type

string

نوع الحدث يتم تحديد خدمة أو ميزة Google Workspace التي يغيرها المشرف في السمة type، وهي تحدد حدثًا باستخدام السمة eventName. للحصول على قائمة كاملة بفئات type الخاصة بواجهة برمجة التطبيقات، يمكنك الاطّلاع على قائمة أسماء الأحداث للتطبيقات المختلفة أعلاه في applicationName.
events[].name

string

اسم الحدث هذا هو الاسم المحدّد للنشاط الذي تُبلغ عنه واجهة برمجة التطبيقات. ترتبط كل eventName بخدمة أو ميزة محدَّدة في Google Workspace تنظّمها واجهة برمجة التطبيقات ضمن أنواع من الأحداث.
بالنسبة إلى مَعلمات طلب eventName بشكل عام:

  • إذا لم يتم تقديم eventName، يعرض التقرير جميع المثيلات المحتمَلة لـ eventName.
  • عند طلب eventName، يعرض ردّ واجهة برمجة التطبيقات جميع الأنشطة التي تتضمّن هذا eventName.

لمزيد من المعلومات عن مواقع eventName، اطّلِع على قائمة أسماء الأحداث للتطبيقات المختلفة أعلاه في applicationName.
events[].parameters[]

object

أزواج قيم المَعلمات لتطبيقات مختلفة لمزيد من المعلومات عن مَعلمات eventName، اطّلِع على قائمة أسماء الأحداث للتطبيقات المختلفة أعلاه في applicationName.
events[].parameters[].messageValue

object

أزواج قيم المَعلمات المُدمجة المرتبطة بهذه المَعلمة يتم عرض نوع القيمة المعقدة لمعلمة كقائمة بقيم المعلمات. على سبيل المثال، قد تكون قيمة معلمة العنوان هي [{parameter: [{name: city, value: abc}]}]
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

قيم المَعلمات
events[].parameters[].name

string

اسم المَعلمة
events[].parameters[].value

string

قيمة سلسلة المَعلمة
events[].parameters[].multiValue[]

string

قِيم السلاسل للمَعلمة
events[].parameters[].intValue

string (int64 format)

القيمة الصحيحة للمَعلمة
events[].parameters[].multiIntValue[]

string (int64 format)

القيم الصحيحة للمَعلمة
events[].parameters[].boolValue

boolean

القيمة المنطقية للمَعلمة
events[].parameters[].multiMessageValue[]

object

activities.list من messageValue عنصر
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

قيم المَعلمات
id

object

معرّف فريد لكل سجلّ نشاط
id.time

string

وقت حدوث النشاط يتم التعبير عن ذلك بالثواني حسب توقيت حقبة يونكس.
id.uniqueQualifier

string (int64 format)

مؤهّل فريد إذا كانت عدّة أحداث لها الوقت نفسه
id.applicationName

string

اسم التطبيق الذي ينتمي إليه الحدث. للاطّلاع على القيم المحتملة، اطّلِع على قائمة التطبيقات أعلاه في applicationName.
id.customerId

string

المعرّف الفريد لحساب Google Workspace
actor

object

المستخدم الذي يتّخذ الإجراء
actor.profileId

string

رقم تعريف الملف الشخصي الفريد للممثل على Google Workspace قد لا تكون هذه القيمة غير متوفّرة إذا لم يكن المُنفِّذ من مستخدمي Google Workspace، أو قد يكون الرقم 105250506097979753968 الذي يعمل كرقم تعريف عنصر نائب.
actor.email

string

تمثّل هذه السمة عنوان البريد الإلكتروني الرئيسي للمستخدم. قد لا يظهر هذا الحقل إذا لم يكن هناك عنوان بريد إلكتروني مرتبط بالمنفِّذ.
actor.callerType

string

نوع المُنفِّذ
actor.key

string

لا يظهر إلا عندما يكون callerType هو KEY. يمكن أن يكون consumer_key للمقدّم لطلبات OAuth 2LO API أو معرّف لحسابات الروبوت.