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,

  "itemName": string,
  "ancestorName": string
}
الحقول
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 
{

  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
}
الحقول
حقل الدمج strategy كيفية دمج الأنشطة الفردية يمكن أن تكون strategy إحدى القيم التالية فقط:
none

object (NoConsolidation)

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

object (Legacy)

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

NoConsolidation

لا يتضمّن هذا النوع أي حقول.

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

قديمة

لا يتضمّن هذا النوع أي حقول.

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