Method: activity.query

الاستعلام عن النشاط السابق في Google Drive

طلب HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
الحقول
consolidationStrategy

object (ConsolidationStrategy)

تفاصيل عن كيفية دمج الإجراءات ذات الصلة التي تشكّل النشاط وفي حال عدم ضبط هذا الخيار، لن يتم تجميع الإجراءات ذات الصلة.
pageSize

integer

الحد الأدنى لعدد الأنشطة المطلوبة في الردّ، ويحاول الخادم عرض هذه الكمية على الأقل. قد يعرض الخادم أيضًا عددًا أقل من الأنشطة إذا كان لديه استجابة جزئية جاهزة قبل انتهاء مهلة الطلب. في حال عدم ضبط هذه السمة، يتم استخدام قيمة تلقائية.
pageToken

string

يحدد الرمز المميز صفحة النتائج التي سيتم عرضها. اضبط هذا المَعلمة على قيمة nextPageToken التي تم إرجاعها من طلب بحث سابق للحصول على الصفحة التالية من النتائج. وفي حال تم ترك هذه السياسة بدون ضبط، سيتم عرض الصفحة الأولى من النتائج.
filter

string

الفلترة للعناصر التي يتم عرضها من طلب الاستعلام هذا تنسيق سلسلة الفلتر هو تسلسل من التعبيرات، يتم ربطها بعبارة "و" اختيارية، حيث يكون كل تعبير على شكل "حقل عامل تشغيل قيمة".

الحقول المسموح بها:

  • time: يستخدم عوامل تشغيل رقمية في قيم التاريخ إما من حيث المللي ثانية منذ 1 كانون الثاني (يناير) 1970 أو بتنسيق RFC 3339. أمثلة:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: يستخدم "has" (:) وإما قيمة مفردة أو قائمة بأنواع الإجراءات المسموح بها والمحاطة بين قوسين ومفصولة بمسافة. لاستبعاد نتيجة من الردّ، أضِف واصلة (-) في بداية سلسلة الفلتر. أمثلة:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
حقل الربط key المعايير الأساسية في طلب البحث القيمة التلقائية هي ancestorName = items/root، إذا لم يتم تحديد مفتاح. يمكن أن يكون key واحدًا فقط مما يلي:
itemName

string

إرجاع الأنشطة لعنصر Drive هذا. التنسيق هو items/ITEM_ID.
ancestorName

string

عرض الأنشطة لمجلد Drive هذا، بالإضافة إلى جميع العناصر الفرعية والعناصر اللاحقة التنسيق هو items/ITEM_ID.

نص الاستجابة

رسالة ردّ لطلب البحث عن النشاط على Drive.

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

تمثيل JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
الحقول
activities[]

object (DriveActivity)

قائمة الأنشطة المطلوبة
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج، أو فارغ إذا لم تتوفّر نتائج أخرى في القائمة

نطاقات الأذونات

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

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

ConsolidationStrategy

كيفية توحيد الأنشطة الفردية إذا كانت مجموعة من الأنشطة مرتبطة، يمكن دمجها في نشاط واحد مجمع، مثل فاعل واحد ينفّذ الإجراء نفسه على أهداف متعدّدة، أو فاعلون متعدّدون ينفّذون الإجراء نفسه على هدف واحد. تحدِّد الاستراتيجية القواعد التي ترتبط بها الأنشطة.

تمثيل JSON 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
الحقول
حقل الربط strategy كيفية توحيد الأنشطة الفردية يمكن أن يكون strategy واحدًا فقط مما يلي:
none

object (NoConsolidation)

لا يتم تجميع الأنشطة الفردية.
legacy

object (Legacy)

ويتم دمج الأنشطة الفردية باستخدام الاستراتيجية القديمة.

NoConsolidation

لا يحتوي هذا النوع على أي حقول.

استراتيجية لا يتم فيها توحيد الأنشطة الفردية.

قديمة

لا يحتوي هذا النوع على أي حقول.

يشير ذلك المصطلح إلى استراتيجية توحِّد الأنشطة باستخدام قواعد التجميع من الإصدار القديم من V1 Activity API. ويمكن تجميع الإجراءات المتشابهة التي تحدث خلال فترة زمنية على مستوى عدة أهداف (مثل نقل مجموعة من الملفات دفعة واحدة) أو عدة جهات (مثل تعديل عدة مستخدمين للعنصر نفسه). وتكون قواعد التجميع لهذه الاستراتيجية خاصة بكل نوع من أنواع الإجراءات.