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"

.

نص الطلب

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

نص الاستجابة

نموذج 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" معلومات حول أحداث نشاط التقويم المختلفة.
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.

النشاط

نموذج 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)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "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
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
الحقول
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[].resourceIds[]

string

معرّفات الموارد المرتبطة بالحدث.
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

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

object (NetworkInfo)

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

object (ResourceDetails)

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

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
}
الحقول
id

string

معرّف المرجع
title

string

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

string

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

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

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

AppliedLabel

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

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

string

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

string

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

object (FieldValue)

‫activities.list من الحقول التي تشكّل جزءًا من التصنيف والتي ضبطها المستخدِم. إذا كان التصنيف يتضمّن حقلًا لم يحدّده المستخدم، لن يكون هذا الحقل متوفّرًا في هذه القائمة.
reason

object (Reason)

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

FieldValue

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

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

  // Union field value can be only one of the following:
  "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)
  }
  // End of list of possible types for union field value.
}
الحقول
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

نوع السبب.