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

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

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

  • 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. ويمكن تجميع الإجراءات المتشابهة التي تحدث خلال فترة زمنية على مستوى عدة أهداف (مثل نقل مجموعة من الملفات دفعة واحدة) أو عدة جهات (مثل تعديل عدة مستخدمين للعنصر نفسه). وتكون قواعد التجميع لهذه الاستراتيجية خاصة بكل نوع من أنواع الإجراءات.