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