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 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 يومًا إذا كان startTime يسبق الوقت الحالي بأكثر من 180 يومًا.

بالنسبة إلى طلبات Gmail، يجب تقديم startTime وendTime، ويجب ألا يتجاوز الفرق بينهما 30 يومًا.
eventName

string

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

string

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

pageToken

string

الرمز المميز لتحديد الصفحة التالية. يحتوي التقرير الذي يتضمّن صفحات متعددة على السمة nextPageToken في الردّ. في طلبك اللاحق للحصول على الصفحة التالية من التقرير، أدخِل قيمة nextPageToken في سلسلة طلب البحث pageToken.
startTime

string

تضبط هذه السمة بداية النطاق الزمني المعروض في التقرير. يكون التاريخ بتنسيق RFC 3339، مثلاً 2010-10-28T10:26:35.000Z. يعرض التقرير جميع الأنشطة من ‎startTime إلى ‎endTime. يجب أن يكون startTime قبل endTime (إذا تم تحديده) والوقت الحالي عند تقديم الطلب، وإلا ستعرض واجهة برمجة التطبيقات رسالة خطأ.

بالنسبة إلى طلبات Gmail، يجب تقديم startTime وendTime، ويجب ألا يتجاوز الفرق بينهما 30 يومًا.
groupIdFilter

string

أرقام تعريف المجموعات المفصولة بفواصل (تم إخفاء هويتها) التي يتم فلترة أنشطة المستخدمين استنادًا إليها، أي أنّ الردّ سيتضمّن أنشطة للمستخدمين الذين ينتمون إلى رقم تعريف مجموعة واحد على الأقلّ من أرقام التعريف المذكورة هنا. التنسيق: "id:abc123,id:xyz456"

.
resourceDetailsFilter

string

اختياريّ. سلسلة طلب البحث resourceDetailsFilter هي قائمة مفصولة بـ AND تتألف من حقول تفاصيل المورد التي يتم التعامل معها باستخدام عوامل التشغيل العلائقية.

تكون فلاتر تفاصيل المرجع بالتنسيق {resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}...

يتم الانتقال إلى جميع الحقول الداخلية باستخدام عامل التشغيل .، كما هو موضّح في المثال التالي:

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId"

يتوافق طلب البحث resourceDetailsFilter مع عوامل التشغيل العلائقية التالية:

  • ‫=: "يساوي".
  • ‫!=: "لا يساوي".
  • ‫:—"موجود". يُستخدَم هذا الحقل لفلترة الحقول المتكرّرة.

تستخدم أنواع FieldValue التي تتكرّر بطبيعتها عامل التشغيل exists للفلترة.
تتكرّر أنواع FieldValue التالية:

على سبيل المثال، في الفلتر التالي، SelectionListValue هو حقل متكرّر. يتحقّق الفلتر مما إذا كان SelectionListValue يحتوي على selection_id:

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId" AND resourceDetails.appliedLabels.fieldValue.type =
"SELECTION_LIST_VALUE" AND
resourceDetails.appliedLabels.fieldValue.selectionListValue.id: "id"

الاستخدام

GET...&resourceDetailsFilter=resourceDetails.id = "resourceId" AND
resourceDetails.appliedLabels.id = "appliedLabelId"
GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22

يُرجى مراعاة ما يلي:

  • يجب ترميز سلسلة طلب البحث باستخدام ترميز URL قبل إرسال الطلب.

  • تتيح واجهة برمجة التطبيقات 5 حقول كحد أقصى مفصولة بعامل التشغيل AND.

  • عند الفلترة على مستويات أعمق (مثل AppliedLabel أو FieldValue)، يجب تضمين معرّفات جميع المستويات السابقة في التسلسل الهرمي في الفلتر. على سبيل المثال: تتطلّب الفلترة حسب FieldValue توفّر AppliedLabel ID وresourceDetails ID.
    نموذج طلب البحث:

    resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id = "appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id = "fieldValueId"

  • تتطلّب الفلترة حسب أنواع FieldValue الداخلية، مثل longTextValue وtextValue، توفّر resourceDetails.appliedLabels.fieldValue.type.

  • لا يمكن إجراء الفلترة إلا باستخدام معرّف AppliedLabel واحد ومعرّف FieldValue واحد.
networkInfoFilter

string

اختياريّ. يُستخدَم هذا الحقل لفلترة الحقل regionCode المتوفّر في الرسالة NetworkInfo.

الاستخدام

