- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ApplicationName
- النشاط
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- التاريخ
- السبب
- جرِّبه الآن
يسترجع هذا الطلب قائمة الأنشطة لحساب عميل وتطبيق معيّنَين، مثل تطبيق "وحدة تحكّم المشرف" أو تطبيق 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 ، يعرض التقرير جميع الأنشطة من endTime حتى الوقت الحالي أو آخر 180 يومًا إذا كان endTime قبل أكثر من 180 يومًا.startTime startTime
|
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" معلومات عن أحداث نشاط "تقويم 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 ( |
الحقول | |
---|---|
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[] |
activities.list من |
events[].parameters[].multiMessageValue[].parameter[] |
قيم المَعلمات |
events[].resourceIds[] |
أرقام تعريف الموارد المرتبطة بالحدث |
id |
المعرّف الفريد لكل سجلّ نشاط |
id.time |
وقت حدوث النشاط يتم التعبير عن ذلك بالثواني حسب توقيت حقبة يونكس. |
id.uniqueQualifier |
مؤهّل فريد إذا كانت عدّة أحداث لها الوقت نفسه |
id.applicationName |
اسم التطبيق الذي ينتمي إليه الحدث. للاطّلاع على القيم المحتملة، اطّلِع على قائمة التطبيقات أعلاه في |
id.customerId |
المعرّف الفريد لحساب Google Workspace |
actor |
المستخدم الذي يتّخذ الإجراء |
actor.profileId |
المعرّف الفريد لملف الأداء الشخصي على Google Workspace للممثّل قد لا تكون هذه القيمة متوفّرة إذا لم يكن الفاعل مستخدمًا في Google Workspace، أو قد يكون الرقم 105250506097979753968 الذي يعمل كمعرّف نائب. |
actor.email |
عنوان البريد الإلكتروني الأساسي للمُنفِّذ. قد لا يظهر هذا الحقل إذا لم يكن هناك عنوان بريد إلكتروني مرتبط بالمنفِّذ. |
actor.callerType |
نوع المُنفِّذ |
actor.key |
لا يظهر إلا عندما يكون |
actor.applicationInfo |
تفاصيل التطبيق الذي كان المُنفِّذ للنشاط |
actor.applicationInfo.oauthClientId |
معرّف عميل OAuth للتطبيق التابع لجهة خارجية المستخدَم لتنفيذ الإجراء |
actor.applicationInfo.applicationName |
اسم التطبيق المستخدَم لتنفيذ الإجراء |
actor.applicationInfo.impersonation |
ما إذا كان التطبيق ينتحل هوية مستخدم |
resourceDetails[] |
تفاصيل المورد الذي تم تنفيذ الإجراء عليه |
ResourceDetails
تفاصيل المورد الذي تم تنفيذ الإجراء عليه
تمثيل JSON |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
الحقول | |
---|---|
id |
معرّف المورد |
title |
عنوان المورد على سبيل المثال، في حال كان المستند على Drive، سيكون هذا هو عنوان المستند. في حال تلقّي رسالة إلكترونية، سيكون هذا هو الموضوع. |
type |
نوع المورد: مستند أو رسالة إلكترونية أو رسالة محادثة |
appliedLabels[] |
activities.list of labels applied on the resource |
relation |
تحدِّد هذه السمة علاقة المورد بالأحداث. |
AppliedLabel
تفاصيل التصنيف المطبّق على المورد
تمثيل JSON |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
الحقول | |
---|---|
id |
معرّف التصنيف: رقم تعريف التصنيف فقط، وليس اسم مورد OnePlatform الكامل. |
title |
عنوان التصنيف |
fieldValues[] |
activities.list من الحقول التي تشكّل جزءًا من التصنيف وقد ضبطها المستخدم إذا كان التصنيف يحتوي على حقل لم يضبطه المستخدم، لن يكون متوفرًا في هذه القائمة. |
reason |
سبب تطبيق التصنيف على المورد |
FieldValue
تفاصيل قيمة الحقل التي ضبطها المستخدم للتصنيف المحدّد
تمثيل JSON |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
الحقول | |
---|---|
id |
معرّف الحقل |
displayName |
الاسم المعروض للحقل |
type |
نوع الحقل |
reason |
سبب تطبيق الحقل على التصنيف |
حقل الربط value تخزين القيم المخزّنة في الحقل value يمكن أن تكون إحدى القيم التالية فقط: |
|
unsetValue |
إذا لم يتم ضبط الحقل، ستكون هذه القيمة صحيحة. |
longTextValue |
ضبط قيمة نص طويلة |
textValue |
ضبط قيمة نصية |
textListValue |
ضبط قيمة قائمة نص |
selectionValue |
ضبط قيمة اختيار من خلال اختيار قيمة واحدة من قائمة منسدلة |
selectionListValue |
ضبط قيمة قائمة اختيار من خلال اختيار قيم متعدّدة من قائمة منسدلة |
integerValue |
ضبط قيمة عدد صحيح |
userValue |
ضبط قيمة مستخدم من خلال اختيار مستخدم واحد |
userListValue |
ضبط قيمة قائمة مستخدمين من خلال اختيار مستخدمين متعدّدين |
dateValue |
ضبط قيمة تاريخ |
TextListValue
ضبط قيمة قائمة نص
تمثيل JSON |
---|
{ "values": [ string ] } |
الحقول | |
---|---|
values[] |
activities.list من القيم النصية |
SelectionValue
ضبط قيمة اختيار من خلال اختيار قيمة واحدة من قائمة منسدلة
تمثيل JSON |
---|
{ "id": string, "displayName": string, "badged": boolean } |
الحقول | |
---|---|
id |
معرّف الاختيار |
displayName |
الاسم المعروض للاختيار |
badged |
ما إذا كان الخيار يحمل شارة |
SelectionListValue
ضبط قيمة قائمة اختيار من خلال اختيار قيم متعدّدة من قائمة منسدلة
تمثيل JSON |
---|
{
"values": [
{
object ( |
الحقول | |
---|---|
values[] |
activities.list of selections. |
UserValue
ضبط قيمة مستخدم من خلال اختيار مستخدم واحد
تمثيل JSON |
---|
{ "email": string } |
الحقول | |
---|---|
email |
عنوان البريد الإلكتروني للمستخدم |
UserListValue
ضبط قيمة قائمة مستخدمين من خلال اختيار مستخدمين متعدّدين
تمثيل JSON |
---|
{
"values": [
{
object ( |
الحقول | |
---|---|
values[] |
activities.list of users. |
التاريخ
يمثّل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. تم تحديد وقت اليوم والمنطقة الزمنية في مكان آخر أو أنّهما غير مهمّين. التاريخ نسبي إلى التقويم الغريغوري. يمكن أن يشير ذلك إلى أحد الخيارات التالية:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم
- الشهر واليوم، مع سنة صفرية (مثلاً، ذكرى سنوية)
- سنة بمفردها، مع صفر شهر وصفر يوم
- سنة وشهر، مع يوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان)
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة التي حدث فيها التاريخ. يجب أن تكون من 1 إلى 9999، أو 0 لتحديد تاريخ بدون عام. |
month |
الشهر من السنة يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر يجب أن يكون من 1 إلى 31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يُحتسَب فيها اليوم. |
السبب
سبب تطبيق التصنيف أو الحقل
تمثيل JSON |
---|
{ "reasonType": string } |
الحقول | |
---|---|
reasonType |
نوع السبب |