GET...&networkInfoFilter=regionCode="IN"
GET...&networkInfoFilter=regionCode=%22IN%22
statusFilter

string

اختياريّ. يُستخدَم هذا الحقل لفلترة الحقل statusCode المتوفّر في الرسالة Status.

الاستخدام

GET...&statusFilter=statusCode="200"
GET...&statusFilter=statusCode=%22200%22
applicationInfoFilter

string

اختياريّ. يُستخدَم هذا الحقل لفلترة الحقل oAuthClientId المتوفّر في الرسالة ApplicationInfo.

الاستخدام

GET...&applicationInfoFilter=oAuthClientId="clientId"
GET...&applicationInfoFilter=oAuthClientId=%22clientId%22
includeSensitiveData

boolean

اختياريّ. عند ضبط هذا الحقل على true، يسمح بتضمين المحتوى الحسّاس من إنشاء المستخدمين في سجلّات التدقيق التي يتم عرضها. لا تتوافق هذه المَعلمة إلا مع "القواعد" (منع فقدان البيانات) وتطبيقات Chat وWorkspace Studio، وسيؤدي استخدامها مع أي تطبيق آخر إلى حدوث خطأ في الأذونات.
agentInfoFilter

string

اختياريّ. فلاتر على حقول معلومات الوكيل في النشاط يتم تطبيق هذا الفلتر بالتزامن(AND) مع الفلاتر الأخرى. مثال: "agentInfoFilter=agentId="agent-id" AND agentName="agent-name" AND agentOwnerEmail="agent-owner-email""
deviceFilter

string

اختياريّ. يُستخدَم للفلترة حسب الحقول المتوفّرة في رسالة UserDeviceInfo، مثل deviceId وdeviceType وdeviceOsVersion.

الاستخدام

GET...&deviceFilter=deviceId="123"
GET...&deviceFilter=deviceType="ANDROID"
GET...&deviceFilter=deviceOsVersion="14.0"

نص الطلب

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

نص الاستجابة

نموذج 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 معلومات عن أحداث نشاط GCP المختلفة.
gmail تعرض تقارير النشاط في تطبيق Gmail معلومات عن أحداث نشاط Gmail المختلفة.
gplus تعرض تقارير النشاط في تطبيق Google+‎ معلومات حول أحداث النشاط المختلفة في Google+‎.
groups

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

تعرض تقارير النشاط في "مجموعات Google" لإصدار Enterprise معلومات عن أحداث النشاط المختلفة في "مجموعات Google" لإصدار Enterprise.
jamboard تعرض تقارير نشاط Jamboard معلومات عن أحداث نشاط Jamboard المختلفة.
login

تعرض تقارير النشاط في تطبيق "تسجيل الدخول" معلومات الحساب حول أنواع مختلفة من أحداث نشاط تسجيل الدخول.
meet يعرض تقرير "تدقيق Meet" معلومات عن أنواع مختلفة من أحداث أنشطة تدقيق Meet.
mobile يعرض تقرير نشاط "تدقيق الأجهزة" معلومات عن أنواع مختلفة من أحداث نشاط "تدقيق الأجهزة".
rules

يعرض تقرير "نشاط القواعد" معلومات عن أنواع مختلفة من أحداث نشاط القواعد.
saml

يعرض تقرير نشاط SAML معلومات عن أنواع مختلفة من أحداث نشاط SAML.
token

تعرض تقارير النشاط في تطبيق Token معلومات الحساب حول أنواع مختلفة من أحداث نشاط Token.
user_accounts

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

تعرض تقارير النشاط في ميزة "الوصول المستنِد إلى السياق" معلومات عن أحداث رفض وصول المستخدمين بسبب قواعد الوصول المستنِد إلى السياق.
chrome

تعرض تقارير نشاط Chrome معلومات عن أحداث متصفّح Chrome ونظام التشغيل Chrome.
data_studio تعرض تقارير الأنشطة في "مركز البيانات" معلومات حول أنواع مختلفة من أحداث الأنشطة في "مركز البيانات".
keep تعرض تقارير النشاط في تطبيق Keep معلومات حول أحداث النشاط المختلفة في Google Keep. لا يتوفّر تقرير "نشاط Keep" إلا لعملاء Google Workspace Business وEnterprise.
vault تعرض تقارير نشاط Vault معلومات عن أنواع مختلفة من أحداث نشاط Vault.
gemini_in_workspace_apps

تعرض تقارير النشاط على "Gemini في Workspace" معلومات حول أنواع مختلفة من أحداث النشاط على Gemini التي ينفّذها المستخدمون في أحد تطبيقات Workspace.
classroom تعرض تقارير النشاط في Classroom معلومات عن أنواع مختلفة من أحداث النشاط في Classroom.
assignments تعرض تقارير النشاط في تطبيق "المهام" معلومات عن أنواع مختلفة من أحداث نشاط المهام.
tasks تعرض تقارير النشاط في تطبيق "مهام Google" معلومات عن أنواع مختلفة من أحداث النشاط في "مهام Google".
data_migration تعرض تقارير النشاط في تطبيق "نقل البيانات" معلومات عن أنواع مختلفة من أحداث نشاط نقل البيانات.
meet_hardware تعرض تقارير نشاط تطبيق Meet Hardware معلومات عن أنواع مختلفة من أحداث نشاط Meet Hardware.
directory_sync تعرض تقارير النشاط الخاصة بتطبيق "أداة مزامنة الدليل" معلومات عن أنواع مختلفة من أحداث نشاط "أداة مزامنة الدليل".
ldap تعرض تقارير نشاط تطبيق ldap معلومات عن أنواع مختلفة من أحداث نشاط ldap.
profile تعرض تقارير النشاط في تطبيق "الملف الشخصي" معلومات عن أنواع مختلفة من أحداث نشاط "الملف الشخصي".
access_evaluation تعرض تقارير نشاط "تقييم الوصول" معلومات عن أنواع مختلفة من أحداث نشاط "تقييم الوصول".
admin_data_action تعرض تقارير النشاط في تطبيق "إجراءات بيانات المشرف" معلومات عن أنواع مختلفة من أحداث النشاط في "إجراءات بيانات المشرف".
contacts تعرض تقارير النشاط في تطبيق "جهات الاتصال" معلومات عن أنواع مختلفة من أحداث النشاط في "جهات الاتصال".
takeout تعرض تقارير النشاط في تطبيق Takeout معلومات عن أنواع مختلفة من أحداث النشاط في Takeout.
graduation تعرض تقارير النشاط في تطبيق Graduation معلومات عن أنواع مختلفة من أحداث نشاط Graduation.
voice تعرض تقارير النشاط في تطبيق Voice معلومات عن أنواع مختلفة من أحداث نشاط Voice.
chrome_sync تعرض تقارير نشاط تطبيق "مزامنة Chrome" معلومات عن أنواع مختلفة من أحداث نشاط "مزامنة Chrome".
workspace_studio تعرض تقارير النشاط في تطبيق Workspace Studio معلومات عن أنواع مختلفة من أحداث النشاط في Workspace Studio.

النشاط

نموذج 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)
                }
              ]
            }
          ]
        }
      ],
      "sensitiveParameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ],
      "status": {
        object (Status)
      }
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    },
    "agentAttributionInfo": {
      object (AgentAttributionInfo)
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ],
  "isAgenticAction": boolean,
  "userDeviceInfo": {
    object (UserDeviceInfo)
  }
}
الحقول
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 of messageValue objects.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

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

object

تتضمّن أزواج قيم المَعلمات الحسّاسة لمختلف التطبيقات.
events[].sensitiveParameters[].messageValue

object

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

object (NestedParameter)

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

string

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

string

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

string

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

string (int64 format)

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

string (int64 format)

قيم الأعداد الصحيحة للمَعلمة
events[].sensitiveParameters[].boolValue

boolean

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

object

‫activities.list of messageValue objects.
events[].sensitiveParameters[].multiMessageValue[].parameter[]

object (NestedParameter)

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

string

معرّفات الموارد المرتبطة بالحدث.
events[].status

object (Status)

تمثّل هذه السمة حالة الحدث. ملاحظة: لا تتضمّن بعض الأحداث حالة.
id

object

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

string

وقت حدوث النشاط هذا هو وقت حقبة UNIX بالثواني.
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 أو معرّفًا لحسابات الروبوت.
actor.applicationInfo

object

تفاصيل التطبيق الذي نفّذ النشاط.
actor.applicationInfo.oauthClientId

string

معرّف عميل OAuth الخاص بالتطبيق الخارجي المستخدَم لتنفيذ الإجراء
actor.applicationInfo.applicationName

string

اسم التطبيق المستخدَم لتنفيذ الإجراء.
actor.applicationInfo.impersonation

boolean

ما إذا كان التطبيق ينتحل هوية مستخدم
actor.agentAttributionInfo

object (AgentAttributionInfo)

تفاصيل عن وكيل الذكاء الاصطناعي الذي نفّذ النشاط
networkInfo

object (NetworkInfo)

معلومات الشبكة الخاصة بالمستخدم الذي ينفّذ الإجراء.
resourceDetails[]

object (ResourceDetails)

تفاصيل المورد الذي تم تنفيذ الإجراء عليه.
isAgenticAction

boolean

تُستخدَم لتحديد ما إذا كان النشاط قد تم تنفيذه بواسطة وكيل.
userDeviceInfo

object (UserDeviceInfo)

تفاصيل جهاز المستخدم الذي ينفّذ الإجراء لا يتم عرض هذا الحقل إلا للتطبيقات contacts وgemini_in_workspace_apps وkeep وmeet_hardware وmeet وchat وchrome وdirectory_sync وdrive وgroups وrules وdata_studio وsaml.

NetworkInfo

معلومات الشبكة الخاصة بالمستخدم الذي ينفّذ الإجراء.

تمثيل JSON 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
الحقول
ipAsn[]

integer

عنوان IP للمستخدم الذي ينفّذ الإجراء.
regionCode

string

رمز المنطقة المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2 الخاص بالمستخدم الذي ينفّذ الإجراء.
subdivisionCode

string

رمز المنطقة (الولايات والمقاطعات) وفقًا لمعيار ISO 3166-2 في البلدان التي ينتمي إليها المستخدِم الذي ينفّذ الإجراء

ResourceDetails

تفاصيل المورد الذي تم تنفيذ الإجراء عليه.

تمثيل JSON 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string,
  "ownerDetails": {
    object (OwnerDetails)
  }
}
الحقول
id

string

معرّف المورد، مثل doc_id لمستند Drive أو conference_id لمكالمة فيديو في Meet أو "gaia_id/rfc2822_message_id" لرسالة إلكترونية
title

string

تمثّل هذه السمة عنوان المرجع. على سبيل المثال، في حال مستند على Drive، سيكون هذا هو عنوان المستند. في حال تلقّي رسالة إلكترونية، سيكون هذا هو الموضوع.
type

string

نوع المرجع: مستند أو رسالة إلكترونية أو رسالة محادثة
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

تحدّد هذه السمة علاقة المورد بالأحداث
ownerDetails

object (OwnerDetails)

تفاصيل مالك المرجع.

AppliedLabel

تفاصيل التصنيف المطبّق على المرجع

تمثيل JSON 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
الحقول
id

string

معرّف التصنيف - رقم تعريف التصنيف فقط، وليس اسم مورد OnePlatform الكامل
title

string

عنوان التصنيف
fieldValues[]

object (FieldValue)

activities.list of fields which are part of the label and have been set by the user. إذا كان التصنيف يتضمّن حقلًا لم يحدّده المستخدم، لن يكون هذا الحقل مدرَجًا في هذه القائمة.
reason

object (Reason)

سبب تطبيق التصنيف على المرجع

FieldValue

تفاصيل قيمة الحقل التي يضبطها المستخدم للتصنيف المحدّد

تمثيل JSON 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
}
الحقول
id

string

معرّف الحقل
displayName

string

الاسم المعروض للحقل
type

string

نوع الحقل
reason

object (Reason)

سبب تطبيق الحقل على التصنيف
حقل الربط value يمكن أن تكون القيم المخزّنة في الحقل value إحدى القيم التالية فقط:
unsetValue

boolean

إذا لم يتم ضبط الحقل، ستكون القيمة صحيحة.
longTextValue

string

ضبط قيمة نص طويل
textValue

string

ضبط قيمة نصية
textListValue

object (TextListValue)

ضبط قيمة قائمة النص
selectionValue

object (SelectionValue)

ضبط قيمة اختيارية من خلال تحديد قيمة واحدة من قائمة منسدلة
selectionListValue

object (SelectionListValue)

ضبط قيمة قائمة اختيار من خلال اختيار قيم متعددة من قائمة منسدلة
integerValue

string (int64 format)

ضبط قيمة عدد صحيح
userValue

object (UserValue)

ضبط قيمة مستخدم من خلال اختيار مستخدم واحد
userListValue

object (UserListValue)

ضبط قيمة قائمة مستخدمين من خلال اختيار عدة مستخدمين
dateValue

object (Date)

ضبط قيمة التاريخ

TextListValue

ضبط قيمة قائمة النص

تمثيل JSON 
{
  "values": [
    string
  ]
}
الحقول
values[]

string

أنشطة.قائمة قيم النص.

SelectionValue

ضبط قيمة اختيارية من خلال تحديد قيمة واحدة من قائمة منسدلة

تمثيل JSON 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
الحقول
id

string

معرّف التحديد
displayName

string

الاسم المعروض للاختيار.
badged

boolean

توضّح هذه السمة ما إذا كان العنصر المحدّد يحمل شارة.

SelectionListValue

ضبط قيمة قائمة اختيار من خلال اختيار قيم متعددة من قائمة منسدلة

تمثيل JSON 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
الحقول
values[]

object (SelectionValue)

activities.list of selections.

UserValue

ضبط قيمة مستخدم من خلال اختيار مستخدم واحد

تمثيل JSON 
{
  "email": string
}
الحقول
email

string

البريد الإلكتروني للمستخدم

UserListValue

ضبط قيمة قائمة مستخدمين من خلال اختيار عدة مستخدمين

تمثيل JSON 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
الحقول
values[]

object (UserValue)

activities.list of users.

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

أنواع ذات صلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

تمثّل هذه السمة سنة التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

الشهر من السنة يجب أن يكون رقمًا يتراوح بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وأن يكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.

السبب

سبب تطبيق التصنيف أو الحقل

تمثيل JSON 
{
  "reasonType": string
}
الحقول
reasonType

string

نوع السبب

OwnerDetails

تفاصيل مالك المرجع

تمثيل JSON 
{
  "ownerType": string,
  "ownerIdentity": [
    {
      object (OwnerIdentity)
    }
  ]
}
الحقول
ownerType

string

نوع مالك المرجع
ownerIdentity[]

object (OwnerIdentity)

تفاصيل هوية مالكي المرجع.

OwnerIdentity

تفاصيل هوية مالك المرجع

تمثيل JSON 
{

  "customerIdentity": {
    object (CustomerIdentity)
  },
  "userIdentity": {
    object (UserIdentity)
  },
  "groupIdentity": {
    object (GroupIdentity)
  },
  "sharedDriveIdentity": {
    object (SharedDriveIdentity)
  }
}
الحقول
حقل الربط identity هذا حقل oneof ولا يمكن ضبط سوى أحد الحقول التالية. يمكن أن يكون التعليق identity إحدى القيم التالية فقط:
customerIdentity

object (CustomerIdentity)

تُستخدَم لتحديد هوية عميل Google Workspace الذي يملك المورد.
userIdentity

object (UserIdentity)

تمثّل هذه السمة هوية المستخدم الذي يملك المورد.
groupIdentity

object (GroupIdentity)

تمثّل هذه السمة هوية المجموعة التي تملك المورد.
sharedDriveIdentity

object (SharedDriveIdentity)

معرّف مساحة التخزين السحابي المشتركة التي تملك المورد

CustomerIdentity

تُستخدَم لتحديد هوية عميل Google Workspace الذي يملك المورد.

تمثيل JSON 
{
  "id": string
}
الحقول
id

string

رقم تعريف العميل

UserIdentity

تمثّل هذه السمة هوية المستخدم الذي يملك المورد.

تمثيل JSON 
{
  "id": string,
  "userEmail": string
}
الحقول
id

string

معرّف gaia للمستخدم
userEmail

string

عنوان البريد الإلكتروني للمستخدِم.

GroupIdentity

تمثّل هذه السمة هوية المجموعة التي تملك المورد.

تمثيل JSON 
{
  "id": string,
  "groupEmail": string
}
الحقول
id

string

معرّف GAIA للمجموعة
groupEmail

string

بريد إلكتروني للمجموعة

SharedDriveIdentity

معرّف مساحة التخزين السحابي المشتركة التي تملك المورد

تمثيل JSON 
{
  "id": string,
  "sharedDriveName": string
}
الحقول
id

string

معرّف Gaia لمساحة التخزين السحابي المشتركة
sharedDriveName

string

اسم مساحة التخزين السحابي المشتركة

UserDeviceInfo

تفاصيل جهاز المستخدم الذي ينفّذ الإجراء

تمثيل JSON 
{
  "deviceId": string,
  "deviceType": string,
  "deviceOsVersion": string
}
الحقول
deviceId

string

النتائج فقط. تشير هذه السمة إلى رقم تعريف جهاز المستخدم.
deviceType

string

النتائج فقط. نوع جهاز المستخدم
deviceOsVersion

string

النتائج فقط. إصدار نظام التشغيل على جهاز المستخدم